ActionBase.ImageName Property

Specifies a name of the image displayed for an Action.

Namespace: DevExpress.ExpressApp.Actions

Assembly: DevExpress.ExpressApp.v24.2.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

[DefaultValue(null)]
public string ImageName { get; set; }

VB.NET

<DefaultValue(Nothing)>
Public Property ImageName As String

Property Value

Type	Default	Description
String	null	A string value that represents the name of the current Action’s image.

Remarks

Use the ImageName property to specify the name of the image that will be displayed for the current Action. By default, this property is not set. You can set a value in the Controller’s constructor or Designer. This value will be saved to the Application Model‘s IModelAction 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 loaded last will be displayed. For information on the order of Application Model differences loading, refer to the Application Model Basics topic.

When setting a value to this property, the ActionBase.Changed event is raised.

To learn the concept by which XAF displays images for Actions and other UI elements, refer to the Add and Replace Icons topic.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ImageName 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-print-a-report-without-displaying-a-preview/CS/InstantPrintReportsV2Example.Module/Controllers/InstantPrintReportController.cs#L17

SimpleAction printAction = new SimpleAction(this, "PrintContacts", PredefinedCategory.Reports);
printAction.ImageName = "Action_Printing_Print";
printAction.Execute += delegate(object sender, SimpleActionExecuteEventArgs e) {

VB.NET

xaf-print-a-report-without-displaying-a-preview/VB/InstantPrintReportsV2Example.Module/Controllers/InstantPrintReportController.vb#L19

Dim printAction As New SimpleAction(Me, "PrintContacts", PredefinedCategory.Reports)
printAction.ImageName = "Action_Printing_Print"
AddHandler printAction.Execute, Sub(sender As Object, e As SimpleActionExecuteEventArgs)