.NET Standard 2.0+
.NET Framework 4.5.2+
.NET Standard 2.0+
.NET 5.0+

ActionBase.SelectionDependencyType Property

Specifies a context for enabling an Action.

Namespace: DevExpress.ExpressApp.Actions

Assembly: DevExpress.ExpressApp.v21.2.dll

Declaration

[DefaultValue(SelectionDependencyType.Independent)]
public SelectionDependencyType SelectionDependencyType { get; set; }

Property Value

Type Default Description
SelectionDependencyType

Independent

A SelectionDependencyType enumeration value identifying a context type.

Remarks

Use this property to make the current Action dependent on whether a single object or multiple objects are selected in the current View. The following values are available:

  • Independent

    WinForms and ASP.NET Web Forms: the Action availability does not depend on the current selection. ASP.NET Core Blazor: the Action is visible only when a List View has no selected objects.

  • RequireSingleObject

    WinForms and ASP.NET Web Forms: the Action is enabled when a single object is selected. ASP.NET Core Blazor: the Action is visible when a single object is selected.

    Set the ActionBase.Category property to “RecordEdit”, to display the Action in an additional cell for each object in the ASP.NET Web application’s List Views.

    Note

    The Action is hidden if the selection context is not available (e.g., when the Controller is not derived from ViewController).

  • RequireMultipleObjects

    WinForms and ASP.NET Web Forms: the Action is enabled when one or more objects are selected. ASP.NET Core Blazor: the Action is visible when one or more objects are selected.

By default, this property is set to Independent. Set another value if your Action is targeted for the currently selected object(s). This is definitely required if your Action takes part in an ASP.NET WebForms UI, because it will be disabled until an object is selected.

You can set another value in the Controller’s constructor or Designer. This value will be saved to the Application Model‘s ActionDesign | Actions | <Action> node. You can change this value in the Model Editor. In a UI, the value which is specified in the Application Model’s .xafml file that was loaded last, will be displayed. For information on the order of Application Model differences loading, refer to the Application Model Basics topic.

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

See Also