~~Title: Retrieving File and Folder Information ~~
<pageheader/>

The **[[.|DOpusRT]]** tool can be used from outside of Opus to retrieve information about the currently displayed folders and files.

This functionality is accessed using the **dopusrt.exe /info** command - following **/info** you must supply a filename for the output to be saved to, an //information command//, and the appropriate arguments for that information command. The basic template is:

\\
**dopusrt.exe /info** //<output file>//**,**//<command>//[**,**//<arguments>//]

The data returned by the command will be saved to the specified file in XML format. You can omit the output filename if you do not care about the results. See below for examples of various commands.


<commandtable columns="3" id="cmdtable_1">
$$ Command
$$ Arguments
$$ Description
$$ (#)**list**
$$ //[<tab>]//
$$ **Returns a list of items displayed in the specified tab.**\\
//<tab>// is the handle of the tab to retrieve the file list from - this can be obtained from the output of the **paths** command. Specify **0** (or omit this argument) to retrieve the file list from the currently active tab.

Example:\\
**dopusrt.exe /info %temp%\filelist.txt,list**\\
$$ (#)**listsel**
$$ //[<tab>]//
$$ Returns a list of selected items displayed in the specified tab.

//<tab>// is the handle of the tab to retrieve the file list from - this can be obtained from the output of the **paths** command. Specify **0** (or omit this argument) to retrieve the file list from the currently active tab.



Example:

dopusrt.exe /info %temp%\filelist.txt,listsel,0x1a508\\
$$ (#)**open**



$$ //<tab>,<id>[,<id>,...]//
$$ **Opens one or more items in the specified tab**.\\
<tab> is the handle of the tab to open items in - this can be obtained from the output of the **paths** command. Specify **0** to retrieve the file list from the currently active tab//.//\\
//<id>// is the ID of the item to open - this can be obtained from the output of the **list** command. You can specify multiple IDs by comma-separating them, you can also specify a range of IDs (e.g. **3-8**).

Example:\\
**dopusrt.exe /info ,open,0,15**\\
//(note that the output filename has been omitted since we do not care about the results, although the comma separating the filename from the command must still be included).//\\
$$ (#)**paths**
$$ //(no arguments)//
$$ **Return a list of paths currently displayed in all tabs in all Listers**.

Example:\\
**dopusrt.exe /info %temp%\pathlist.txt,paths**\\
$$ (#)**select**





$$ <tab>,<id>[,<id>,...]
$$ **Selects one or more items in the specified tab**.\\
<tab> is the handle of the tab to select files in - this can be obtained from the output of the **paths** command. Specify **0** to retrieve the file list from the currently active tab//.//\\
//<id>// is the ID of the item to select - this can be obtained from the output of the **list** command. You can specify multiple IDs by comma-separating them, you can also specify a range of IDs (e.g. **3-8**).

Example:\\
**dopusrt.exe /info ,select,0x1a508,5,8-10**\\
//(note that the output filename has been omitted since we do not care about the results, although the comma separating the filename from the command must still be included).//

</commandtable>