RibbonOptionsSearchMenu.SearchItemPosition Property
Gets or sets the position of the Search box.
Namespace: DevExpress.XtraBars.Ribbon
Assembly: DevExpress.XtraBars.v24.1.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
[DefaultValue(SearchItemPosition.Default)]
[DXCategory("Behavior")]
[XtraSerializableProperty]
public SearchItemPosition SearchItemPosition { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| DevExpress.XtraBars.Ribbon.SearchItemPosition | Default | The position of the Search box. |
Property Paths
You can access this nested property as listed below:
| Object Type | Path to SearchItemPosition |
|---|---|
| RibbonControl |
|
Remarks
A Ribbon Form with the RibbonStyle property set to RibbonControlStyle.Office365 displays the Search box at the top of the form (see the screenshot below). In other Ribbon styles, the Search box is displayed in a page header or is hidden.
Use the SearchItemPosition property to display the Search box at the top of the Ribbon form, or in a page header, or to hide it from the Ribbon UI.
Handle the CustomSearchItemPosition event to align the Search box within the caption of the Ribbon form.
Note
Skinnable forms (XtraForm) cannot display the Search box at the top of the form. Setting the RibbonControl.SearchItemPosition to SearchItemPosition.Caption hides the search box.