Name=Open:

From BR Wiki
Jump to: navigation, search

When using Name=Open: BR will prompt the operator to select a file, and then open the file using the Windows API.

In the following example, an Open File Dialog Box will open, and will open to the "Last Selected Folder", Name Open: has memory, and will remember file history and default file location.

Please note the * (asterisk) wild card is supported but the ? (question mark) wild card is not.

00010 open #1: "name=OPEN:text documents (*.txt) |*.txt,recl=1,shr",external,input ioerr 100
00020 print File$(1)
00030 close #1: 
00100 if err=622 then print "Operation Canceled: Err=";Err
00200 XIT: !

In the example above:

  • "name=OPEN:"instructs BR to open a Open File Dialog Box.
  • "text documents (*.txt)" defines the label for the filter combo box (Lower Right Corner).
  • The Pipe (|) is a separator.
  • (*.txt) is the actual filter that will be used when displaying files.

When using file dialogs with client server, @: or @:: is needed. The file dialog runs on the client side and doesn't have access to server side files - except through windows networking.

See the following Client Server example:

00010 open #1: "name=OPEN:@:text documents (*.txt) |*.txt,recl=1,shr",external,input ioerr 100
00020 print File$(1)
00030 close #1: 
00100 if err=622 then print "Operation Canceled: Err=";Err
00200 XIT: !
  • "@:" instructs the program to use the "Client Default Folder" as the default folder.
  • "@::" instructs the program to use the "A Client Folder" as the default folder.

It is possible to specify a specific folder as well as specify multiple filters.

The following example will display all ".ini" files as well as ".txt" files in the C:\Windows folder.

Remember that @: & @:: are required for Client Server.

00010   OPEN #1: "name=OPEN:C:\Windows\ Text Files (*.ini;*.txt)|*.ini;*.txt,recl=1,shr",EXTERNAL,INPUT IOERR 100
00020   PRINT File$(1)
00030   CLOSE #1: 
00100   if err=622 then PRINT "Operation Canceled: Err=";Err
00200 XIT: !
  • "NAME=Open:" instructs BR to open a Open File Dialog Box.
  • "C:\Windows\" is the Windows Path, it is important to include the final "\" and not include any filters.
  • The space Between \ & the Filter Combo Box Description is not required, but may aid in understanding the syntax.
  • "Text Files (*.ini;*.txt)" is the Filter Combo Box Description and will be displayed in the Combo Box Filter. (It is optional).
  • The Pipe (|) is a separator.
  • "*.ini;*.txt" is a list of actual filters that will be used when displaying files. Delimit the list with a ";"


The following is a much less complicated example that simply allows the user to pick an "Ini" file from the C:\Windows Folder.

00010   OPEN #1: "name=OPEN:C:\Windows\*.ini,recl=1,shr",EXTERNAL,INPUT IOERR 100
00020   PRINT File$(1)
00030   CLOSE #1: 
00100   if err=622 then PRINT "Operation Canceled: Err=";Err
00200 XIT: !

See also: