StdActns.TBrowseForFolderOption Enumeration

TBrowseForFolderOption contains the options for creating a dialog box used when browsing for folders.

Pascal

TBrowseForFolderOption = (
  bifBrowseForComputer,
  bifBrowseForPrinter,
  bifBrowseIncludeFiles,
  bifBrowseIncludeURLS,
  bifDontGoBelowDomain,
  bifEditBox,
  bifNewDialogStyle,
  bifNoNewFolderButton,
  bifNoTranslateTargets,
  bifReturnFSAncestors,
  bifReturnOnlyFSDirs,
  bifShareable,
  bifStatusText,
  bifUAHint,
  bifUseNewUI,
  bifValidate
);

C++

enum TBrowseForFolderOption {
  bifBrowseForComputer,
  bifBrowseForPrinter,
  bifBrowseIncludeFiles,
  bifBrowseIncludeURLS,
  bifDontGoBelowDomain,
  bifEditBox,
  bifNewDialogStyle,
  bifNoNewFolderButton,
  bifNoTranslateTargets,
  bifReturnFSAncestors,
  bifReturnOnlyFSDirs,
  bifShareable,
  bifStatusText,
  bifUAHint,
  bifUseNewUI,
  bifValidate
};

File

StdActns

Description

TBrowseForFolderOption is an enumeration type containing the options that specify the type of dialog box used when browsing for folders.

The meaning of these options is given in the following table.

Option	Meaning
bifBrowseForComputer	Only allow computers to be returned. If anything else is selected, the OK button is disabled.
bifBrowseForPrinter	Only allow printers to be selected. If anything else is selected, the OK button is disabled.
bifBrowseIncludeFiles	The browse dialog box also displays files.
bifBrowseIncludeURLS	The browse dialog box also displays URL adresses. This automatically enables the options bifBrowseIncludeFiles and bifUseNewUI.
bifDontGoBelowDomain	Do not display network folders below the current domain level in the current tree view.
bifEditBox	Display an edit box containing the currently selected folder/file. This also allows typing the name of the folder/file to select.
bifNewDialogStyle	Use the new type of dialog, that is sizeable and includes a Make a New Folder button. The dialog also allows dragging and dropping and using the context menu on either folders or files.
bifNoNewFolderButton	Hides the Make New Folder button, when using the bifNewDialogStyle option.
bifNoTranslateTargets	If the selected folder/file is a shortuct, return the PIDL of the shortcut instead of its target.
bifReturnFSAncestors	Only allow file system ancestors to be returned. Ancestors are subfolders that live beneath the root of the namespace hierarchy. If the selected ancestor is not part of the file system, the OK button is disabled.
bifReturnOnlyFSDirs	Only allow file system directories to be returned. If anything else is selected, the OK button is disabled.
bifShareable	Shareable resources on remote systems are also displayed inside the browse dialog box. This automatically enables the option bifNewDialogStyle.
bifStatusText	Display a status message in the browse dialog box. The message is returned by the callback function. This option only works if the bifNewDialogStyle is disabled.
bifUAHint	Displays an usage hint instead of the edit box, when using the bifNewDialogStyle option
bifUseNewUI	Use the new user interface. This displays an edit box at the bottom of the dialog window, containing the name of the currently selected folder/file. The name of the folder/file to select can also be typed into this edit box.
bifValidate	Validates the name of the folder/file inserted into the edit box, when using the bifEditBox option. The validation triggers an event of type TBrowseForFolderCallbackEvent.