Skip to main content

TcxShellComboBoxProperties Class

Stores shell combo box editor settings.

Declaration

TcxShellComboBoxProperties = class(
    TcxCustomShellComboBoxProperties
)

Remarks

A Shell Combo Box editor combines the functionality of TcxComboBox and TdxShellTreeView components. The Shell Combo Box editor can display the Shell Tree View control in a drop-down window to allow users to browse Windows Shell. Alternatively, users can type the path to an item in the editor box. The Shell Combo Box editor can synchronize content with other DevExpress shell controls, allowing you to build fully-functional shell dialogs in your applications.

A Shell Combo Box

Main API Members

The list below outlines key members of the TcxCustomShellComboBoxProperties class.

Appearance Settings

ViewOptions
Specify display flags that correspond to different shell item types.

User Interaction Options

AllowDropDownWhenReadOnly
Specifies if the editor can display the drop-down window in read-only mode.
Automation

Provides access to UI Automation and accessibility-related settings.

Tip

Use Automation.Name, Automation.Description, and other API members to specify information visible to third-party assistive tools as UIA node properties.

DropDownListStyle
Allows you to switch between available user input modes.
IncrementalSearch
Specifies if incremental search is enabled.
ImmediateDropDownWhenKeyPressed
Specifies if the focused shell combo box automatically displays a drop-down window when a user presses a key.
ReadOnly
Specifies if the editor is in read-only mode.
Revertable
Specifies if users can double-click the editor to cycle through all values available for selection.
EditValue
Stores the path to the current shell item.
FastSearch
Specifies if Fast Search mode is enabled.
FileMask
Specifies a mask for file filtering.
OnAddFolder
Allows you to hide shell items that meet specific criteria.
Root
Specifies the initially displayed shell item (folder).
ShowFullPath
Specifies if the edit box displays a full path to the current shell item (file or folder).
StoreRelativePath
Specifies if the EditValue property stores a relative or full path.
DropDownAutoWidth
Specifies if drop-down window width is calculated automatically.
DropDownSizeable
Specifies if users can resize the drop-down window.
DropDownWidth
Allows you to specify drop-down window width explicitly.
TreeViewOptions
Provides access to the shell tree view component displayed in a drop-down window.

General-Purpose API Members

AssignedValues | RestoreDefaults
Allow you to track the state of individual editor-specific settings and reset them.
BeginUpdate | EndUpdate | LockUpdate | DoUpdate | Update | Changed | ChangedLocked | DataChanged
Allow you to manage editor updates and avoid excessive redraw operations during batch editor setting changes.

Direct TcxShellComboBoxProperties Class References

Unbound Shell Combo Box Editor

TcxShellComboBox.ActiveProperties
Provides access to active shell combo box settings.
TcxShellComboBox.Properties
Provides access to Shell Combo Box editor settings.

Data-Aware Shell Combo Box Editor

TcxDBShellComboBox.ActiveProperties
Provides access to active shell combo box settings.
TcxDBShellComboBox.Properties
Provides access to shell combo box settings.
See Also