CustomDrawEventArgs.Appearance Property

Gets the painted element’s appearance settings.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v18.2.dll

Declaration

C#

public AppearanceObject Appearance { get; }

VB.NET

Public ReadOnly Property Appearance As AppearanceObject

Property Value

Type	Description
AppearanceObject	A AppearanceObject object specifying the painted element’s appearance settings.

Remarks

Each element within a Tree List is painted using specific appearance settings (background and foreground colors, gradient mode, font, text alignment, etc). Appearance settings are represented by AppearanceObject objects.

The Appearance property can be used in a number of ways:

• Read the Appearance property’s attributes to custom paint an element using the default settings. In this case, you should set the CustomDrawEventArgs.Handled property to true to stop the default painting mechanism from clearing your paintings.
• Change specific attributes of the Appearance property and leave the CustomDrawEventArgs.Handled property set to false. This forces the Tree List to paint the element using the default painting mechanism but with the modified appearance settings.

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-implement-a-search-by-visible-nodes-in-treelist-e2728/CS/WindowsApplication1/MyTreeListSearchHelper.cs#L33

{
    paint.DrawMultiColorString(e.Cache, e.Bounds, e.CellText, Text, e.Appearance, Color.Red, Color.Yellow, false, index);
}

how-to-add-a-find-panel-similar-to-the-one-provided-by-gridcontrol-to-treelist-e2877/CS/WindowsApplication3/FindPanel.cs#L152

e.Cache.Paint.DrawMultiColorString(e.Cache, viewInfo.MaskBoxRect, e.CellText, SearchText,
    e.Appearance, Color.Black, Color.Orange, true, index);
DrawButtons(e);

how-to-create-custom-treelist-control-which-implements-a-web-style-comment-system-e3520/CS/TestMyTreeListForum/MyTreeListPaintHelper.cs#L22

    for (int i = 0; i < node.Buttons.Count; i++)
        node.Buttons[i].Painter.Draw(new MyToolButtonDrawEventArgs(e.Appearance, node.Buttons[i].ViewInfo, e.Cache));
}

how-to-highlight-the-next-or-previous-search-result-in-the-treelist-t368346/CS/WindowsFormsApplication2/FindHelper.cs#L113

e.Appearance.BackColor = Color.Empty;
e.Cache.Paint.DrawMultiColorString(e.Cache, tevi.MaskBoxRect, e.CellText, filterCellText, e.Appearance, e.Appearance.ForeColor, HighLightColor, false, filterTextIndex);
e.Handled = true;

VB.NET

how-to-implement-a-search-by-visible-nodes-in-treelist-e2728/VB/WindowsApplication1/MyTreeListSearchHelper.vb#L27

If e.Node.Focused AndAlso e.Column.FieldName = FieldName Then
    paint.DrawMultiColorString(e.Cache, e.Bounds, e.CellText, Text, e.Appearance, Color.Red, Color.Yellow, False, index)
Else

how-to-add-a-find-panel-similar-to-the-one-provided-by-gridcontrol-to-treelist-e2877/VB/WindowsApplication3/FindPanel.vb#L153

e.Appearance.FillRectangle(e.Cache, e.Bounds)
e.Cache.Paint.DrawMultiColorString(e.Cache, viewInfo.MaskBoxRect, e.CellText, SearchText, e.Appearance, Color.Black, Color.Orange, True, index)
DrawButtons(e)

how-to-create-custom-treelist-control-which-implements-a-web-style-comment-system-e3520/VB/TestMyTreeListForum/MyTreeListPaintHelper.vb#L20

For i As Integer = 0 To node.Buttons.Count - 1
    node.Buttons(i).Painter.Draw(New MyToolButtonDrawEventArgs(e.Appearance, node.Buttons(i).ViewInfo, e.Cache))
Next i

how-to-highlight-the-next-or-previous-search-result-in-the-treelist-t368346/VB/WindowsFormsApplication2/FindHelper.vb#L119

e.Appearance.BackColor = Color.Empty
e.Cache.Paint.DrawMultiColorString(e.Cache, tevi.MaskBoxRect, e.CellText, filterCellText, e.Appearance, e.Appearance.ForeColor, HighLightColor, False, filterTextIndex)
e.Handled = True