Skip to main content

RepositoryItem.Appearance Property

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

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v23.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

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

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.

Read the following topic for additional information: Application Appearance and Skin Colors.

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.

Important

In Advanced Mode or when the WXI Skin is applied, use the Appearance.BackColor property to specify the editor’s background color. Other appearance settings that specify the background color of the editor in different states are ignored (for example, the AppearanceReadOnly.BackColor, AppearanceFocused.BackColor, AppearanceDisabled.BackColor).

if (textEdit1.Properties.ReadOnly) {
    textEdit1.Properties.Appearance.BackColor = Color.LightGray;
}
See Also