Vcl.StdActns.TBrowseForFolderOption
Delphi
TBrowseForFolderOption = (bifBrowseForComputer, bifBrowseForPrinter, bifBrowseIncludeFiles,
bifBrowseIncludeURLS, bifDontGoBelowDomain, bifEditBox, bifNewDialogStyle, bifNoNewFolderButton,
bifNoTranslateTargets, bifReturnFSAncestors, bifReturnOnlyFSDirs,
bifShareable, bifStatusText, bifUAHint, bifUseNewUI, bifValidate);
C++
enum DECLSPEC_DENUM TBrowseForFolderOption : unsigned char { bifBrowseForComputer, bifBrowseForPrinter, bifBrowseIncludeFiles, bifBrowseIncludeURLS, bifDontGoBelowDomain, bifEditBox, bifNewDialogStyle, bifNoNewFolderButton, bifNoTranslateTargets, bifReturnFSAncestors, bifReturnOnlyFSDirs, bifShareable, bifStatusText, bifUAHint, bifUseNewUI, bifValidate };
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| enum | public | Vcl.StdActns.pas Vcl.StdActns.hpp |
Vcl.StdActns | Vcl.StdActns |
Description
TBrowseForFolderOption contains the options for creating a dialog box used when browsing for folders.
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. |