.. highlightlang:: us .. index:: DocGetDataFileList .. _docgetdatafilelist: DocGetDataFileList ================== .. us.tag DocGetDataFileList ENGLISH DocGet New5110 Changed5705 :ref:`DocGetDataFileList` returns the list of used data files in the document or page. .. function:: smMatrix = DocGetDataFileList(hDoc) smMatrix = DocGetDataFileList(hvPage) smMatrix = DocGetDataFileList(hDoc, bUpdate) .. us.return **Return Value** *smMatrix* is a matrix with 6 columns: .. list-table:: :header-rows: 1 * - Column - Alias - Description * - 1 - DS_FILE_ORIGIN - Original data file name. For Excel files the sheet name can be added to the file name in square brackets. * - 2 - DS_FILE_NCNAME - Name of the NC file * - 3 - DS_FILE_ACTION - Action string: One of the following values: ``UNCHANGED``, ``SETTOZERO``, ``SETSTYLEONLY`` or an empty string ``""`` for replace data. * - 4 - DS_FILE_STYLEPROPS2D - 2D style attributes, See :ref:`XYSetProps` * - 5 - DS_FILE_STYLEPROPS3D - 3D style attributes, See :ref:`XYZSetProps` * - 6 - DS_FILE_COMMENT - Comment string * - 7 - DS_FILE_RECORDFILTER - Record-Filter: See :ref:`auto_setfilter` If the list is empty, *smMatrix* contains an empty string. .. us.params **Parameters** .. uparam:: hDoc *hDoc* is a handle of a UniPlot document. .. uparam:: hvPage *hvPage* is a vector of page handles. The list contains only data files used in the specified pages. .. uparam:: bUpdate If *bUpdate* is TRUE (1), the list is updates with the data sources of all datasets. Default values is TRUE (1). .. us.history **History** .. list-table:: :header-rows: 1 * - Version - Description * - R2015.5 - New column added: DS_FILE_RECORDFILTER * - 5.11.0 - New. .. seealso:: :ref:`overview-documents`, :ref:`DocCreate`, :ref:`datadata-exchange-(page)`, :ref:`DocSetDataFileList`, :ref:`DocExchangeDataFiles` :sub:`id-360753`