Skip to main content
BuyLog In
XAF: Cross-Platform .NET App UI & Web API
Search in…
Docs > Getting Started > In-Depth XAF WinForms & ASP.NET Tutorial (Main Demo) > UI Customization > Assign a Standard Image
A newer version of this page is available. .
All docs
V20.2
.NET Framework 4.5.2+
eXpressApp Framework
Fundamentals
.NET Core 3.0+ Support in XAF WinForms Applications
.NET Standard 2.0 Support for Platform-Agnostic Modules
ASP.NET Core Blazor UI - Official Release
Getting Started
Basic WinForms & ASP.NET Tutorial (Simple Project Manager Demo)
In-Depth XAF WinForms & ASP.NET Tutorial (Main Demo)
Business Model Design
Extend Functionality
UI Customization
Place an Action in a Different Location
Specify Action Settings
Format a Business Object Caption
Assign a Standard Image
Assign a Custom Image
Make a Property Calculable
Filter Lookup Editor Data Source
Format a Property Value
Use a Multiline Editor for String Properties
Localize UI Elements
Add an Item to the New Action
Add an Item to the Navigation Control
Implement Property Value Validation in the Application Model
Customize the View Items Layout
Add an Editor to a Detail View
Change Field Layout and Visibility in a List View
Display a Detail View with a List View
Make a List View Editable
Add a Preview to a List View
Filter List Views
Apply Grouping to List View Data
Choose the WinForms UI Type
Toggle the WinForms Ribbon Interface
Change Style of Navigation Items
Extra Modules
Security System
Basic Blazor Tutorial (Simple Project Manager Demo)
In-Depth XAF Blazor UI Tutorial (Main Demo)
Concepts
Design-Time Features
Deployment
Task-Based Help
Frequently Asked Questions (FAQ)
API Reference
Download CHM

Assign a Standard Image

  • 2 minutes to read

eXpressApp Framework (XAF) includes standard images embedded into the DevExpress.Images assembly. In this lesson, you will learn how to associate a business class with a standard image. This image will represent the class in the navigation control, including detail and list form headers. For this purpose, the Department and Position classes will be used, since their ancestor (BaseObject class) is not associated with an image.

To see the available images, browse the following folder: %PROGRAMFILES(x86)%\DevExpress 20.2\Components\%PROGRAMFILES(x86)%\DevExpress 20.2\.NET Core Desktop Libraries\Sources\DevExpress.Images\Images.

Note

Before proceeding, take a moment to review the Place an Action in a Different Location lesson.

Follow the steps below to assign images to the Department and Position classes.

  • Invoke the Model Editor for your WinForms or ASP.NET application project.

  • Navigate to the NavigationItems node, and set ShowImages to true.

  • For WinForms applications, also set the ShowTabImage property to true in the Options node.

  • Images are now displayed for business classes. The “BO_Unknown” image is shown for classes that have no preassigned image.

    BO_Unknown

  • Invoke the Model Editor. Navigate to the BOModel | MySolution.Module.Business_Classes | Department node and change the ImageName property value to “BO_Department”. This is the name of the image in the %PROGRAMFILES(x86)%\DevExpress 20.2\Components\%PROGRAMFILES(x86)%\DevExpress 20.2\.NET Core Desktop Libraries\Sources\DevExpress.Images\Images folder. This folder represents a Standard Image Library.

    Tutorial_UIC_Lesson4_1

    Note

    • When the ImageName property is focused, the ellipsis button (EllipsisButton) is displayed to the right of the property value. You can click this button to invoke the Image Picker dialog and browse the available images.

  • Navigate to the BOModel | MySolution.Module.Business_Classes | Position node and change the ImageName property value to “BO_Position”.

    Tutorial_UIC_Lesson4_1_1

  • Run the application. You will see that Department and Position now have corresponding images displayed within the navigation bar and tab panel. If you run the ASP.NET application, you will see similar images within the page header when the Department (or Position) List View or Detail View is active.

    WinForms Application

    Tutorial_UIC_Lesson4_2

     

    ASP.NET Application

    Tutorial_UIC_Lesson4_3

You can see the results in the Main Demo | MainDemo.Module project’s Model Editor. The MainDemo application is installed in %PUBLIC%\Documents\DevExpress Demos 20.2\Components.NET Core Desktop Libraries\eXpressApp Framework\MainDemo by default. The ASP.NET Web Forms version is available online at https://demos.devexpress.com/XAF/MainDemo.

 

Next Lesson: Assign a Custom Image

See Also