ActionBase.PaintStyle Property

Specifies the Action‘s paint style.

Namespace: DevExpress.ExpressApp.Actions

Assembly: DevExpress.ExpressApp.v25.2.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

[DefaultValue(ActionItemPaintStyle.Default)]
public ActionItemPaintStyle PaintStyle { get; set; }

VB.NET

<DefaultValue(ActionItemPaintStyle.Default)>
Public Property PaintStyle As ActionItemPaintStyle

Property Value

Type	Default	Description
ActionItemPaintStyle	Default	An ActionItemPaintStyle enumeration value that specifies the Action’s paint style.

Available values:

Name	Description	Image
Default	The default value is Image for WinForms applications and CaptionAndImage for ASP.NET Core Blazor applications.
Caption	An Action is displayed in the UI as a caption.
CaptionAndImage	An Action is displayed in the UI as an image and a caption.
Image	An Action is displayed in the UI as an image.

Remarks

Use one of the following approaches to specify this property:

• In code

  C#

  using DevExpress.ExpressApp;
  using DevExpress.ExpressApp.Actions;
  using DevExpress.ExpressApp.Templates;
  using DevExpress.Persistent.Base;
  // ...
  public class MyController : ObjectViewController<ListView, Contact> {
      public MyController() {
          SimpleAction customAction = new SimpleAction(this, "CustomAction", PredefinedCategory.View) {
              Caption = "Custom Action",
              ImageName = "ModelEditor_Application"
          };
          customAction.SelectionDependencyType = SelectionDependencyType.RequireSingleObject;
          customAction.PaintStyle = ActionItemPaintStyle.Caption;
      }
  }
  

  VB.NET

  Imports DevExpress.ExpressApp
  Imports DevExpress.ExpressApp.Actions
  Imports DevExpress.ExpressApp.Templates
  Imports DevExpress.Persistent.Base
  ' ...
  Public Class MyController
      Inherits ObjectViewController(Of ListView, Contact)
      Public Sub New()
          Dim customAction As New SimpleAction(Me, "CustomAction", PredefinedCategory.View) With {
              .Caption = "Custom Action",
              .ImageName = "ModelEditor_Application"
          }
          customAction.SelectionDependencyType = SelectionDependencyType.RequireSingleObject
          customAction.PaintStyle = ActionItemPaintStyle.Caption
      End Sub
  End Class
  

• In the Model Editor
  Navigate to an ActionDesign | Actions | <Action> node and specify the IModelAction.PaintStyle property.

  

Note that the value specified in the Model Editor has a higher priority than the value specified in code. For more information, refer to the following topic: Application Model Basics.

Related GitHub Examples

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

C#

xaf-save-and-share-custom-view-settings/CS/EFCore/ViewSettingsEF/ViewSettingsEF.Module/Controllers/ViewVariantsController.cs#L165

this.SelectViewVariantAction = new SingleChoiceAction(this, "SelectViewVariant", "Edit");
this.SelectViewVariantAction.PaintStyle = ActionItemPaintStyle.Caption;
this.SelectViewVariantAction.Execute += new SingleChoiceActionExecuteEventHandler(this.SelectViewVariantAction_Execute);

XAF_logon-form-manage-users-register-a-new-user-restore-a-password/CS/EFCore/Security.Extensions/ManageUsersOnLogonController.cs#L55

action.ImageName = imageName;
action.PaintStyle = ActionItemPaintStyle.Image;
action.ToolTip = toolTip;

xaf-how-to-import-data-in-xaf/CS/WinWebSolution.Module/ImportDataListViewController.cs#L37

importDataAction.Items.Add(item2);
importDataAction.PaintStyle = ActionItemPaintStyle.CaptionAndImage;
importDataAction.ItemType = SingleChoiceActionItemType.ItemIsOperation;

VB.NET

xaf-how-to-import-data-in-xaf/VB/WinWebSolution.Module/ImportDataListViewController.vb#L40

importDataAction_Renamed.Items.Add(item2)
importDataAction_Renamed.PaintStyle = ActionItemPaintStyle.CaptionAndImage
importDataAction_Renamed.ItemType = SingleChoiceActionItemType.ItemIsOperation