PROPLIST.AddFile

Previous  Next

 

nFiles = PROPLIST.AddFile( [fid            AS HANDLE  = PL_Fid_Environment],

                           [selected       AS INTEGER = TRUE],

                           [defaultpoints  AS STRING  = ""],

                           [defaultanalogs AS STRING  = ""] ) AS INTEGER

 


 

Adds a file to the File Pane.  If fid = NULL, then list is updated and number of points and analogs are updated.  If fid = -1, then the file list is populated using environment variables.

 

The following environment variables are used:

 

MAXA$OPENED_FILES         INTEGER   Number of files opened

MAXA$OPEN_FILE_x.FID      HANDLE    The file handle, hFID, of each file opened

MAXA$OPEN_FILE_x.STATUS   INTEGER   Open status.  Bit Mask with 0x0001 = Selected, 0x0002 = Shared

 

The function returns number of files in list.

 

Example:

 

nFiles = PROPLIST.ADDFILE( -1 )

nFiles = PROPLIST.ADDFILE( fid, TRUE )

nFiles = PROPLIST.ADDFILE( fid, TRUE, "Point #1|Point #2|Point #3", "CH1|CH2" )