[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Collapse]eXpressApp Framework
 [Expand]Fundamentals
 [Expand]Getting Started
 [Expand]Concepts
 [Expand]Design-Time Features
 [Expand]Deployment
 [Expand]Task-Based Help
  Frequently Asked Questions (FAQ)
 [Collapse]API Reference
  [Expand]DevExpress.EasyTest.Framework
  [Expand]DevExpress.ExpressApp
  [Collapse]DevExpress.ExpressApp.Actions
   [Collapse]ActionBase Class
     ActionBase Members
    [Collapse]ActionBase Properties
      ActionMeaning Property
      Active Property
      Application Property
      Caption Property
      Category Property
      ConfirmationMessage Property
      Controller Property
      Data Property
      DiagnosticInfo Property
      Enabled Property
      HasImage Property
      Id Property
      ImageName Property
      IsDisposed Property
      IsExecuting Property
      LockCount Property
      Model Property
      PaintStyle Property
      QuickAccess Property
      SelectionContext Property
      SelectionDependencyType Property
      Shortcut Property
      Tag Property
      TargetObjectsCriteria Property
      TargetObjectsCriteriaMode Property
      TargetObjectType Property
      TargetViewId Property
      TargetViewNesting Property
      TargetViewType Property
      TestName Property
      ToolTip Property
      TypeOfView Property
    [Expand]ActionBase Events
    [Expand]ActionBase Methods
   [Expand]ActionBaseEventArgs Class
   [Expand]ActionBaseExtensions Class
    ActionMeaning Enumeration
   [Expand]ActionUrl Class
    ActiveItemsBehavior Enumeration
   [Expand]ChoiceActionBase Class
   [Expand]ChoiceActionItem Class
   [Expand]ChoiceActionItemCollection Class
    ChoiceActionItemFindTarget Enumeration
    ChoiceActionItemFindType Enumeration
   [Expand]CustomGetTotalTooltipEventArgs Class
   [Expand]CustomizeControlEventArgs Class
   [Expand]CustomizePopupWindowParamsEventArgs Class
    CustomizePopupWindowParamsEventHandler Delegate
    DefaultItemMode Enumeration
    EmptyItemsBehavior Enumeration
   [Expand]HandleExceptionEventArgs Class
    ImageMode Enumeration
   [Expand]ParametrizedAction Class
   [Expand]ParametrizedActionExecuteEventArgs Class
    ParametrizedActionExecuteEventHandler Delegate
   [Expand]PopupWindowShowAction Class
   [Expand]PopupWindowShowActionExecuteEventArgs Class
    PopupWindowShowActionExecuteEventHandler Delegate
    SelectionDependencyType Enumeration
   [Expand]SimpleAction Class
   [Expand]SimpleActionExecuteEventArgs Class
    SimpleActionExecuteEventHandler Delegate
   [Expand]SingleChoiceAction Class
   [Expand]SingleChoiceActionExecuteEventArgs Class
    SingleChoiceActionExecuteEventHandler Delegate
    SingleChoiceActionItemType Enumeration
   [Expand]SupportClientScriptsExtensions Class
    TargetObjectsCriteriaMode Enumeration
  [Expand]DevExpress.ExpressApp.AuditTrail
  [Expand]DevExpress.ExpressApp.Chart
  [Expand]DevExpress.ExpressApp.Chart.Web
  [Expand]DevExpress.ExpressApp.Chart.Win
  [Expand]DevExpress.ExpressApp.CloneObject
  [Expand]DevExpress.ExpressApp.ConditionalAppearance
  [Expand]DevExpress.ExpressApp.Dashboards
  [Expand]DevExpress.ExpressApp.Dashboards.Web
  [Expand]DevExpress.ExpressApp.Dashboards.Win
  [Expand]DevExpress.ExpressApp.Data
  [Expand]DevExpress.ExpressApp.DC
  [Expand]DevExpress.ExpressApp.DC.ClassGeneration
  [Expand]DevExpress.ExpressApp.Editors
  [Expand]DevExpress.ExpressApp.EF
  [Expand]DevExpress.ExpressApp.EF.Utils
  [Expand]DevExpress.ExpressApp.FileAttachments.Web
  [Expand]DevExpress.ExpressApp.FileAttachments.Win
  [Expand]DevExpress.ExpressApp.Filtering
  [Expand]DevExpress.ExpressApp.HtmlPropertyEditor.Web
  [Expand]DevExpress.ExpressApp.HtmlPropertyEditor.Win
  [Expand]DevExpress.ExpressApp.Kpi
  [Expand]DevExpress.ExpressApp.Layout
  [Expand]DevExpress.ExpressApp.Maps.Mobile
  [Expand]DevExpress.ExpressApp.Maps.Mobile.Editors
  [Expand]DevExpress.ExpressApp.Maps.Web
  [Expand]DevExpress.ExpressApp.Maps.Web.Helpers
  [Expand]DevExpress.ExpressApp.MiddleTier
  [Expand]DevExpress.ExpressApp.Mobile
  [Expand]DevExpress.ExpressApp.Mobile.Editors
  [Expand]DevExpress.ExpressApp.Mobile.MobileModel
  [Expand]DevExpress.ExpressApp.Mobile.SystemModule
  [Expand]DevExpress.ExpressApp.Mobile.Templates
  [Expand]DevExpress.ExpressApp.Model
  [Expand]DevExpress.ExpressApp.Model.Core
  [Expand]DevExpress.ExpressApp.Model.NodeGenerators
  [Expand]DevExpress.ExpressApp.ModelEditor
  [Expand]DevExpress.ExpressApp.Notifications
  [Expand]DevExpress.ExpressApp.Notifications.Web
  [Expand]DevExpress.ExpressApp.Notifications.Win
  [Expand]DevExpress.ExpressApp.Office.Win
  [Expand]DevExpress.ExpressApp.PivotChart
  [Expand]DevExpress.ExpressApp.PivotChart.Web
  [Expand]DevExpress.ExpressApp.PivotChart.Win
  [Expand]DevExpress.ExpressApp.PivotGrid
  [Expand]DevExpress.ExpressApp.PivotGrid.Web
  [Expand]DevExpress.ExpressApp.PivotGrid.Win
  [Expand]DevExpress.ExpressApp.Reports
  [Expand]DevExpress.ExpressApp.Reports.Web
  [Expand]DevExpress.ExpressApp.Reports.Win
  [Expand]DevExpress.ExpressApp.ReportsV2
  [Expand]DevExpress.ExpressApp.ReportsV2.Mobile
  [Expand]DevExpress.ExpressApp.ReportsV2.Web
  [Expand]DevExpress.ExpressApp.ReportsV2.Win
  [Expand]DevExpress.ExpressApp.Scheduler
  [Expand]DevExpress.ExpressApp.Scheduler.Web
  [Expand]DevExpress.ExpressApp.Scheduler.Win
  [Expand]DevExpress.ExpressApp.ScriptRecorder
  [Expand]DevExpress.ExpressApp.ScriptRecorder.Web
  [Expand]DevExpress.ExpressApp.ScriptRecorder.Win
  [Expand]DevExpress.ExpressApp.Security
  [Expand]DevExpress.ExpressApp.Security.Adapters
  [Expand]DevExpress.ExpressApp.Security.ClientServer.Wcf
  [Expand]DevExpress.ExpressApp.Security.EF.Adapters
  [Expand]DevExpress.ExpressApp.Security.Strategy
  [Expand]DevExpress.ExpressApp.Security.Xpo.Adapters
  [Expand]DevExpress.ExpressApp.StateMachine
  [Expand]DevExpress.ExpressApp.SystemModule
  [Expand]DevExpress.ExpressApp.Templates
  [Expand]DevExpress.ExpressApp.Templates.ActionContainers
  [Expand]DevExpress.ExpressApp.TreeListEditors
  [Expand]DevExpress.ExpressApp.TreeListEditors.Web
  [Expand]DevExpress.ExpressApp.TreeListEditors.Win
  [Expand]DevExpress.ExpressApp.Updating
  [Expand]DevExpress.ExpressApp.Utils
  [Expand]DevExpress.ExpressApp.Validation
  [Expand]DevExpress.ExpressApp.Validation.Web
  [Expand]DevExpress.ExpressApp.Validation.Win
  [Expand]DevExpress.ExpressApp.ViewVariantsModule
  [Expand]DevExpress.ExpressApp.Web
  [Expand]DevExpress.ExpressApp.Web.Controls
  [Expand]DevExpress.ExpressApp.Web.Editors
  [Expand]DevExpress.ExpressApp.Web.Editors.ASPx
  [Expand]DevExpress.ExpressApp.Web.SystemModule
  [Expand]DevExpress.ExpressApp.Web.Templates
  [Expand]DevExpress.ExpressApp.Web.Utils
  [Expand]DevExpress.ExpressApp.Win
  [Expand]DevExpress.ExpressApp.Win.Core
  [Expand]DevExpress.ExpressApp.Win.Editors
  [Expand]DevExpress.ExpressApp.Win.Model
  [Expand]DevExpress.ExpressApp.Win.SystemModule
  [Expand]DevExpress.ExpressApp.Win.Templates
  [Expand]DevExpress.ExpressApp.Win.Templates.Navigation
  [Expand]DevExpress.ExpressApp.Workflow
  [Expand]DevExpress.ExpressApp.Workflow.Win
  [Expand]DevExpress.ExpressApp.Xpo
  [Expand]DevExpress.ExpressApp.Xpo.Utils
  [Expand]DevExpress.Persistent.Base
  [Expand]DevExpress.Persistent.Base.General
  [Expand]DevExpress.Persistent.Base.ReportsV2
  [Expand]DevExpress.Persistent.Base.Security
  [Expand]DevExpress.Persistent.BaseImpl
  [Expand]DevExpress.Persistent.BaseImpl.EF
  [Expand]DevExpress.Persistent.BaseImpl.EF.PermissionPolicy
  [Expand]DevExpress.Persistent.BaseImpl.PermissionPolicy
  [Expand]DevExpress.Persistent.Validation
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

