AppearanceObject Class

Represents an appearance object.

Assembly: DevExpress.Utils.v17.2.dll

Declaration

C#
VB.NET

[TypeConverter(typeof(ExpandableObjectConverter))]
public class AppearanceObject :
    IDisposable,
    ICloneable,
    IXtraSerializableLayoutEx,
    IXtraSerializable

<TypeConverter(GetType(ExpandableObjectConverter))>
Public Class AppearanceObject
    Implements IDisposable,
               ICloneable,
               IXtraSerializableLayoutEx,
               IXtraSerializable

The following members accept/return AppearanceObject objects:

Show 493 links

Remarks

The AppearanceObject class represents properties, events and methods used to customize the look and feel of an object’s contents. Properties specify fore and back color, gradient background, font, pen, brush, etc. Methods and events are used to control the display of an object’s contents.

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.

The following code snippets (auto-collected from DevExpress Examples) contain references to the AppearanceObject class.

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#
VB.NET

how-to-create-an-office-2010-like-progressbar-allowing-to-display-negative-values-e1941/CS/Class1.cs#L65


private AppearanceObject _NegativeValueAppearance;
public AppearanceObject NegativeValueAppearance

how-to-prevent-the-rowcellstyle-event-from-overriding-the-format-conditions-appearance-e1998/CS/GridView_PriorityRowCellStyle/CustomGridControl.cs#L18

{
    PriorityRowCellStyleEventArgs priorityStyleEventArgs = new PriorityRowCellStyleEventArgs(null, new AppearanceObject(), false);
    public CustomGridView() : base() { }

bandedgridview-how-to-export-certain-column-captions-vertically-t184820/CS/CustomBandedGridView/CustomView.cs#L50

if(!usePrintStyles) {
    AppearanceObject temp = new AppearanceObject();
    AppearanceHelper.Combine(temp, new AppearanceObject[] { col.Column.AppearanceHeader, View.Appearance.HeaderPanel, AppearancePrint.HeaderPanel });

how-to-show-images-in-the-checkedcomboboxedit-edit-box-and-its-dropdown-window-e2804/CS/WindowsApplication3/CheckedImageComboBoxEditPainter.cs#L20


protected override void DrawString(ControlGraphicsInfoArgs info, Rectangle bounds, string text, DevExpress.Utils.AppearanceObject appearance) {
    PopupContainerEditViewInfo viewInfo = info.ViewInfo as PopupContainerEditViewInfo;

how-to-display-a-readonly-html-formatted-text-in-grid-cells-e3167/CS/WindowsApplication3/RepositoryItemHtmlLabel.cs#L70


public static StringInfo CalculateStringInfo(Graphics g, AppearanceObject appearance, string text, Rectangle bounds ){
    return StringPainter.Default.Calculate(g, appearance, text, bounds);

how-to-create-an-office-2010-like-progressbar-allowing-to-display-negative-values-e1941/VB/Class1.vb#L70


Private _NegativeValueAppearance As AppearanceObject
Public Property NegativeValueAppearance() As AppearanceObject

how-to-prevent-the-rowcellstyle-event-from-overriding-the-format-conditions-appearance-e1998/VB/GridView_PriorityRowCellStyle/CustomGridControl.vb#L18

Inherits GridView
Private priorityStyleEventArgs As New PriorityRowCellStyleEventArgs(Nothing, New AppearanceObject(), False)
Public Sub New()

how-to-display-a-readonly-html-formatted-text-in-grid-cells-e3167/VB/WindowsApplication3/RepositoryItemHtmlLabel.vb#L71


Public Shared Function CalculateStringInfo(ByVal g As Graphics, ByVal appearance As AppearanceObject, ByVal text As String, ByVal bounds As Rectangle) As StringInfo
    Return StringPainter.Default.Calculate(g, appearance, text, bounds)

bandedgridview-how-to-export-certain-column-captions-vertically-t184820/VB/CustomBandedGridView/CustomView.vb#L65

If Not usePrintStyles Then
    Dim temp As New AppearanceObject()
    AppearanceHelper.Combine(temp, New AppearanceObject() { col.Column.AppearanceHeader, View.Appearance.HeaderPanel, AppearancePrint.HeaderPanel })

how-to-show-images-in-the-checkedcomboboxedit-edit-box-and-its-dropdown-window-e2804/VB/WindowsApplication3/CheckedImageComboBoxEditPainter.vb#L24


Protected Overrides Sub DrawString(ByVal info As ControlGraphicsInfoArgs, ByVal bounds As Rectangle, ByVal text As String, ByVal appearance As DevExpress.Utils.AppearanceObject)
    Dim viewInfo As PopupContainerEditViewInfo = TryCast(info.ViewInfo, PopupContainerEditViewInfo)

Inheritance

Object

AppearanceObject

AppearanceObjectEx

LabelControlAppearanceObject

HyperlinkLabelControlAppearanceObject

Controls

Tools

Controls and Extensions

Tools

Maintenance Mode

Controls

Tools

Controls and Extensions

Tools

Maintenance Mode

AppearanceObject Class

Declaration

Remarks

Inheritance

AppearanceObject Class

Declaration

Related API Members

Remarks

Related GitHub Examples

Inheritance