RibbonOptionsSearchMenu.SearchItemPosition Property

Gets or sets the position of the Search box.

Namespace : DevExpress.XtraBars.Ribbon

Assembly : DevExpress.XtraBars.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

C#
VB.NET

csharp

[DefaultValue(SearchItemPosition.Default)]
[DXCategory("Behavior")]
[XtraSerializableProperty]
public SearchItemPosition SearchItemPosition { get; set; }

<DefaultValue(SearchItemPosition.Default)>
<DXCategory("Behavior")>
<XtraSerializableProperty>
Public Property SearchItemPosition As SearchItemPosition

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.

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.