Class CheckPrimitive

Represents a primitive element that renders checkboxes with support for checked, unchecked, and indeterminate states.

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
BasePrimitive
FillPrimitive
RadioPrimitive
CheckPrimitive
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls.Primitives
Assembly: Telerik.WinControls.dll

Syntax

public class CheckPrimitive : RadioPrimitive, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IStylableNode, IPrimitive, IFillElement, IPrimitiveElement, IShapedElement
Remarks

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.

Constructors

CheckPrimitive()

Declaration
public CheckPrimitive()

Fields

CheckPrimitiveStyleProperty

Declaration
public static RadProperty CheckPrimitiveStyleProperty
Field Value
RadProperty

CheckThicknessProperty

Declaration
public static RadProperty CheckThicknessProperty
Field Value
RadProperty

DrawFillProperty

Declaration
public static RadProperty DrawFillProperty
Field Value
RadProperty

HorizontalOffestProperty

Declaration
public static RadProperty HorizontalOffestProperty
Field Value
RadProperty

SquareHeightAdjustProperty

Declaration
public static RadProperty SquareHeightAdjustProperty
Field Value
RadProperty

SquareWidthAdjustProperty

Declaration
public static RadProperty SquareWidthAdjustProperty
Field Value
RadProperty

UseFixedCheckSizeProperty

Declaration
public static RadProperty UseFixedCheckSizeProperty
Field Value
RadProperty

VerticalOffestProperty

Declaration
public static RadProperty VerticalOffestProperty
Field Value
RadProperty

Properties

CheckPrimitiveStyle

Gets or sets a value indicating the style of the check box primitive.

Declaration
[RadPropertyDefaultValue("CheckPrimitiveStyle", typeof(CheckPrimitive))]
public CheckPrimitiveStyleEnum CheckPrimitiveStyle { get; set; }
Property Value
CheckPrimitiveStyleEnum

CheckState

Declaration
public ToggleState CheckState { get; set; }
Property Value
ToggleState

CheckThickness

Gets or sets a value that determines the checkmark thickness. Use this property only when UseFixedCheckSize property is set to false.

Declaration
[RadPropertyDefaultValue("CheckThickness", typeof(CheckPrimitive))]
public int CheckThickness { get; set; }
Property Value
System.Int32

DrawFill

Gets or sets a value indicating whether to draw the background.

Declaration
[RadPropertyDefaultValue("DrawFill", typeof(CheckPrimitive))]
public bool DrawFill { get; set; }
Property Value
System.Boolean

HorizontalOffest

Gets or sets a value that determines how the checkmark position in Indeterminate will be adjusted horizontal (in pixels).

Declaration
[RadPropertyDefaultValue("HorizontalOffest", typeof(CheckPrimitive))]
public int HorizontalOffest { get; set; }
Property Value
System.Int32

SquareHeightAdjust

Gets or sets a value that determines how the checkmark height in Indeterminate state will be adjusted (in pixels).

Declaration
[RadPropertyDefaultValue("SquareHeightAdjust", typeof(CheckPrimitive))]
public int SquareHeightAdjust { get; set; }
Property Value
System.Int32

SquareWidthAdjust

Gets or sets a value that determines how the checkmark width in Indeterminate state will be adjusted (in pixels).

Declaration
[RadPropertyDefaultValue("SquareWidthAdjust", typeof(CheckPrimitive))]
public int SquareWidthAdjust { get; set; }
Property Value
System.Int32

UseFixedCheckSize

Gets or sets a value that determines whether the checkmark size is fixed to 8;8 pixels.

Declaration
[RadPropertyDefaultValue("UseFixedCheckSize", typeof(CheckPrimitive))]
public bool UseFixedCheckSize { get; set; }
Property Value
System.Boolean

VerticalOffest

Gets or sets a value that determines how the checkmark position in Indeterminate state will be adjusted vertical (in pixels).

Declaration
[RadPropertyDefaultValue("VerticalOffest", typeof(CheckPrimitive))]
public int VerticalOffest { get; set; }
Property Value
System.Int32

Methods

GetClientRect()

Declaration
protected override Rectangle GetClientRect()
Returns
System.Drawing.Rectangle

Overrides

PaintPrimitive(IGraphics, Single, SizeF)

Declaration
public override void PaintPrimitive(IGraphics graphics, float angle, SizeF scale)
Parameters
IGraphics graphics

System.Single angle

System.Drawing.SizeF scale

Overrides

Extension Methods