Click or drag to resize

ShellSearchEdit Class

A SearchEdit is a search box similar to the Windows Search in the upper right corner of the Windows Explorer and provides a search for files and folders.
Inheritance Hierarchy
SystemObject
  SystemMarshalByRefObject
    System.ComponentModelComponent
      System.Windows.FormsControl
        System.Windows.FormsTextBoxBase
          System.Windows.FormsTextBox
            Jam.ShellShellSearchEdit

Namespace: Jam.Shell
Assembly: ShellBrowser (in ShellBrowser.dll) Version: 7.2
Syntax
public class ShellSearchEdit : TextBox, 
	IShellControl, IShellControlConnectorTarget, ISupportInitialize, ISupportInitializeNotification

The ShellSearchEdit type exposes the following members.

Constructors
 NameDescription
Public methodShellSearchEdit Default constructor of the SearchEdit class.
Top
Properties
 NameDescription
Public propertyContentSearch Specify if both contents and names are searched. If false, no content search is executed.
Public propertyCurrentFolder Gets the current folder where the search takes place.
Public propertyIsInitialized Gets a value indicating whether the component is initialized.
Public propertyQuickSearch Gets or sets the usage of the quick search mode.
Public propertyQuickSearchDelay Amount of time in milliseconds to delay the search in the quick search mode. After this delay has expired the search is started.
Public propertySearchFolder Gets the virtual "search folder" where the search results are displayed.
Public propertyShellControlConnector Connects this control to a ShellControlConnector component, which allows to synchronize several shell controls.
Public propertyVersion The current version of the ShellBrowser components.
Top
Methods
 NameDescription
Public methodBeginInit Signals the object that initialization is starting.
Public methodClear Clears the search query.
Public methodEndInit Signals the object that initialization is complete.
Public methodFolderChanged Changes the displayed folder in all connected controls.
Public methodFullRefresh Triggers a full refresh for all connected controls.
Protected methodGetMagnifyingGlassSymbol Gets the magnifier icon.
Protected methodGetRevealSymbol Gets the reveal icon.
Public methodGoUp Move in all connected controls from the current to the parent folder.
Protected methodOnFontChanged Raises the System.Windows.Forms.FontChanged event.
(Overrides TextBoxOnFontChanged(EventArgs))
Protected methodOnHandleCreated This event is triggered after the handle of the control was created.
(Overrides TextBoxOnHandleCreated(EventArgs))
Protected methodOnKeyUp Raises the System.Windows.Forms.KeyUp event.
(Overrides ControlOnKeyUp(KeyEventArgs))
Protected methodOnTextChanged Raises the System.Windows.Forms.TextChanged event.
(Overrides TextBoxBaseOnTextChanged(EventArgs))
Public methodRefresh(RefreshLevel) This method indicates that the control should perform a refresh of its contents.
Public methodRefresh(RefreshLevel, ItemIdList) This method indicates that the control should perform a refresh of its contents.
Public methodRefreshSearch Executes the search again.
Public methodSearch Starts the search in the current folder.
Public methodSelectedFileChange Changes the displayed file in all connected controls.
Public methodSmartRefresh Triggers a smart refresh for all connected controls.
Top
Events
 NameDescription
Public eventBeforeSearch Occurs before the search is started. It can be used to configure details concerning the upcoming search.
Public eventInitialized Occurs when initialization of the component is completed.
Public eventSearchFolderCreated Occurs when the search folder has been created.
Public eventSearchFolderDestroyed Occurs after the search folder has been destroyed.
Top
Extension Methods
 NameDescription
Public Extension MethodGetSelfAndDescendants Returns a flattened collection of a control and all of its descendant controls.
(Defined by ExtensionMethods)
Public Extension MethodHandleNeededA Control extension method that ensures that the handle for a control is created.
(Defined by ExtensionMethods)
Public Extension MethodScaledPixelsAn extension method for controls: It scales the passed pixels according to the current dpi the control is displayed with.
(Defined by ExtensionMethods)
Public Extension MethodScaleFontA Control extension method that scales font according to the passed factor.
(Defined by ExtensionMethods)
Top
Remarks
The search itself is done by Windows and supports the Advanced Query Syntax. The matching results are mapped to a virtual folder called "search folder". The property SearchFolder contains an ItemIdList to this folder when the search has finished. If the property ShellControlConnector is assigned this ShellControlConnector will be informed automatically when the search has finished. The QuickSearch mode is used per default to provide an automatically search start after the search expression has changed. Please note that a SearchEdit is only compatible with Windows 7 and later. The search indexing service must not be disabled.
See Also