CustomDrawEventArgs.Handled Property

Gets or sets a value specifying whether an event was handled and that the default element painting is therefore not required.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v19.1.dll

Declaration

C#

public bool Handled { get; set; }

VB.NET

Public Property Handled As Boolean

Property Value

Type	Description
Boolean	true, if the default element painting is not required; otherwise, false.

Remarks

If custom drawing is implemented and the Handled property value remains set to false, all the custom drawing performed will be overwritten by the default painting mechanism using the appearance settings. These appearance settings are specified by the CustomDrawEventArgs.Appearance property.

Set the Handled property to true to prevent the default painting mechanism from clearing any custom drawing after a custom draw event handler has been completed.

The CustomDrawEventArgs.DefaultDraw method, when called, automatically sets the Handled property to true.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Handled 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-display-bands-and-columns-in-the-same-tree-list-in-the-customization-form-e3723/CS/CustomDescendants/TreeListBandedCustomizationForm.cs#L63

    customCellPainter.DrawObject(infoArgs);
    e.Handled = true;
}

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

    DrawButtons(e);
    e.Handled = true;
}

how-to-create-an-effect-of-a-banded-treelist-e1856/CS/WindowsApplication1/TreeListHeaderMerger.cs#L38

if (nextColumn == null) return;
if (e.Column == nextColumn) { e.Handled = true; return; }
if (e.Column != columnToMerge) return;

how-to-implement-a-search-by-visible-nodes-in-treelist-e2728/CS/WindowsApplication1/MyTreeListSearchHelper.cs#L30

{
    e.Handled = true;
    if (e.Node.Focused && e.Column.FieldName == FieldName)

how-to-show-checkboxes-for-only-a-specific-level-e2810/CS/WindowsApplication1/Form1.cs#L91

    e.ObjectArgs.State = DevExpress.Utils.Drawing.ObjectState.Disabled;
    e.Handled = NeedHide;
}

VB.NET

how-to-display-bands-and-columns-in-the-same-tree-list-in-the-customization-form-e3723/VB/CustomDescendants/TreeListBandedCustomizationForm.vb#L70

    customCellPainter.DrawObject(infoArgs)
    e.Handled = True
End Sub

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

    DrawButtons(e)
    e.Handled = True
End If

how-to-create-an-effect-of-a-banded-treelist-e1856/VB/WindowsApplication1/TreeListHeaderMerger.vb#L39

If e.Column Is nextColumn Then
    e.Handled = True
    Return

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

If index >= 0 Then
    e.Handled = True
    If e.Node.Focused AndAlso e.Column.FieldName = FieldName Then

how-to-show-checkboxes-for-only-a-specific-level-e2810/VB/WindowsApplication1/Form1.vb#L104

    e.ObjectArgs.State = DevExpress.Utils.Drawing.ObjectState.Disabled
    e.Handled = NeedHide
End Sub