DLLBrowseForFolder()

DLLBrowseForFolder()
  • SYNOPSIS:
    folder$ = DLLBrowseForFolder$([sTitle$],[iFlags],[iOutBufferSize])
  • DESCRIPTION:
    Opens a dialog box which allows the end user to select a folder on the system.
  • PARAMETERS:
    sTitle$ (optional) The title you want to appear above the folder list in the requester.. Defaults to "Choose a folder:"
    iFlags (optional)

    Possible flags are:

    BIF_BROWSEFORCOMPUTER - Only return computers. If the user selects anything other than a computer, the OK button is grayed.
    BIF_BROWSEFORPRINTER - Only return printers. If the user selects anything other than a printer, the OK button is grayed.
    BIF_BROWSEINCLUDEFILES - The browse dialog will display files as well as folders.
    BIF_DONTGOBELOWDOMAIN - Do not include network folders below the domain level in the tree view control.

    BIF_EDITBOX - Version 4.71. The browse dialog includes an edit control in which the user can type the name of an item.
    BIF_RETURNFSANCESTORS - Only return file system ancestors. If the user selects anything other than a file system ancestor, the OK button is grayed.
    BIF_RETURNONLYFSDIRS - Only return file system directories. If the user selects folders that are not part of the file system, the OK button is grayed.
    BIF_NEWDIALOGSTYLE - Uses the new style dialog box, this box is sizable and has a "Create Folder" button. It is generally much nicer and easier to use.
    BIF_USENEWUI - Uses the new user interface. Shortcut to BIF_NEWDIALOGSTYLE and BIF_EDITOBOX.

    iFlags defaults to BIF_NEWDIALOGSTYLE Or BIF_RETURNONLYFSDIRS.

    iOutBufferSize (optional) The size of the buffer to return the folder name in. You should never have to specify this. Defaults to 512 characters.
  • RETURNS:
    Nothing ("") if the user cancels the dialog box, or the folder the user selected if the user clicks "Ok".
  • EXAMPLE:
    See example023.bb.
  • BUGS:
    None Known.

Return To Index
Problems with this command or bugs? EMail me at: mailto:loki.sd@blueyonder.co.uk

Section Last Updated: Monday, February 4, 2002 1:03 PM GMT

All materials used in this help, related sources and binaries are (C)opyright Rob Hutchinson, Joseph Cox and Tarropithium Software 2002. All rights reserved. All software is provided without warranty unless otherwise stated.
Tarropithium Software or the authors will not be held liable for any damage or data loss that may occur during the application of this software. Use it at your own risk!