New to Telerik UI for WinFormsStart a free 30-day trial

Represents a checkbox control that allows users to select or deselect an option. Inherits from RadToggleButton and wraps the RadCheckBoxElement for functionality.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
public class RadCheckBox : RadToggleButton, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, ISupportRootUIAutomation

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadButtonBaseRadToggleButtonRadCheckBox...

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIDisposableIDropTargetILayoutHandlerINotifyPropertyChangedISupportInitializeISupportInitializeNotificationISupportRootUIAutomationISynchronizeInvokeIWin32Window...

Inherited Members RadToggleButton.RadToggleButton_Initialized(object, EventArgs)RadToggleButton.CreateChildItems(RadElement)RadToggleButton.OnToggleStateChanging(StateChangingEventArgs)RadToggleButton.OnToggleStateChanged(EventArgs)RadToggleButton.OnCheckStateChanging(CheckStateChangingEventArgs)RadToggleButton.OnCheckStateChanged(EventArgs)RadToggleButton.OnToggleChanged(EventArgs)RadToggleButton.WndProc(ref Message)RadToggleButton.InitializeUIAutomationProvider()RadToggleButton.ResetBackColorThemeOverrides()RadToggleButton.SetForeColorThemeOverrides()RadToggleButton.ResetForeColorThemeOverrides()RadToggleButton.ToggleStateRadToggleButton.IsCheckedRadToggleButton.CheckStateRadToggleButton.IsThreeStateRadToggleButton.ReadOnlyRadToggleButton.EnableUIAutomationRadToggleButton.ToggleStateChangingRadToggleButton.ToggleStateChangedRadToggleButton.CheckStateChangingRadToggleButton.CheckStateChangedRadButtonBase.InitializeRootElement(RootRadElement)RadButtonBase.PerformClick()RadButtonBase.ShouldSerializeChildProperty(RadProperty, RadObject)RadButtonBase.ProcessMnemonic(char)RadButtonBase.OnGotFocus(EventArgs)RadButtonBase.OnClick(EventArgs)RadButtonBase.DefaultTextAlignmentRadButtonBase.TextRadButtonBase.AllowShowFocusCuesRadButtonBase.MeasureTrailingSpacesRadButtonBase.SvgImageRadButtonBase.ImageRadButtonBase.ImageIndexRadButtonBase.ImageKeyRadButtonBase.DisplayStyleRadButtonBase.TextWrapRadButtonBase.TextImageRelationRadButtonBase.ImageAlignmentRadButtonBase.TextAlignmentRadButtonBase.DoubleClickRadButtonBase.MouseDoubleClickRadControl.isResizing2RadControl.isDisposing2RadControl.invalidResizeRectRadControl.isAccessibilityRequestedRadControl.Dispose(bool)RadControl.Construct()RadControl.CreateBehavior()RadControl.CreateRootElement()RadControl.LoadElementTree()RadControl.LoadElementTree(Size)RadControl.OnKeyDown(KeyEventArgs)RadControl.OnKeyUp(KeyEventArgs)RadControl.OnPreviewKeyDown(PreviewKeyDownEventArgs)RadControl.OnKeyPress(KeyPressEventArgs)RadControl.OnDoubleClick(EventArgs)RadControl.OnMouseDown(MouseEventArgs)RadControl.OnMouseUp(MouseEventArgs)RadControl.OnMouseEnter(EventArgs)RadControl.OnMouseLeave(EventArgs)RadControl.OnMouseMove(MouseEventArgs)RadControl.OnMouseHover(EventArgs)RadControl.OnMouseWheel(MouseEventArgs)RadControl.OnMouseCaptureChanged(EventArgs)RadControl.OnLostFocus(EventArgs)RadControl.OnCreateControl()RadControl.OnHandleDestroyed(EventArgs)RadControl.OnParentChanged(EventArgs)RadControl.OnVisibleChanged(EventArgs)RadControl.OnFontChanged(EventArgs)RadControl.OnForeColorChanged(EventArgs)RadControl.OnBackColorChanged(EventArgs)RadControl.OnEnabledChanged(EventArgs)RadControl.OnBindingContextChanged(EventArgs)RadControl.OnLocationChanged(EventArgs)RadControl.OnPaddingChanged(EventArgs)RadControl.OnRightToLeftChanged(EventArgs)RadControl.OnPaint(PaintEventArgs)RadControl.OnLayout(LayoutEventArgs)RadControl.OnAutoSizeChanged(EventArgs)RadControl.OnInvalidated(RadElement)RadControl.OnLoad(Size)RadControl.OnCaptureLosing()RadControl.OnToolTipTextNeeded(object, ToolTipTextNeededEventArgs)RadControl.OnScreenTipNeeded(object, ScreenTipNeededEventArgs)RadControl.OnThemeNameChanged(ThemeNameChangedEventArgs)RadControl.ProcessFocusRequested(RadElement)RadControl.ProcessCaptureChangeRequested(RadElement, bool)RadControl.ProcessAutoSizeChanged(bool)RadControl.IsInputKey(Keys)RadControl.GetInputElement()RadControl.BeginInit()RadControl.EndInit()RadControl.OnNotifyPropertyChanged(string)RadControl.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadControl.GetPreferredSize(Size)RadControl.SetBoundsCore(int, int, int, int, BoundsSpecified)RadControl.GetRootElementDesiredSize(int, int, int, int)RadControl.OnZoomGesture(ZoomGestureEventArgs)RadControl.OnRotateGesture(RotateGestureEventArgs)RadControl.OnPanGesture(PanGestureEventArgs)RadControl.OnTwoFingerTapGesture(GestureEventArgs)RadControl.OnPressAndTapGesture(PressAndTapGestureEventArgs)RadControl.OnGesture(GestureEventArgs)RadControl.ProcessGesture(Message)RadControl.EnableGesture(GestureType)RadControl.DisableGesture(GestureType)RadControl.Refresh()RadControl.SuspendUpdate()RadControl.ResumeUpdate()RadControl.ResumeUpdate(bool)RadControl.InvokeLayoutCallback(LayoutCallback)RadControl.RegisterHostedControl(RadHostItem)RadControl.UnregisterHostedControl(RadHostItem, bool)RadControl.ResolveStyleGroupForElement(StyleGroup, RadObject)RadControl.GetPlainText()RadControl.ShouldSerializeProperty(RadProperty)RadControl.ShouldSerializeProperty(RadProperty, RadObject)RadControl.ResetProperty(RadProperty, RadObject)RadControl.CanEditElementAtDesignTime(RadElement)RadControl.ProcessCodedUIMessage(ref IPCMessage)RadControl.FindPropertyInChildren(RadControl, IPCMessage)RadControl.ScaleControl(SizeF, BoundsSpecified)RadControl.PerformRadAutoScale(BoundsSpecified?)RadControl.GetMonitorDpiScaleFactor(Control)RadControl.SetRadAutoScale(bool)RadControl.EnableDpiScalingRadControl.EnableRadAutoScaleRadControl.EnableRadFormInitialDpiScalingRadControl.EnableImageDpiScalingRadControl.EnableSvgImagesRadControl.IsLoadedRadControl.ElementTreeRadControl.UseCompatibleTextRenderingDefaultValueRadControl.BehaviorRadControl.RootElementRadControl.PaddingRadControl.ThemeNameRadControl.EnableThemingRadControl.ThemeClassNameRadControl.ImageListRadControl.ImageScalingSizeRadControl.UseCompatibleTextRenderingRadControl.MaximumSizeRadControl.MinimumSizeRadControl.FocusableRadControl.SiteRadControl.CausesValidationRadControl.IsInitializingRadControl.SmallImageListRadControl.SmallImageScalingSizeRadControl.IsDesignModeRadControl.IsDisplayedRadControl.FocusedElementRadControl.ShowItemToolTipsRadControl.CommandBindingsRadControl.EnableKeyMapRadControl.BackColorRadControl.ForeColorRadControl.ValidationCancelRadControl.EnableAnalyticsRadControl.AnalyticsNameRadControl.EnableRadAccessibilityObjectsRadControl.EnableCodedUITestsRadControl.EnableCodedUITestsDefaultValueRadControl.EnableUIAutomationDefaultValueRadControl.ElementInvalidatedRadControl.ToolTipTextNeededRadControl.ScreenTipNeededRadControl.ThemeNameChangedRadControl.InitializedRadControl.PropertyChangedRadControl.ZoomGestureRadControl.RotateGestureRadControl.PanGestureRadControl.TwoFingerTapGestureRadControl.PressAndTapGesture...

