Provides a set of methods to draw and measure VisualTip objects, and a base class for custom VisualTip renderers.

For a list of all members of this type, see VisualTipRenderer Members.

System.Object
   Skybound.VisualTips.Rendering.VisualTipRenderer
      Skybound.VisualTips.Rendering.VisualTipBalloonRenderer
      Skybound.VisualTips.Rendering.VisualTipOfficeRenderer

Thread Safety

Public static (Shared in Visual Basic) members of this type are safe for multithreaded operations. Instance members are not guaranteed to be thread-safe.

Remarks

This type provides the foundation for all rendering types. You may create a custom appearance for your tips by inheriting from this tip and overridding certain methods.

Each VisualTipProvider may be assigned a unique VisualTipRenderer. At design-time, this is done by selecting one of the predefined renderers from the drop-down list of the VisualTipProvider.Renderer property in the property grid. Using code, assign a new instance of a VisualTipRenderer-derrived type to the Renderer property. All tips displayed by the provider will be painted and measured using the assigned renderer.

Each element of a tip -- the images and text -- are represented by a VisualTipRenderElement value. Many methods in this type have parameters of the VisualTipRenderElement type.

When a tip is painted, the following overridable methods are called (in this order):

• OnDrawShadow draws the tip shadow.
• OnDrawWindow draws the window background.
• OnDrawElement is called once for each value of VisualTipRenderElement.

In addition, the OnCreateLayout and OnCreateMaskRegion methods may be called at any time.

To customize only the fonts or colors used by the renderer, override these methods instead:

• GetElementFont returns the font used for a specific element.
• GetElementTextColor returns the font used for a specific element.

VisualTipRenderer also provides a number of support methods which make it easier to write a custom renderer:

• HasFooter returns whether the tip has a footer.
• GetTitleText returns the text that will be displayed in the title area. The return value combines the title and shortcut text.
• GetBodyText returns the text displayed in the body of a tip (the displayed text may be different when the tip is displayed for a disabled component).
• HasShadow returns whether the tip should be drawn with a soft shadow.
• MeasureElement measures and returns the recommended size of a VisualTipRenderElement.

Requirements

Namespace: Skybound.VisualTips.Rendering

Assembly: Skybound.VisualTips (in Skybound.VisualTips.dll)

See Also

VisualTipRenderer Members | Skybound.VisualTips.Rendering Namespace

---