• Product Bundles

    DevCraft

    All Telerik .NET tools and Kendo UI JavaScript components in one package. Now enhanced with:

    • Conversational UI
    • Online Training
    • Document Processing Library
    • Embedded Reporting for web and desktop
    Web
    Kendo UI UI for jQuery UI for Angular UI for React UI for Vue UI for ASP.NET AJAX UI for ASP.NET MVC UI for ASP.NET Core UI for Blazor UI for Silverlight UI for PHP UI for JSP
    Mobile
    UI for Xamarin
    Desktop
    UI for WinForms UI for WPF UI for WinUI UI for UWP
    Reporting & Mocking
    Telerik Reporting Telerik Report Server Telerik JustMock
    Automated Testing
    Test Studio Test Studio Dev Edition
    Debugging
    FiddlerCore Fiddler Everywhere
    CMS
    Sitefinity
    UX Design
    Unite UX
    Document Management
    Telerik Document Processing
    Innovations Lab
    VR DataViz
    Free Tools
    Fiddler Classic JustAssembly JustDecompile VB.NET to C# Converter Testing Framework
    View all products
  • Overview
  • Demos
    • What's New
    • Roadmap
    • Release History
  • Docs & Support
  • Pricing
  • Search
  • Shopping cart
    • Account Overview
    • Edit Profile
    • Payment Profiles
    • Renewals & Upgrades
    • Support Tickets
    • Log out
  • Login
  • Contact Us
  • Try now

Class RadCheckBox

Represents a check box. The RadCheckBox class is a simple wrapper for the RadCheckBoxElement class. The RadCheckBox acts to transfer events to and from its corresponding RadCheckBoxElement. The RadCheckBoxElement which is essentially the RadCheckBox control may be nested in other telerik controls.

