ShellComboBox Class

The ShellComboBox is a configurable combobox containing drives and folders. The contents of the drop down list of the ShellComboBox can be influenced using the ShowOptions property. You can also supply an own custom ItemsSource. In order for predefined templates to work this should be a ObservableCollectionT of IJamItemIdList.

Inheritance Hierarchy

SystemObject
  System.Windows.ThreadingDispatcherObject
    System.WindowsDependencyObject
      System.Windows.MediaVisual
        System.WindowsUIElement
          System.WindowsFrameworkElement
            System.Windows.ControlsControl
              System.Windows.ControlsItemsControl
                System.Windows.Controls.PrimitivesSelector
                  System.Windows.ControlsComboBox
                    Jam.Shell.WPF.ControlsShellComboBox

Namespace: Jam.Shell.WPF.Controls
Assembly: ShellBrowserWPF (in ShellBrowserWPF.dll) Version: 1.3.1

Syntax

C++

Copy

public sealed class ShellComboBox : ComboBox, 
	IShellControlConnectorTarget, IDisposable

Public NotInheritable Class ShellComboBox
	Inherits ComboBox
	Implements IShellControlConnectorTarget, IDisposable

public ref class ShellComboBox sealed : public ComboBox, 
	IShellControlConnectorTarget, IDisposable

[<SealedAttribute>]
type ShellComboBox =  
    class
        inherit ComboBox
        interface IShellControlConnectorTarget
        interface IDisposable
    end

The ShellComboBox type exposes the following members.

Constructors

	Name	Description
	ShellComboBox	Default constructor.

Top

Properties

	Name	Description
	AdditionalValues	Access to a dictionary of additional values.
	AutomaticRefresh	Receives notifications about changes in the shell and performs refreshes automatically.
	HighlightColor	Gets or sets the highlight color in the drop down part. This is a dependency property.
	Location	The location of the folder to be displayed.
	Path	Gets or sets the full pathname of the file/shell item to be displayed.
	ShellControlConnector	Gets or sets a ShellControlConnector.
	ShowOptions	Items to include in the drop down list unless an own ItemsSource is specified.
	SpecialFolder	Gets or sets the special folder to be displayed.
	Version	The current version of ShellBrowser Components WPF.

Top

Methods

	Name	Description
	Dispose	Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
	FolderChanged	For compatibility with Winforms' ShellControlConnector: Selects the ItemIdList that is passed.
	FullRefresh	Completely reloads the list.
	OnApplyTemplate	Attaches some eventhandlers on sub-controls used in the control template. (Overrides ComboBoxOnApplyTemplate.)
	SelectedFileChange	For compatibility with Winforms' ShellControlConnector. File selection is not supported by this control.

Top

Events

	Name	Description
	BeforePathChange	Event is triggered before a new path is set. The new path can be rejected using the PathChangeCancelEventArgs.

Top

Fields

	Name	Description
	AutomaticRefreshProperty	Identifies the AutomaticRefresh dependency property.
	HighlightColorProperty	Identifies the HighlightColor dependency property.
	LocationProperty	The DependencyProperty for Location.

Top

Examples

The following example creates a custom item source for a ShellComboBox

Copy

//all subdirectories of "c:\windows".
m_ItemsSource = new ObservableCollection<IJamItemIdList>(new JamItemIdListCollection(new ItemIdList(@"c:\windows"), null, false, (sb) => { return sb.IsFolder; }));

Examples

If no custom item source is used, the items in the dropdown can be configured using the ShowOptions property:

Copy

//removes "Recycle Bin" from the dropdown elements.
ShellCombo.ShowOptions ^= ShellComboBox.ShowOption.RecycleBin;
//includes all drives and the special folder "Documents" in the dropdown list.
ShellCombo.ShowOptions = ShellComboBox.ShowOption.Drives | ShellComboBox.ShowOption.Documents;

Reference

Jam.Shell.WPF.Controls Namespace