WinForms › Super Tooltip › BinarySuperToolTipDrawingEventArgs

BinarySuperToolTipDrawingEventArgs

class.NET 6 / 8 / 10.NET Framework 4.8Binarymission.WinForms.Controls.Popups

An event arguments supplying custom class, to be used when subscribing to the component's special events - i.e HeaderDraw, FooterDraw and BodyDraw.

public class BinarySuperToolTipDrawingEventArgs : EventArgs

Inherits from / implements: EventArgs

Members at a glance

`AssociatedControl`	Gets the associated control, whose tooltip is going to be owner-drawn.
`DrawingRectangle`	This property returns the drawing rectangle area of area in the tooltip surface that you have subscribed to custom draw yourself, by subscribing to the special events that this component raises - i.e. `HeaderDraw`, `FooterDraw` and `BodyDraw`.
`Graphics`	The `Graphics` object that the `BinarySuperToolTip` component uses to draw the tooltip onto.
`Handled`	Set this to true to tell `BinarySuperToolTip` that you have drawn this region yourself and it should not draw its own content over it.

Properties

AssociatedControl

public Control AssociatedControl

Gets the associated control, whose tooltip is going to be owner-drawn.

DrawingRectangle

public RectangleF DrawingRectangle

This property returns the drawing rectangle area of area in the tooltip surface that you have subscribed to custom draw yourself, by subscribing to the special events that this component raises - i.e. HeaderDraw, FooterDraw and BodyDraw.

Graphics

public Graphics Graphics

The Graphics object that the BinarySuperToolTip component uses to draw the tooltip onto.

Use this object to render your custom drawing onto the area of you have subscribed to draw yourself, by using the supplied rectangle of the area to be drawn.

Handled

public bool Handled

Set this to true to tell BinarySuperToolTip that you have drawn this region yourself and it should not draw its own content over it.

These events are raised for EVERY control the component is attached to, because they belong to the component rather than to a control. A handler that only wants to take over one control's tip returns early for the others - and until this property existed, returning early left those tips empty, because merely attaching a handler was taken as "the application draws this region". Leave Handled alone and the component draws its own header, body or footer exactly as if no handler were attached. Use AssociatedControl to decide. It was declared and documented from the first release and was never actually assigned, so it was always null; that is fixed in the same release as this property. HANDOVER.md 3ab.