A newer version of this page is available. Switch to the current version.

AppearanceObjectEx Class

Represents an appearance object with extended settings.

Namespace: DevExpress.Utils

Assembly: DevExpress.Utils.v19.1.dll

Declaration

public class AppearanceObjectEx :
    AppearanceObject
Public Class AppearanceObjectEx
    Inherits AppearanceObject

Remarks

The AppearanceObjectEx is derived from the AppearanceObject class and extends its functionality. It introduces the AppearanceOptionsEx.HighPriority option which allows a higher priority to be specified for the appearance object. Currently, only the appearance settings provided by the columns (in XtraTreeList, XtraGrid, XtraVerticalGrid) and style conditions (in XtraGrid) are represented by the AppearanceObjectEx objects.

When an AppearanceObject's style setting (for example, BackColor, ForeColor, Font and TextOptions.HAlignment) is set to a non-default value, the corresponding Options.Use... option (for instance, Options.UseBackColor, Options.UseForeColor, Options.UseFont and Options.UseTextOptions) is automatically set to true in the following cases:

  • The AppearanceObject belongs to a control/component (or its element), and this control/component has been completely loaded (see the control's IsLoading property to check the load status);
  • The AppearanceObject belongs to a grid column/band or tree list column/band, and the column/band belongs to a grid/tree list control;
  • The AppearanceObject is standalone, that is, it does not belong to any control or component.

In other cases, the Options.Use... options are not automatically enabled. You may need to enable these options manually for the style settings to be in effect.

For more information on appearances, see the Appearances document.

Inheritance

Object
AppearanceObject
AppearanceObjectEx
See Also