BFF$ function

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


 Syntax:

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

 Parameters:

  • RetStr$ A string containing the full path and file or folder name specified by the user.
  • 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.

Example:


 DIM RetStr$
 DIM Caption$

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