TcxCustomShellComboBoxProperties Class

Stores shell combo box editor settings.

Declaration

TcxCustomShellComboBoxProperties = class(
    TcxCustomPopupEditProperties
)

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

In this topic…

Main API Members
Direct TcxCustomShellComboBoxProperties Class References
Terminal TcxCustomShellComboBoxProperties Class Descendant

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.

Drop-Down Window Settings

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 TcxCustomShellComboBoxProperties Class References

The following properties reference a TcxCustomShellComboBoxProperties object:

TcxCustomShellComboBox.ActiveProperties: Provides access to active shell combo box settings.
TcxCustomShellComboBox.Properties: Provides access to the Shell Combo Box editor’s settings.