# Search

## Content

[C1HamburgerMenuSearchPanel](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.C1HamburgerMenuSearchPanel.html) provides search functionality for `C1HamburgerMenu`.
The search panel is a separate control and can be placed anywhere in the application layout. Assign the target menu through the `HamburgerMenu` property. The panel does not need to be hosted inside the menu control.
![C1WinForms Hamburger Menu - Search panel menu](https://cdn.mescius.io/document-site-files/images/cba1bceb-04d5-4184-987c-6bf624f0bae2/HamburgerMenuSearch-20261016.102dc1.gif?width=200&verticalAlign=middle)
The following example docks the search panel at the top of a container and fills the rest of the container with the menu:

```csharp
var searchPanel = new C1HamburgerMenuSearchPanel
{
    HamburgerMenu = c1HamburgerMenu1,
    Dock = DockStyle.Top,
    Size = new Size(210, 40)
};

leftPanel.Controls.Add(searchPanel);      // Dock = Top
leftPanel.Controls.Add(c1HamburgerMenu1); // Dock = Fill
leftPanel.Dock = DockStyle.Left;
```

>type=note
> **<span data-loadable-vc-wrapper="true" data-ssr-placeholder-replace="Hm6N8:EfLS5:z8NN7:qz-Pe:OP-5u-0">Note</span>**<span data-loadable-vc-wrapper="true" data-ssr-placeholder-replace="Hm6N8:EfLS5:z8NN7:qz-Pe:OP-5u-0">: </span>**<span data-loadable-vc-wrapper="true" data-ssr-placeholder-replace="Hm6N8:EfLS5:z8NN7:qz-Pe:OP-5u-0">C1HamburgerMenuSearchPanel</span>**<span data-loadable-vc-wrapper="true" data-ssr-placeholder-replace="Hm6N8:EfLS5:z8NN7:qz-Pe:OP-5u-0"> can be used with any </span>**<span data-loadable-vc-wrapper="true" data-ssr-placeholder-replace="Hm6N8:EfLS5:z8NN7:qz-Pe:OP-5u-0">ExpandedMode</span>**<span data-loadable-vc-wrapper="true" data-ssr-placeholder-replace="Hm6N8:EfLS5:z8NN7:qz-Pe:OP-5u-0"> value. The menu does not need to remain expanded while searching.</span>
> <span data-loadable-vc-wrapper="true" data-ssr-placeholder-replace="Hm6N8:EfLS5:z8NN7:qz-Pe:OP-5u-0">Use </span>**<span data-loadable-vc-wrapper="true" data-ssr-placeholder-replace="Hm6N8:EfLS5:z8NN7:qz-Pe:OP-5u-0">ExpandedMode.Always</span>**<span data-loadable-vc-wrapper="true" data-ssr-placeholder-replace="Hm6N8:EfLS5:z8NN7:qz-Pe:OP-5u-0"> when the application requires the menu to remain visible during search operations.</span>

***

## Search Properties

| Property | @cols=2:Description |
| -------- | ----------- | ----------- |
| [SearchMode](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.SearchMode.html) | Specifies whether search is applied automatically or when the user initiates a search action. |
| [SearchDelay](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.C1HamburgerMenuSearchPanel.SearchDelay.html) | Specifies the delay before an automatic search is applied. |
| [HighlightSearchResultsMode](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.C1HamburgerMenuSearchPanel.HighlightSearchResultsMode.html) | Specifies how matching text is highlighted using `SearchHighlightMode`. |
| [FilterSearchResults](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.C1HamburgerMenuSearchPanel.FilterSearchResults.html) | Specifies whether nonmatching items are hidden. |
| [SearchThroughVisibleItems](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.C1HamburgerMenuSearchPanel.SearchThroughVisibleItems.html) | Specifies whether the search is limited to currently visible items. |
| [ShowSearchButton](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.C1HamburgerMenuSearchPanel.ShowSearchButton.html), [ShowClearButton](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.C1HamburgerMenuSearchPanel.ShowClearButton.html) | Specify whether the search button and the clear button are displayed. |
| [ShowClearButton](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.C1HamburgerMenuSearchPanel.ShowClearButton.html) | Gets or sets the current search text. |
| [Text](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.C1HamburgerMenuItem.Text.html) | Gets or sets the current search text. |
| [Watermark](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.C1HamburgerMenuSearchPanel.Watermark.html) | Gets or sets the placeholder text. |

***

## Search from Code

To apply a search without using `C1HamburgerMenuSearchPanel`, call `ApplySearch` on the menu.
`ApplySearch` overloads support add optional highlighting, filtering, visible-items, and delay settings:

* `ApplySearch(string, SearchHighlightMode)`
* `ApplySearch(string, SearchHighlightMode, bool)`
* `ApplySearch(string, SearchHighlightMode, bool, bool)`
* `ApplySearch(string, SearchHighlightMode, bool, bool, int)`
* `ApplySearch(string, SearchHighlightMode, bool, bool, bool, int)`

Use programmatic search when the search text originates from another control, command, or application workflow.

***

## Search Events

[SearchApplying](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.C1HamburgerMenu.SearchApplying.html) occurs before a search is applied, and [SearchApplied](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.C1HamburgerMenu.SearchApplied.html) occurs after the operation completes.
Both events provide the following search information:

| Property | @cols=2:Description |
| -------- | ----------- | ----------- |
| [Text](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.C1HamburgerMenuItem.Text.html) | The search text. |
| [HighlightMode](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.SearchAppliedEventArgs.HighlightMode.html) | The `SearchHighlightMode` value used for the operation. |
| [Filter](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.SearchAppliedEventArgs.Filter.html) | Indicates whether nonmatching items are filtered. |
| [OnlyVisibleItems](/componentone/api/win/online-hamburger-menu/dotnet-api/C1.Win.Command.HamburgerMenu.10/C1.Win.Command.HamburgerMenu.SearchAppliedEventArgs.OnlyVisibleItems.html) | Indicates whether the search is limited to visible items. |

Applications can handle these events to log search activity or synchronize other UI elements with the current search state.