Provides the base class of all rebar rendering types.

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

System.Object
   Skybound.Rebar.Rendering.ControlRenderer
      Skybound.Rebar.Rendering.RebarBandRenderer
      Skybound.Rebar.Rendering.RebarButtonRenderer
      Skybound.Rebar.Rendering.RebarMenuItemRenderer
      Skybound.Rebar.Rendering.RebarMenuRenderer

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

A renderer is a type that can render and measure the elements of a control. After assigning values to the properties of a renderer, call one of the Draw methods to draw an element of the control or the Render method to draw the entire control.

The ControlRenderer class provides properties that are useful for rendering most types of controls. Most of these properties mirror members of the Windows Forms Control type. For example, the ForeColor and BackColor specify the foreground and background colors of a control.

If you choose to inherit from this type to create a custom renderer for your control, if possible use the constructor that accepts a Control parameter to have the control's properties used as the initial values for your renderer.

ControlRenderer also provides a number of utility methods:

• GetStringFormat returns a StringFormat instance that can be used to render the control's text.
• MeasureTextExact returns the exact dimensions of the text on a control, and is useful since the MeasureString method is not accurate for non-antialiased text.
• The RtlTranslate method flips a rectangle horizontally within the bounds of the control when the RightToLeft property is true.
• The static (Shared in Visual Basic) ShouldShowFocusCues and ShouldShowKeyboardCues methods return whether focus cues should be shown for any Control. This is useful because the ShowFocusCues and ShowFocusCues methods are defined as protected, and therefore not available to renderers.
• The DrawArrow method can be used to the draw triangle-style arrows which normally appear on buttons and menu items.
• The static (Shared in Visual Basic) DrawText method can draw text using either GDI or DrawString.
• The static (Shared in Visual Basic) MeasureText method compliments DrawText as it measures the exact width text using either GDI or DrawString.

Requirements

Namespace: Skybound.Rebar.Rendering

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

See Also

ControlRenderer Members | Skybound.Rebar.Rendering Namespace

---