Inheritance
System.Object
RadControl
RadButtonBase
RadToggleButton
RadCheckBox
Inherited Members
RadToggleButton.CreateChildItems(RadElement)
RadToggleButton.OnToggleStateChanging(StateChangingEventArgs)
RadToggleButton.OnToggleStateChanged(EventArgs)
RadToggleButton.OnCheckStateChanging(CheckStateChangingEventArgs)
RadToggleButton.OnCheckStateChanged(EventArgs)
RadToggleButton.OnToggleChanged(EventArgs)
RadToggleButton.ResetBackColorThemeOverrides()
RadToggleButton.SetForeColorThemeOverrides()
RadToggleButton.ResetForeColorThemeOverrides()
RadToggleButton.ToggleState
RadToggleButton.CheckState
RadToggleButton.IsThreeState
RadToggleButton.ReadOnly
RadToggleButton.ToggleStateChanging
RadToggleButton.ToggleStateChanged
RadToggleButton.CheckStateChanging
RadToggleButton.CheckStateChanged
RadButtonBase.InitializeRootElement(RootRadElement)
RadButtonBase.PerformClick()
RadButtonBase.ProcessMnemonic(Char)
RadButtonBase.OnGotFocus(EventArgs)
RadButtonBase.OnClick(EventArgs)
RadButtonBase.DefaultTextAlignment
RadButtonBase.Text
RadButtonBase.AllowShowFocusCues
RadButtonBase.MeasureTrailingSpaces
RadButtonBase.SvgImage
RadButtonBase.SvgImageXml
RadButtonBase.Image
RadButtonBase.ImageIndex
RadButtonBase.ImageKey
RadButtonBase.DisplayStyle
RadButtonBase.TextWrap
RadButtonBase.TextImageRelation
RadButtonBase.ImageAlignment
RadButtonBase.TextAlignment
RadButtonBase.DoubleClick
RadButtonBase.MouseDoubleClick
RadControl.RefCount
RadControl.isResizing2
RadControl.isDisposing2
RadControl.invalidResizeRect
RadControl.isAccessibilityRequested
RadControl.Dispose(Boolean)
RadControl.Construct()
RadControl.CreateBehavior()
RadControl.CreateRootElement()
RadControl.LoadElementTree()
RadControl.LoadElementTree(Size)
RadControl.SetIsInitializing(Boolean)
RadControl.ShouldSerializeBackColor()
RadControl.ShouldSerializeForeColor()
RadControl.ShouldSerializeFont()
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.OnBindingContextChanged(EventArgs)
RadControl.OnLocationChanged(EventArgs)
RadControl.OnPaddingChanged(EventArgs)
RadControl.OnRightToLeftChanged(EventArgs)
RadControl.OnPaint(PaintEventArgs)
RadControl.OnLayout(LayoutEventArgs)
RadControl.OnAutoSizeChanged(EventArgs)
RadControl.WndProc(Message)
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, Boolean)
RadControl.ProcessAutoSizeChanged(Boolean)
RadControl.CallOnMouseCaptureChanged(EventArgs)
RadControl.CallBaseOnGotFocus(EventArgs)
RadControl.CallBaseOnLostFocus(EventArgs)
RadControl.CallOnToolTipTextNeeded(Object, ToolTipTextNeededEventArgs)
RadControl.CallOnScreenTipNeeded(Object, ScreenTipNeededEventArgs)
RadControl.CallOnMouseUp(MouseEventArgs)
RadControl.CallOnMouseDown(MouseEventArgs)
RadControl.CallOnClick(EventArgs)
RadControl.CallOnDoubleClick(EventArgs)
RadControl.CallOnMouseEnter(EventArgs)
RadControl.CallOnMouseWheel(MouseEventArgs)
RadControl.CallOnMouseLeave(EventArgs)
RadControl.CallOnMouseMove(MouseEventArgs)
RadControl.CallOnMouseHover(EventArgs)
RadControl.CallOnPreviewKeyDown(PreviewKeyDownEventArgs)
RadControl.CallBaseOnKeyDown(KeyEventArgs)
RadControl.CallOnKeyDown(KeyEventArgs)
RadControl.CallBaseOnKeyPress(KeyPressEventArgs)
RadControl.CallOnKeyPress(KeyPressEventArgs)
RadControl.IsInputKey(Keys)
RadControl.GetInputElement()
RadControl.CallBaseOnKeyUp(KeyEventArgs)
RadControl.CallOnKeyUp(KeyEventArgs)
RadControl.CallOnThemeNameChanged(ThemeNameChangedEventArgs)
RadControl.CallOnVisibleChanged(EventArgs)
RadControl.BeginInit()
RadControl.EndInit()
RadControl.OnNotifyPropertyChanged(String)
RadControl.OnNotifyPropertyChanged(PropertyChangedEventArgs)
RadControl.IComponentTreeHandler.GetShowFocusCues()
RadControl.IComponentTreeHandler.CreateRootElement()
RadControl.IComponentTreeHandler.CreateChildItems(RadElement)
RadControl.IComponentTreeHandler.InitializeRootElement(RootRadElement)
RadControl.IComponentTreeHandler.InvalidateElement(RadElement)
RadControl.IComponentTreeHandler.InvalidateElement(RadElement, Rectangle)
RadControl.IComponentTreeHandler.InvalidateIfNotSuspended()
RadControl.IComponentTreeHandler.GetAmbientPropertyValue(RadProperty)
RadControl.IComponentTreeHandler.ControlThemeChangedCallback()
RadControl.IComponentTreeHandler.OnAmbientPropertyChanged(RadProperty)
RadControl.IComponentTreeHandler.OnFocusRequested(RadElement)
RadControl.IComponentTreeHandler.OnCaptureChangeRequested(RadElement, Boolean)
RadControl.IComponentTreeHandler.OnDisplayPropertyChanged(RadPropertyChangedEventArgs)
RadControl.IComponentTreeHandler.CallOnThemeNameChanged(ThemeNameChangedEventArgs)
RadControl.IComponentTreeHandler.CallOnMouseCaptureChanged(EventArgs)
RadControl.IComponentTreeHandler.CallOnToolTipTextNeeded(Object, ToolTipTextNeededEventArgs)
RadControl.IComponentTreeHandler.CallOnScreenTipNeeded(Object, ScreenTipNeededEventArgs)
RadControl.GetPreferredSize(Size)
RadControl.SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified)
RadControl.GetRootElementDesiredSize(Int32, Int32, Int32, Int32)
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(Boolean)
RadControl.InvokeLayoutCallback(LayoutCallback)
RadControl.RegisterHostedControl(RadHostItem)
RadControl.UnregisterHostedControl(RadHostItem, Boolean)
RadControl.ResolveStyleGroupForElement(StyleGroup, RadObject)
RadControl.GetPlainText()
RadControl.CanEditUIElement(RadElement)
RadControl.GetChildAt(Int32)
RadControl.ShouldSerializeProperty(RadProperty)
RadControl.CanEditElementAtDesignTime(RadElement)
RadControl.GetControlDefaultSize()
RadControl.GetDpiScaledSize(Size)
RadControl.GetDpiScaledSize(SizeF)
RadControl.ProcessCodedUIMessage(IPCMessage)
RadControl.FindPropertyInChildren(RadControl, IPCMessage)
RadControl.CallAccessibilityNotifyClients(AccessibleEvents, Int32)
RadControl.IPCHost.ProcessMessage(IPCMessage)
RadControl.ScaleControl(SizeF, BoundsSpecified)
RadControl.IComponentTreeHandler.get_Name()
RadControl.IComponentTreeHandler.set_Name(String)
RadControl.EnableDpiScaling
RadControl.EnableImageDpiScaling
RadControl.EnableSvgImages
RadControl.IsTrial
RadControl.IsLoaded
RadControl.LayoutManager
RadControl.ElementTree
RadControl.UseCompatibleTextRenderingDefaultValue
RadControl.Behavior
RadControl.RootElement
RadControl.Padding
RadControl.ThemeName
RadControl.EnableTheming
RadControl.ThemeClassName
RadControl.ImageList
RadControl.ImageScalingSize
RadControl.UseCompatibleTextRendering
RadControl.MaximumSize
RadControl.MinimumSize
RadControl.Focusable
RadControl.Site
RadControl.CausesValidation
RadControl.IsInitializing
RadControl.SmallImageList
RadControl.SmallImageScalingSize
RadControl.IsDesignMode
RadControl.IsDisplayed
RadControl.FocusedElement
RadControl.ShowItemToolTips
RadControl.CommandBindings
RadControl.EnableKeyMap
RadControl.BackColor
RadControl.ForeColor
RadControl.ValidationCancel
RadControl.IComponentTreeHandler.IsDesignMode
RadControl.IComponentTreeHandler.ElementTree
RadControl.IComponentTreeHandler.Behavior
RadControl.IComponentTreeHandler.Initializing
RadControl.IComponentTreeHandler.ThemeClassName
RadControl.EnableGestures
RadControl.EnableAnalytics
RadControl.AnalyticsName
RadControl.EnableRadAccessibilityObjects
RadControl.AccessibilityRequested
RadControl.EnableCodedUITests
RadControl.EnableCodedUITestsDefaultValue
RadControl.IPCHost.Context
RadControl.ElementInvalidated
RadControl.ToolTipTextNeeded
RadControl.ScreenTipNeeded
RadControl.ThemeNameChanged
RadControl.Initialized
RadControl.PropertyChanged
RadControl.ZoomGesture
RadControl.RotateGesture
RadControl.PanGesture
RadControl.TwoFingerTapGesture
RadControl.PressAndTapGesture
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

