CheckPrimitive
Represents a primitive element that renders checkboxes with support for checked, unchecked, and indeterminate states.
CheckPrimitive extends RadioPrimitive to provide checkbox-specific functionality, including support for three-state checkboxes (checked, unchecked, indeterminate) and various visual styles.
The primitive supports different rendering styles such as XP style, custom styles, and can be configured to draw fills and other visual enhancements. It's commonly used in checkbox controls, data grid cells, and other UI elements that require checkbox functionality.
Unlike radio buttons, checkboxes rendered by this primitive can be independently selected and support tri-state behavior when needed.
Definition
Namespace:Telerik.WinControls.Primitives
Assembly:Telerik.WinControls.dll
Syntax:
public class CheckPrimitive : RadioPrimitive, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IStylableNode, IPrimitive, IFillElement, IPrimitiveElement, IShapedElementInheritance: objectDisposableObjectRadObjectRadElementVisualElementBasePrimitiveFillPrimitiveRadioPrimitiveCheckPrimitive...
Implements:
Inherited Members
Constructors
public CheckPrimitive()Fields
public static RadProperty CheckPrimitiveStylePropertypublic static RadProperty CheckThicknessPropertypublic static RadProperty DrawFillPropertypublic static RadProperty HorizontalOffestPropertypublic static RadProperty SquareHeightAdjustPropertypublic static RadProperty SquareWidthAdjustPropertypublic static RadProperty UseFixedCheckSizePropertypublic static RadProperty VerticalOffestPropertyProperties
Gets or sets a value indicating the style of the check box primitive.
public CheckPrimitiveStyleEnum CheckPrimitiveStyle { get; set; }public ToggleState CheckState { get; set; }Gets or sets a value that determines the checkmark thickness. Use this property only when UseFixedCheckSize property is set to false.
public int CheckThickness { get; set; }Gets or sets a value indicating whether to draw the background.
public bool DrawFill { get; set; }Gets or sets a value that determines how the checkmark position in Indeterminate will be adjusted horizontal (in pixels).
public int HorizontalOffest { get; set; }Gets or sets a value that determines how the checkmark height in Indeterminate state will be adjusted (in pixels).
public int SquareHeightAdjust { get; set; }Gets or sets a value that determines how the checkmark width in Indeterminate state will be adjusted (in pixels).
public int SquareWidthAdjust { get; set; }Gets or sets a value that determines whether the checkmark size is fixed to 8;8 pixels.
public bool UseFixedCheckSize { get; set; }Gets or sets a value that determines how the checkmark position in Indeterminate state will be adjusted vertical (in pixels).
public int VerticalOffest { get; set; }Methods
Renders the radio button primitive using the specified graphics context with rotation and scaling support.
public override void PaintPrimitive(IGraphics graphics, float angle, SizeF scale)The graphics context to use for rendering the radio button.
anglefloatThe rotation angle in degrees to apply during rendering.
scaleSizeFThe scaling factor to apply during rendering.
Overrides:
This method performs comprehensive radio button rendering including parameter validation, gradient color setup, and shape-based or rectangular rendering depending on configuration.
The rendering process supports up to 4 gradient colors and automatically handles different gradient styles, parent shape inheritance, and various radio button visual states.