Back to Devexpress

PivotCustomDrawEventArgs.Handled Property

windowsforms-devexpress-dot-xtrapivotgrid-dot-pivotcustomdraweventargs-5e0fba21.md

latest5.5 KB
Original Source

PivotCustomDrawEventArgs.Handled Property

Gets or sets whether an event was handled, if it was handled the default actions are not required.

Namespace : DevExpress.XtraPivotGrid

Assembly : DevExpress.XtraPivotGrid.v25.2.dll

NuGet Package : DevExpress.Win.PivotGrid

Declaration

csharp
public bool Handled { get; set; }
vb
Public Property Handled As Boolean

Property Value

TypeDescription
Boolean

true if default painting isn’t required; otherwise, false.

|

Remarks

The events used to custom paint the various elements of a Pivot Grid Control fire before the elements are painted in their default manner. If the event parameter’s Handled property is set to true within a handler, default painting will not be performed. Otherwise, any custom painting performed within an event handler will be overridden by the Pivot Grid Control’s standard drawing.

Note

If you try to access the Handled property while an asynchronous operation is being performed, an exception will be thrown. When the operation is in progress, use the PivotCustomDrawThreadSafeEventArgs.Handled property exposed by a thread-safe event parameter instead. To access the thread-safe event parameter, use the PivotCustomDrawEventArgs.ThreadSafeArgs property. To determine whether an asynchronous operation is being performed, use the pivot grid’s IThreadSafeAccessible.IsAsyncInProgress property. For more information, see Asynchronous Mode.

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.

winforms-pivot-change-the-field-value-header-appearance-backcolor/CS/WindowsApplication53/Form1.cs#L28

csharp
e.GraphicsCache.FillRectangle(e.GraphicsCache.GetSolidBrush(Color.FromArgb(50, 0, 0, 200)), e.Bounds);
    e.Handled = true;
}

winforms-pivot-grid-hide-the-grand-total-column-and-text-labels/CS/RemoveGridLinesExample/Form1.cs#L25

csharp
e.Graphics.FillRectangle(Brushes.White, e.Bounds);
    e.Handled = true;
}

winforms-pivot-grid-draw-a-custom-element-on-mouse-hover/CS/WindowsApplication73/Form1.cs#L54

csharp
e.Graphics.FillRectangle(Brushes.Chartreuse, rect);
    e.Handled = true;
}

winforms-pivot-change-the-field-value-header-appearance-backcolor/VB/WindowsApplication53/Form1.vb#L29

vb
e.GraphicsCache.FillRectangle(e.GraphicsCache.GetSolidBrush(Color.FromArgb(50, 0, 0, 200)), e.Bounds)
    e.Handled = True
End If

winforms-pivot-grid-hide-the-grand-total-column-and-text-labels/VB/RemoveGridLinesExample/Form1.vb#L29

vb
e.Graphics.FillRectangle(Brushes.White, e.Bounds)
    e.Handled = True
End If

winforms-pivot-grid-draw-a-custom-element-on-mouse-hover/VB/WindowsApplication73/Form1.vb#L53

vb
e.Graphics.FillRectangle(Brushes.Chartreuse, rect)
    e.Handled = True
End If

See Also

PivotCustomDrawEventArgs Class

PivotCustomDrawEventArgs Members

DevExpress.XtraPivotGrid Namespace