Class

RadRadioButton

Initializes a new instance of the RadRadioButton class. Creates a radio button with default settings including automatic checking behavior and tab stop functionality.

Declaration

public RadRadioButton()

Gets or sets a value indicating whether the IsChecked value and the appearance of the control automatically change when the control is clicked. When true and the radio button is part of a group, it automatically ensures that only one control is checked at a time. When false, a group of radio button controls will not act as a mutually exclusive group and the IsChecked property must be updated in code.

Declaration

[Browsable(true)]
public bool AutoCheck { get; set; }

Property Value

Gets or sets a value indicating whether the control is automatically resized to display its entire contents. When enabled, the radio button will automatically adjust its size to accommodate its text and visual elements.

Declaration

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

Property Value

Overrides RadControl.AutoSize

Gets the RadRadioButtonElement that represents the visual element of this radio button control. This element contains the visual styling and behavior logic for the radio button including the check mark and text layout.

Declaration

[Browsable(false)]
public RadRadioButtonElement ButtonElement { get; }

Property Value

Gets the default size of the RadRadioButton control. This property returns the recommended dimensions for the radio button when no explicit size is set.

Declaration

protected override Size DefaultSize { get; }

Property Value

Overrides RadToggleButton.DefaultSize

Gets or sets the alignment of the radio button's check mark relative to the text. This property determines where the radio button circle appears in relation to the button text.

Declaration

public ContentAlignment RadioCheckAlignment { get; set; }

Property Value

Gets or sets a value indicating whether the user can give focus to this radio button using the TAB key. For radio buttons, this is automatically managed to ensure proper tab navigation within radio button groups. Only the checked radio button in a group typically receives tab focus.

Declaration

public bool TabStop { get; set; }

Property Value

Handles the toggle state changed event from the button element and manages tab stop behavior for radio button groups. This method ensures proper keyboard navigation within radio button groups when the checked state changes.

Declaration

protected override void ButtonElement_ToggleStateChanged(object sender, StateChangedEventArgs args)

Parameters

Overrides RadToggleButton.ButtonElement_ToggleStateChanged(object, StateChangedEventArgs)

Creates the accessibility instance for the radio button control to support assistive technologies. Returns a specialized accessibility object when accessibility objects are enabled.

Declaration

protected override AccessibleObject CreateAccessibilityInstance()

Returns

Overrides RadToggleButton.CreateAccessibilityInstance()

Creates the main button element that is specific for RadRadioButton. This method is responsible for instantiating the underlying visual element that provides the radio button functionality.

Declaration

protected override RadButtonElement CreateButtonElement()

Returns

Overrides RadToggleButton.CreateButtonElement()

Creates the child items and establishes event handlers for the radio button control. This method sets up the property change notification system for the button element.

Declaration

protected override void CreateChildItems(RadElement parent)

Parameters

Overrides RadToggleButton.CreateChildItems(RadElement)

Initializes the UI Automation provider for the radio button control. This method creates and returns the automation provider that enables assistive technologies to interact with the radio button.

Declaration

protected override IRadRawElementProviderFragmentRoot InitializeUIAutomationProvider()

Returns

Overrides RadToggleButton.InitializeUIAutomationProvider()

Raises the Enter event and handles keyboard navigation behavior for radio button groups. When entered via keyboard navigation, this method may automatically check the radio button or update tab stops.

Declaration

protected override void OnEnter(EventArgs e)

Parameters

Overrides Control.OnEnter(EventArgs)

Raises the GotFocus event and invalidates the control to update its visual appearance. This method ensures the radio button displays the appropriate focus indicators when it receives focus.

Declaration

protected override void OnGotFocus(EventArgs e)

Parameters

Overrides RadButtonBase.OnGotFocus(EventArgs)

Manages tab stop behavior for radio button groups to ensure proper keyboard navigation. This method coordinates tab stops among radio buttons in the same container to maintain standard Windows behavior.

Declaration

protected virtual void SetTabStops(bool tabPressed)

Parameters

Raises the CheckStateChanged event when the check state of the radio button changes. This method provides notification when the radio button's checked state is modified.

Declaration

protected override void res_CheckStateChanged(object sender, EventArgs e)

Parameters

Overrides RadToggleButton.res_CheckStateChanged(object, EventArgs)

Raises the CheckStateChanging event when the check state of the radio button is about to change. This method provides notification before the radio button's checked state is modified, allowing for cancellation.

Declaration

protected override void res_CheckStateChanging(object sender, CheckStateChangingEventArgs args)

Parameters

Overrides RadToggleButton.res_CheckStateChanging(object, CheckStateChangingEventArgs)