.NET Framework 4.5.2+
.NET Framework 4.5.2+
.NET Standard 2.0+
.NET Core 3.0+

ChoiceActionBase.ShowItemsOnClick Property

Specifies whether to show the drop-down with the current Action's items when the Action is clicked in WinForms or ASP.NET applications.

Namespace: DevExpress.ExpressApp.Actions

Assembly: DevExpress.ExpressApp.v19.2.dll

Declaration

[DefaultValue(false)]
public bool ShowItemsOnClick { get; set; }
<DefaultValue(False)>
Public Property ShowItemsOnClick As Boolean

Property Value

Type Default Description
Boolean

false

true, if the drop-down list of items is shown when clicking the Action; false - if the Action is executed.

Remarks

To specify the Choice Action Item executed by default when ShowItemsOnClick is false, use the ChoiceActionBase.DefaultItemMode property. You can set whether to always execute the first active item in the ChoiceActionBase.Items collection, or to execute the previously executed item.

The ShowItemsOnClick property's false value affects how ChoiceActionBase Actions' controls are rendered (for example, the NewObjectViewController.NewObjectAction's control):

  • As an Action's default button, if the SingleChoiceAction.Items collection (inherited from ChoiceActionBase.Items) contains one visible item.

    NewAction_NoGlyph

  • As a drop-down control with a triangle glyph, if the collection includes more than one item.

    NewAction_WithGlyph

If the ShowItemsOnClick property's value is true, ChoiceActionBase Actions always have drop-down controls and you can execute the required action only from the drop-down.

See Also