Constructors

Initializes a new instance of the RadCheckBox class. Creates a checkbox control with default settings and enables automatic sizing.

C#
public RadCheckBox()

Properties

Gets or sets a value indicating whether the control is automatically resized to display its entire contents. This property is enabled by default for checkbox controls to ensure proper text display.

C#
[Browsable(true)]
public override bool AutoSize { get; set; }

Overrides: RadControl.AutoSize

Gets the RadCheckBoxElement instance wrapped by this control. This element encapsulates the actual functionality and visual representation of the checkbox.

C#
[Browsable(false)]
public RadCheckBoxElement ButtonElement { get; }

Gets or sets the alignment of the checkbox mark relative to the text content.

C#
public ContentAlignment CheckAlignment { get; set; }

Gets or sets a value indicating the checked state of the checkbox. This property provides compatibility with standard checkbox controls and maps to the toggle state functionality.

C#
[Bindable(true)]
public bool Checked { get; set; }

Gets the default size of the checkbox control when no explicit size is specified.

C#
protected override Size DefaultSize { get; }

Overrides: RadToggleButton.DefaultSize

Gets or sets the font used to display text in the checkbox control. This property affects both the control and its underlying button element.

C#
public override Font Font { get; set; }

Overrides: RadButtonBase.Font

Gets or sets a value indicating whether mnemonics are used for keyboard navigation. When enabled, users can activate the checkbox using Alt + the mnemonic character.