public class RadCheckBox : RadToggleButton, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider

Constructors

RadCheckBox()

Declaration
public RadCheckBox()

Properties

AutoSize

Gets or sets a value indicating whether the control is automatically resized to display its entire contents.

Declaration
public override bool AutoSize { get; set; }
Property Value
System.Boolean

Overrides
RadControl.AutoSize

ButtonElement

Gets the instance of RadCheckBoxElement wrapped by this control. RadCheckBoxElement is the main element in the hierarchy tree and encapsulates the actual functionality of RadCheckBox.

Declaration
public RadCheckBoxElement ButtonElement { get; }
Property Value
RadCheckBoxElement

CheckAlignment

Gets or sets a value indicating the alignment of the check box.

Declaration
[RadPropertyDefaultValue("CheckAlignment", typeof(RadCheckBoxElement))]
[RadDescription("CheckAlignment", typeof(RadCheckBoxElement))]
public ContentAlignment CheckAlignment { get; set; }
Property Value
System.Drawing.ContentAlignment

Checked

Gets or sets value indicating the checked state of the checkbox.

Declaration
public bool Checked { get; set; }
Property Value
System.Boolean

Remarks

Since RadCheckBox is tri-state based (ToggleState property) the Checked property is provided for compatibility only. Checked=true corresponds to ToggleState.On and Checked=false corresponds to ToggleState.Off. If value of ToggleState property equals Indeterminate, value of Checked property is 'false'.

DefaultSize

