RepositoryItem.Appearance Property

Gets the appearance settings used to paint the editor when it’s enabled.

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v19.2.dll

Declaration

C#

[DXCategory("Appearance")]
public virtual AppearanceObject Appearance { get; }

VB.NET

<DXCategory("Appearance")>
Public Overridable ReadOnly Property Appearance As AppearanceObject

Property Value

Type	Description
AppearanceObject	A AppearanceObject object which provides the appearance setting used to paint the editor when it’s enabled.

Remarks

Use the Appearance property to specify the editor’s background and foreground colors, font settings, etc.

To specify the appearance settings used to paint the disabled editor (see RepositoryItem.Enabled), use the RepositoryItem.AppearanceDisabled property. Additionally, it’s possible to specify the appearance of the currently focused editor. Use the RepositoryItem.AppearanceFocused property for this purpose.

Note

The AppearanceObject.BackColor2, AppearanceObject.Image, AppearanceObject.GradientMode properties can be ignored for certain editor types that are not designed to use these appearance settings. For instance, these properties are not in effect for TextEdit with all its descendants (ButtonEdit, TimeEdit, DateEdit etc) or RadioGroup editors.

The AppearanceObject.BorderColor property is partly in effect for certain editors and is only noticeable if the editor’s UserLookAndFeel.UseDefaultLookAndFeel property equals false and the UserLookAndFeel.Style is set to Flat.

For more information on appearances, see the Application Appearance and Skin Colors document.

Related GitHub Examples

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

how-to-print-a-custom-usercontrol-that-lays-inside-a-grid-cell-e3992/CS/CustomControlInGrid/ProjectLayoutControl.cs#L94

PrintCellHelperInfo inf = new PrintCellHelperInfo(info.LineColor, info.PS, editor.DateTime, editor.Properties.Appearance, editor.Properties.DisplayFormat.GetDisplayText(editor.EditValue), rect, info.Graph, DevExpress.Utils.HorzAlignment.Near, true, true, editor.Properties.DisplayFormat.GetFormatString(), BorderSide.All);

how-to-create-a-transparent-textedit-e3225/CS/TransparentEditorExample/AlphaBlendTextEdit/RepositoryItemIlphaBlendTextEdit.cs#L50

    base.OnLoaded();
    Appearance.BackColor = Color.Transparent;
}

custom-editor-timeedit-with-a-popup-window-e4060/CS/TimeEditControl/TimeEditPopupControl/TimeEditPopupControl.cs#L36

DoubleBuffered = true;
Appearance.Assign(ownerEdit.Properties.Appearance);
InitializeComponent();

VB.NET

how-to-print-a-custom-usercontrol-that-lays-inside-a-grid-cell-e3992/VB/CustomControlInGrid/ProjectLayoutControl.vb#L90

Dim inf As New PrintCellHelperInfo(info.LineColor, info.PS, editor.DateTime, editor.Properties.Appearance, editor.Properties.DisplayFormat.GetDisplayText(editor.EditValue), rect, info.Graph, DevExpress.Utils.HorzAlignment.Near, True, True, editor.Properties.DisplayFormat.GetFormatString(), BorderSide.All)

how-to-create-a-transparent-textedit-e3225/VB/TransparentEditorExample/AlphaBlendTextEdit/RepositoryItemIlphaBlendTextEdit.vb#L59

    MyBase.OnLoaded()
    Appearance.BackColor = Color.Transparent
End Sub

custom-editor-timeedit-with-a-popup-window-e4060/VB/TimeEditControl/TimeEditPopupControl/TimeEditPopupControl.vb#L32

DoubleBuffered = True
Appearance.Assign(ownerEdit.Properties.Appearance)
InitializeComponent()