Skip to main content
All docs
V24.1

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
.OptionsSearchMenu .SearchItemPosition

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.

Ribbon Style - Office 365

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.

See Also