Declaration
protected override Size DefaultSize { get; }
Property Value
System.Drawing.Size

Overrides
RadToggleButton.DefaultSize

Font

Gets or sets the Font of the control. This actually the Font property of the root element.

Declaration
public override Font Font { get; set; }
Property Value
System.Drawing.Font

Overrides
RadControl.Font

IsChecked

Declaration
public override bool IsChecked { get; set; }
Property Value
System.Boolean

Overrides
RadToggleButton.IsChecked

UseMnemonic

Gets or sets a value indication whether mnemonics are used.

Declaration
public bool UseMnemonic { get; set; }
Property Value
System.Boolean

Methods

ButtonElement_ToggleStateChanged(Object, StateChangedEventArgs)

Declaration
protected override void ButtonElement_ToggleStateChanged(object sender, StateChangedEventArgs args)
Parameters
System.Object sender

StateChangedEventArgs args

Overrides
RadToggleButton.ButtonElement_ToggleStateChanged(Object, StateChangedEventArgs)

ButtonElement_ToggleStateChanging(Object, StateChangingEventArgs)

Declaration
protected override void ButtonElement_ToggleStateChanging(object sender, StateChangingEventArgs args)
Parameters
System.Object sender

StateChangingEventArgs args

Overrides
RadToggleButton.ButtonElement_ToggleStateChanging(Object, StateChangingEventArgs)

ControlDefinesThemeForElement(RadElement)

Declaration
public override bool ControlDefinesThemeForElement(RadElement element)
Parameters
RadElement element

Returns
System.Boolean

Overrides
RadButtonBase.ControlDefinesThemeForElement(RadElement)

CreateAccessibilityInstance()

Declaration
protected override AccessibleObject CreateAccessibilityInstance()
Returns
System.Windows.Forms.AccessibleObject

Overrides
RadToggleButton.CreateAccessibilityInstance()

CreateButtonElement()

Create main button element that is specific for RadCheckBox.

Declaration
protected override RadButtonElement CreateButtonElement()
Returns
RadButtonElement

The element that encapsulates the functionality of RadCheckBox

Overrides
RadToggleButton.CreateButtonElement()

OnEnabledChanged(EventArgs)

Declaration
protected override void OnEnabledChanged(EventArgs e)
Parameters
System.EventArgs e

Overrides
RadControl.OnEnabledChanged(EventArgs)

OnThemeChanged()

Declaration
protected override void OnThemeChanged()
Overrides
RadControl.OnThemeChanged()

res_CheckStateChanged(Object, EventArgs)

Declaration
protected override void res_CheckStateChanged(object sender, EventArgs e)
Parameters
System.Object sender

System.EventArgs e

Overrides
RadToggleButton.res_CheckStateChanged(Object, EventArgs)

res_CheckStateChanging(Object, CheckStateChangingEventArgs)

Declaration
protected override void res_CheckStateChanging(object sender, CheckStateChangingEventArgs args)
Parameters
System.Object sender

CheckStateChangingEventArgs args

Overrides
RadToggleButton.res_CheckStateChanging(Object, CheckStateChangingEventArgs)

res_PropertyChanged(Object, PropertyChangedEventArgs)

Declaration
protected override void res_PropertyChanged(object sender, PropertyChangedEventArgs e)
Parameters
System.Object sender

System.ComponentModel.PropertyChangedEventArgs e

Overrides
RadToggleButton.res_PropertyChanged(Object, PropertyChangedEventArgs)

SetBackColorThemeOverrides()

Declaration
protected override void SetBackColorThemeOverrides()
Overrides
RadToggleButton.SetBackColorThemeOverrides()

Extension Methods

SvgExtentions.Traverse<T>(T, Func<T, IEnumerable<T>>)
SvgExtentions.TraverseDepthFirst<T>(T, Func<T, IEnumerable<T>>)

Was this article helpful?

Tell us how we can improve this article

Skip
Getting Started
  • Install Now
  • Demos
  • Step-by-Step Tutorial
  • Sample Applications
  • SDK Samples
  • Visual Studio Extensions
Support Resources
  • Code Library
  • Knowledge Base
  • Videos
Community
  • Forums
  • Blogs
  • Feedback Portal
  • Document Processing Feedback Portal

Copyright © 2018 Progress Software Corporation and/or its subsidiaries or affiliates.
All Rights Reserved.

Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries. See Trademarks for appropriate markings.