ActionBase.Category Property

Specifies an Action's category.

Namespace:DevExpress.ExpressApp.Actions
Assembly:DevExpress.ExpressApp.v18.2.dll

Expanded Syntax

Property value

Type: String
A String value that represents a Category for the current Action.
The default is "Unspecified".

Expanded Remarks

To specify in which Action Container the current Action will be displayed, specify the Action's Category property. For this purpose, use one of predefined categories that correspond to Action Containers used by built-in Templates. Use the DevExpress.Persistent.Base.PredefinedCategory enumeration to get the required predefined category.

By default, this property is set to the DevExpress.Persistent.Base.PredefinedCategory.Unspecified value. 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 via the Model Editor (see Place an Action in a Different Location and How to: Reorder an Action Container's Actions Collection). In a UI, the value specified in the Application Model's .xafml file that was loaded last will be displayed. For information on the load order of Application Model differences, refer to the Application Model Basics topic.

If you leave this property set to Unspecified, the Action will be displayed by the Action Container that is set to the current Template's DefaultContainer property. Note that a Template may return null by this property. So, we recommend that you assign the required category to the Action's Category property. In this instance, the Action will be displayed by the corresponding Action Container, if this Container is contained in the current Template.

How to Add an Action to a Context Menu or Command Column

There are Action Containers that are displayed in the Context Menu, but are not displayed anywhere else. If you want to show an Action only in the Context Menu (in WinForms) or in a ListView column (in ASP.NET), specify the ID of one of these Action Containers in the Action's Category property. These are the "Menu" category in WinForms and "ListView" category in ASP.NET. To see where a certain Action Container is located, add a custom template to your application and open it in the designer

In any Template that contains a List View, a set of Action Containers are displayed in the context menu, which can be invoked for the List View. The Default Container is not added to this menu. So, Actions with the Unspecified category are not displayed in a List View's context menu.

To examine how Actions are mapped to Action Containers in your application, see the ActionDesign | ActionToContainerMapping node in the Model Editor.

Expanded See Also

Is this topic helpful?​​​​​​​