Class

RadButtonBase

Initializes a new instance of the RadButtonBase class.

Declaration

public RadButtonBase()

Indicates focus cues display, when available, based on the corresponding control type and the current UI state.

Declaration

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

Property Value

Overrides RadControl.AllowShowFocusCues

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

Declaration

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

Property Value

Gets the default size for the button control, which is 110 pixels wide by 24 pixels high.

Declaration

protected override Size DefaultSize { get; }

Property Value

Overrides Control.DefaultSize

Gets the default text alignment for the button element by retrieving the value from the button element's metadata or override settings.

Declaration

protected virtual ContentAlignment DefaultTextAlignment { get; }

Property Value

Specifies the options for display of image and text primitives in the element.

Declaration

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

Property Value

Gets or sets the Font of the control. This actually the Font property of the root element. Setting to [null] resets the value and the font from the applied theme will be used.

Declaration

public override Font Font { get; set; }

Property Value

Overrides RadControl.Font

Declaration

public Image Image { get; set; }

Property Value

Gets or sets the alignment of image content on the drawing surface.

Declaration

public ContentAlignment ImageAlignment { get; set; }

Property Value

Declaration

[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public int ImageIndex { get; set; }

Property Value

Declaration

[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public string ImageKey { get; set; }

Property Value

Includes the trailing space at the end of each line. By default the boundary rectangle returned by the Overload:System.Drawing.Graphics.MeasureString method excludes the space at the end of each line. Set this flag to include that space in measurement.

Declaration

public bool MeasureTrailingSpaces { get; set; }

Property Value

Gets or sets the Svg Image.

Declaration

public RadSvgImage SvgImage { get; set; }

Property Value

Gets or sets the text associated with this item.

Declaration

[Bindable(true)]
[SettingsBindable(true)]
public override string Text { get; set; }

Property Value

Overrides RadControl.Text

Gets or sets the alignment of text content on the drawing surface.

Declaration

public ContentAlignment TextAlignment { get; set; }

Property Value

Gets or sets the position of text and image relative to each other.

Declaration

public TextImageRelation TextImageRelation { get; set; }

Property Value

Declaration

public bool TextWrap { get; set; }

Property Value

Determines whether the button can be clicked by using mnemonic characters.

Declaration

public bool UseMnemonic { get; set; }

Property Value

Determines whether this control defines the theme for the specified element. Returns true for RadButtonElement instances.

Declaration

public override bool ControlDefinesThemeForElement(RadElement element)

Parameters

Returns

Overrides RadControl.ControlDefinesThemeForElement(RadElement)

Creates an accessibility instance for the button control to support assistive technologies and screen readers.

Declaration

protected override AccessibleObject CreateAccessibilityInstance()

Returns

Overrides Control.CreateAccessibilityInstance()

Override this method to create custom main element. By default the main element is an instance of RadButtonElement.

Declaration

protected virtual RadButtonElement CreateButtonElement()

Returns

Creates the child elements for the button control, specifically the main RadButtonElement and sets up event handling.

Declaration

protected override void CreateChildItems(RadElement parent)

Parameters

Overrides RadControl.CreateChildItems(RadElement)

Initializes the root element and configures focus cues behavior to allow display when the OS supports focus indicators for buttons.

Declaration

protected override void InitializeRootElement(RootRadElement rootElement)

Parameters

Overrides RadControl.InitializeRootElement(RootRadElement)

Handles the Click event. This method is intentionally empty as click handling is delegated to the button element.

Declaration

protected override void OnClick(EventArgs e)

Parameters

Overrides RadControl.OnClick(EventArgs)

Handles the GotFocus event by calling the base implementation and setting focus to the button element.

Declaration

protected override void OnGotFocus(EventArgs e)

Parameters

Overrides RadControl.OnGotFocus(EventArgs)

Programmatically performs a button click by validating the currently active control and triggering the click event if the button is enabled.

Declaration

public virtual void PerformClick()

Processes mnemonic characters for the button, performing a click if the mnemonic character matches and the Alt key is pressed.

Declaration

protected override bool ProcessMnemonic(char charCode)

Parameters

Returns

Overrides RadControl.ProcessMnemonic(char)

Declaration

public override bool ShouldSerializeChildProperty(RadProperty property, RadObject element)

Parameters

Returns

Overrides RadControl.ShouldSerializeChildProperty(RadProperty, RadObject)

Declaration

[Browsable(false)]
public event EventHandler DoubleClick

Event Value

Declaration

[Browsable(false)]
public event MouseEventHandler MouseDoubleClick

Event Value