BarSplitButtonItem.ActAsDropDown Property

Gets or sets whether the Down Arrow button is visually merged with the main button and the associated dropdown BarSplitButtonItem.PopupControl is invoked on clicking this merged button. This is a dependency property.

Namespace: DevExpress.Xpf.Bars

Assembly: DevExpress.Xpf.Core.v24.1.dll

NuGet Package: DevExpress.Wpf.Core

Declaration

C#

public bool ActAsDropDown { get; set; }

VB.NET

Public Property ActAsDropDown As Boolean

Property Value

Type	Description
Boolean	true, if the Down Arrow button is visually merged with the main button and the associated dropdown BarSplitButtonItem.PopupControl is invoked on clicking this merged button; otherwise, false. The default is false.

Remarks

If the ActAsDropDown option is set to false, the Down Arrow button is visually separated from the main button. The dropdown control (BarSplitButtonItem.PopupControl) is opened on clicking this Down Arrow button. A click on the main button fires the ItemClick event (BarItem.ItemClick and BarManager.ItemClick) and raises the BarItem.Command.

If the ActAsDropDown option is set to true, the Down Arrow button is visually merged with the main button and they act as one. A click on the merged button opens the associated dropdown control, fires the ItemClick events and raises the associated command.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ActAsDropDown 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

wpf-spreadsheet-bind-spreadsheet-to-ms-sql-server-database/CS/WpfSpreadsheet_BindToDataSource/MainWindow.xaml#L519

<dxb:BarButtonItem x:Name="biInsertPicture" Command="{Binding InsertPicture, Mode=OneTime, Source={StaticResource commands}}" />
<dxb:BarSplitButtonItem x:Name="biInsertChartColumnCommandGroup" ActAsDropDown="True" Command="{Binding InsertChartColumnCommandGroup, Mode=OneTime, Source={StaticResource commands}}">
    <dxr:GalleryDropDownPopupMenu>

wpf-spreadsheet-assign-custom-in-place-editors/CS/WpfSpreadsheet_CustomCellEditors/MainWindow.xaml#L517

<dxb:BarButtonItem x:Name="biInsertPicture" Command="{Binding InsertPicture, Mode=OneTime, Source={StaticResource commands}}" />
<dxb:BarSplitButtonItem x:Name="biInsertChartColumnCommandGroup" ActAsDropDown="True" Command="{Binding InsertChartColumnCommandGroup, Mode=OneTime, Source={StaticResource commands}}">
    <dxr:GalleryDropDownPopupMenu>

wpf-create-a-fluent-design-using-appearance-options/CS/FluentDesignTemplate/MainWindow.xaml#L58

</dx:WpfSvgPalette.Palette>
<dxb:BarSplitButtonItem Content="Alex" ActAsDropDown="True" BarItemDisplayMode="ContentAndGlyph" Glyph="{dx:DXImage SvgImages/Business Objects/BO_Customer.svg}">
    <dxb:PopupMenu>