CustomFolderComboBox Class |
The CustomFolderComboBox is a simple component that allows to display folders and drives
in a combo box with its associated icons. It is kept with basic functionality to allow for
further extension by the programmer.
See ShellComboBox for an advanced component which derives from the CustomFolderComboBox.
Inheritance HierarchySystemObject
SystemMarshalByRefObject
System.ComponentModelComponent
System.Windows.FormsControl
System.Windows.FormsListControl
System.Windows.FormsComboBox
Jam.ShellCustomEditComboBox
Jam.ShellCustomFolderComboBox
Jam.ShellShellComboBox
SystemMarshalByRefObject
System.ComponentModelComponent
System.Windows.FormsControl
System.Windows.FormsListControl
System.Windows.FormsComboBox
Jam.ShellCustomEditComboBox
Jam.ShellCustomFolderComboBox
Jam.ShellShellComboBox
Namespace: Jam.Shell
Assembly: ShellBrowser.Winforms (in ShellBrowser.Winforms.dll) Version: 6.3.1
SyntaxThe CustomFolderComboBox type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | CustomFolderComboBox |
Default constructor of the CustomFolderComboBox base-class
|
Properties| Name | Description | |
|---|---|---|
 | Font |
Gets or sets the font of the text displayed by the control and adapts UseSystemFont is set to false.
(Inherited from CustomEditComboBox.) |
| IsInitialized |
Gets a value indicating whether the component is initialized.
(Inherited from CustomEditComboBox.) |
 | OverlayTextBox |
Provides access to the TextBox field of the control.
(Inherited from CustomEditComboBox.) |
| ShellAutoCompletionMode |
This property controls the availability of the shells autocompletion mode,
if set to FileSystem, Url or both, the ComboBox provides a TextField the
user can type to. If disabled the default combobox behavior without editing
functionality is used. Both, FileSystem and Url can be specified at once and
are enabled by default.
ShellAutoComplete.Url needs to be used to also provide autocompletion for UNC-Paths.
(Inherited from CustomEditComboBox.) |
| ShowFullPath |
If set to true, the full path of the selected item is shown in the combobox
|
| UseSystemFont |
Set this property to true if you want the component to utilize the default system font.
It is also set to true if the UseSystemStyles property is set.
(Inherited from CustomEditComboBox.) |
| UseSystemStyles |
Use this property to turn on or off the usage of the system specific design, i.e. enable Vista visual styles of the explorer components.
(Inherited from CustomEditComboBox.) |
Methods| Name | Description | |
|---|---|---|
| AdjustTextBoxSize |
Adjusts the size of the edit field so that it is inside the combo box.
(Inherited from CustomEditComboBox.) |
 | BeginInit |
Signals the object that initialization is starting.
(Inherited from CustomEditComboBox.) |
| CustomFolderComboDrawItemHandler |
This is the event handler registered to DrawItem(Control, DrawItemEventArgs, Boolean) it displays the items
as files or folders
|
| EnableSystemStyles |
Sets system specific behaviour,
i.e. FullRowSelect in Vista and upwards.
(Inherited from CustomEditComboBox.) |
| EndInit |
Signals the object that initialization is complete.
(Inherited from CustomEditComboBox.) |
| OnCreateControl |
Recalculates the ItemHeight.
Raises the CreateControl method.
(Inherited from CustomEditComboBox.) |
| OnHandleCreated |
This event is triggered after the handle of the control was created.
(Inherited from CustomEditComboBox.) |
| OnOverlayResize | This method is called from the OverlayTextBox.Resize Event. It calls the
AdjusTextBoxSize method. (Inherited from CustomEditComboBox.) |
| OnShowOptionChanged |
This method needs to be called if a a ShowOption changed.
|
| OnSizeChanged |
This event is triggered after the size of the combobox changed. Fixes bug #4397.
(Inherited from CustomEditComboBox.) |
| SetFont |
Sets the font without adjusting other properties.
(Inherited from CustomEditComboBox.) |
| UpdateOverlayTextBox |
Updates the Text of the OverlayTextBox by either setting the items caption
or the items path depending on the ShowFullPath property
|
Events| Name | Description | |
|---|---|---|
 | Initialized |
Occurs when initialization of the component is completed.
(Inherited from CustomEditComboBox.) |
| ShowOptionChangedEvent |
Register to this event to get informed about an optionchange of the Show{...} properties.
|
Extension Methods| Name | Description | |
|---|---|---|
 | HandleNeeded | A Control extension method that ensures that the handle for a control is created. (Defined by ExtensionMethods.) |
| ScaledPixels | An extension method for controls: It scales the passed pixels according to the current dpi the control is displayed with. (Defined by ExtensionMethods.) |
| ScaleFont | A Control extension method that scales font according to the passed factor. (Defined by ExtensionMethods.) |
See Also