EnumDescriptor.GetCaption(Object) Method

Returns the display caption associated with a specified value of the enumeration represented by the EnumDescriptor.

Namespace: DevExpress.ExpressApp.Utils

Assembly: DevExpress.ExpressApp.v26.1.dll

Declaration

C#

public string GetCaption(
    object value
)

VB.NET

Public Function GetCaption(
    value As Object
) As String

Parameters

Name	Type	Description
value	Object	An object representing the enumeration value whose corresponding display caption will be retrieved.

Returns

Type	Description
String	A string representing the display caption associated with the specified value of the enumeration represented by the EnumDescriptor.

Remarks

The following code snippet illustrates use of the GetCaption method. The code retrieves images and display captions associated with MyEnum enumeration values.

C#

//...
EnumDescriptor myDescriptor = new EnumDescriptor(typeof(MyEnum));
foreach(object enumValue in myDescriptor.Values) {
    string caption = myDescriptor.GetCaption(enumValue);
    var image = myDescriptor.GetImageInfo(enumValue).Image;
    //process caption and image
}

VB.NET

Dim myDescriptor As New EnumDescriptor(GetType(MyEnum))
For Each enumValue As Object In myDescriptor.Values
    Dim caption As String = myDescriptor.GetCaption(enumValue)
    Dim image As Drawing.Image = myDescriptor.GetImageInfo(enumValue).Image
    'process caption and image
Next enumValue

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the GetCaption(Object) method.

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-how-to-display-an-enumeration-property-as-a-drop-down-box-with-check-boxes/CS/EFCore/EnumCheckBoxEF/EnumCheckBoxEF.Win/Editors/EnumPropertyEditorEx.cs#L47

foreach (CheckedListBoxItem itm in checkedItem.Items) {
    itm.Description = EnumDescriptor.GetCaption(itm.Value);
}