BFF$ function

Purpose: BFF$ opens a dialog box and returns the chosen file or folder name.


 Syntax: 

 RetStr$ = BFF$(Instructions$ [, BIF_Flags%] [, StartFolder$])

 Parameters:

  • Instructions$ String literal or variable that is displayed above the tree view control in the dialog box. This string can be used to specify instructions to the user.
  • BIF_Flags% [OPTIONAL] BROWSEINFO structure flags specifying the options for the dialog box. This member can include zero or a combination of the following values. See your Win32 SDK or PSDK Reference help for more information about the BROWSEINFO structure flags which, with some restrictions based on the operating system, can be any combination of
    • BIF_RETURNONLYFSDIRS
    • BIF_DONTGOBELOWDOMAIN
    • BIF_STATUSTEXT
    • BIF_RETURNFSANCESTORS
    • BIF_EDITBOX
    • BIF_VALIDATE
    • BIF_NEWDIALOGSTYLE
    • BIF_USENEWUI
    • BIF_BROWSEINCLUDEURLS
    • BIF_UAHINT
    • BIF_NONEWFOLDERBUTTON
    • BIF_NOTRANSLATETARGETS
    • BIF_BROWSEFORCOMPUTER
    • BIF_BROWSEFORPRINTER
    • BIF_BROWSEINCLUDEFILES
    • BIF_SHAREABLE
  • StartFolder$ [OPTIONAL] string literal or variable containing the name of a folder in which the dialog box will open.

 Return Value:

  • RetStr$ , the return value, is a string containing the full path and file name or folder name specified by the user.

Example: 


 DIM RetStr$
 DIM Caption$

 Caption$ = "Pick a file or folder"
 RetStr$ = BFF$(Caption$)
 PRINT RetStr$