C#
public bool UseMnemonic { get; set; }

Methods

Handles the toggle state changed event from the underlying button element and notifies about property changes.

C#
protected override void ButtonElement_ToggleStateChanged(object sender, StateChangedEventArgs args)
Parameters:senderobject

The source of the event

argsStateChangedEventArgs

The StateChangedEventArgs containing event data

Overrides: RadToggleButton.ButtonElement_ToggleStateChanged(object, StateChangedEventArgs)

Handles the toggle state changing event from the underlying button element.

C#
protected override void ButtonElement_ToggleStateChanging(object sender, StateChangingEventArgs args)
Parameters:senderobject

The source of the event

argsStateChangingEventArgs

The StateChangingEventArgs containing event data

Overrides: RadToggleButton.ButtonElement_ToggleStateChanging(object, StateChangingEventArgs)

Determines whether the control defines theme settings for the specified element. This method is used by the theming infrastructure to apply appropriate themes to child elements.

C#
public override bool ControlDefinesThemeForElement(RadElement element)
Parameters:elementRadElement

The element to check for theme definition.

Returns:

bool

true if this control defines the theme for the element; otherwise, false.

Overrides: RadButtonBase.ControlDefinesThemeForElement(RadElement)

Creates an accessibility object for the checkbox control to support screen readers and accessibility tools.

C#
protected override AccessibleObject CreateAccessibilityInstance()
Returns:

AccessibleObject

A new accessibility object instance if accessibility is enabled; otherwise, the base accessibility object

Overrides: RadToggleButton.CreateAccessibilityInstance()

Creates the main button element specific for RadCheckBox functionality.

C#
protected override RadButtonElement CreateButtonElement()
Returns:

RadButtonElement

A new instance of RadCheckBoxElement that encapsulates the checkbox functionality

Overrides: RadToggleButton.CreateButtonElement()

Handles theme change events and applies Material theme specific settings if applicable.

C#
protected override void OnThemeChanged()

Overrides: RadControl.OnThemeChanged()

Handles the check state changed event and raises the appropriate event.

C#
protected override void res_CheckStateChanged(object sender, EventArgs e)
Parameters:senderobject

The source of the event

eEventArgs

The EventArgs containing event data

Overrides: RadToggleButton.res_CheckStateChanged(object, EventArgs)

Handles the check state changing event and raises the appropriate event.

C#
protected override void res_CheckStateChanging(object sender, CheckStateChangingEventArgs args)
Parameters:senderobject

The source of the event

argsCheckStateChangingEventArgs

The CheckStateChangingEventArgs containing event data

Overrides: RadToggleButton.res_CheckStateChanging(object, CheckStateChangingEventArgs)

Handles property changed events and notifies about IsChecked property changes.

C#
protected override void res_PropertyChanged(object sender, PropertyChangedEventArgs e)
Parameters:senderobject

The source of the event

ePropertyChangedEventArgs

The PropertyChangedEventArgs containing event data

Overrides: RadToggleButton.res_PropertyChanged(object, PropertyChangedEventArgs)

Sets theme overrides for the BackColor property across all visual states of the button element.

C#
protected override void SetBackColorThemeOverrides()

Overrides: RadToggleButton.SetBackColorThemeOverrides()