ToolBarControl.UseWholeRow Property

Gets or sets whether the ToolBarControl is stretched to match the container’s width.

Namespace: DevExpress.Xpf.Bars

Assembly: DevExpress.Xpf.Core.v20.2.dll

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Core, DevExpress.Wpf.Core

Declaration

C#

public bool UseWholeRow { get; set; }

VB.NET

Public Property UseWholeRow As Boolean

Property Value

Type	Description
Boolean	true, if the ToolBarControl is stretched to match the container’s width; otherwise, false.

Remarks

By default, when the UseWholeRow property equals false, an end-user can freely move the ToolBarControl along the bar row using the drag widget (see ToolBarControl.ShowDragWidget) and dock other ToolBarControls next to the current ToolBarControl. If the UseWholeRow property is set to true, the ToolBarControl occupies the entire container’s width so that no other ToolBarControls can be docked to the same bar row.

Note

If the ToolBarControl occupies the entire bar row, it cannot be collapsed (see ToolBarControl.AllowCollapse).

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the UseWholeRow property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

how-to-create-a-barsplitbuttonitem-e1567/CS/BarSplitButtonItem/Window1.xaml#L9

<dxb:BarContainerControl>
    <dxb:ToolBarControl UseWholeRow="True">
        <dxb:BarSplitButtonItem Name="btnFontColor" Content="FontColor" Glyph="{dx:DXImage Image=ChangeFontStyle_16x16.png}" ArrowAlignment="Bottom" ItemClick="btnFontColor_ItemClick">