Click or drag to resize
RadButton Class
Represents a button control. The button control serves as a RadButtonElement Class wrapper. All logic and presentation features are implemented in a parallel hierarchy of objects. For this reason, RadButtonElement Class may be nested in any other telerik control, item, or element.
Inheritance Hierarchy
SystemObject
  SystemMarshalByRefObject
    System.ComponentModelComponent
      System.Windows.FormsControl
        System.Windows.FormsScrollableControl
          Telerik.WinControlsRadControl
            Telerik.WinControls.UIRadButtonBase
              Telerik.WinControls.UIRadButton
                Telerik.WinControls.UIMessageBoxDetailsButton
                Telerik.WinControls.UIRadRepeatButton

Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI (in Telerik.WinControls.UI.dll) Version: 2018.3.1016.40 (2018.3.1016.40)
Syntax
[DefaultPropertyAttribute("Text")]
[DefaultBindingPropertyAttribute("Text")]
[DefaultEventAttribute("Click")]
public class RadButton : RadButtonBase, IButtonControl

The RadButton type exposes the following members.

Constructors
  NameDescription
Public methodRadButton
Initializes a new instance of the RadButton class
Top
Properties
  NameDescription
Public propertyAccessibilityRequested
Gets or sets a value indicating whether the CodedUI Tests functionality is requested from external program such a Narrator.
(Inherited from RadControl.)
Public propertyAllowShowFocusCues
Indicates focus cues display, when available, based on the corresponding control type and the current UI state.
(Inherited from RadButtonBase.)
Public propertyAnalyticsName
Gets or sets the Analytics Name associated with this control. By default the Control Name property is logged. If you want to customize the information which will be logged for this control set this property to a preferred value.
(Inherited from RadControl.)
Public propertyAutoSize

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

(Inherited from RadControl.)
Public propertyBackColor
Gets or sets the BackColor of the control. This is actually the BackColor property of the root element.
(Inherited from RadControl.)
Public propertyBehavior
Gets the input behavior for the control.
(Inherited from RadControl.)
Public propertyButtonElement
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.
(Inherited from RadButtonBase.)
Public propertyCausesValidation
Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus.
(Inherited from RadControl.)
Public propertyCommandBindings (Inherited from RadControl.)
Protected propertyDefaultSize (Inherited from RadButtonBase.)
Protected propertyDefaultTextAlignment (Inherited from RadButtonBase.)
Public propertyDialogResult
Gets or sets the DialogResult for this button.
Public propertyDisplayStyle
Specifies the options for display of image and text primitives in the element.
(Inherited from RadButtonBase.)
Public propertyElementTree (Inherited from RadControl.)
Public propertyEnableAnalytics
Gets or sets a value indicating whether the Analytics functionality is enabled or disabled for this control.
(Inherited from RadControl.)
Public propertyEnableCodedUITests
Gets or sets a value indicating whether the CodedUI Tests functionality is enabled.
(Inherited from RadControl.)
Public propertyEnableGestures
Gets or sets a value indicating whether the Gestures functionality is enabled.
(Inherited from RadControl.)
Public propertyEnableKeyMap
Gets or sets whether Key Map (Office 2007 like accelerator keys map) is used for this specific control. Currently this option is implemented for the RadRibbonBar control only.
(Inherited from RadControl.)
Public propertyEnableRadAccessibilityObjects
Gets or sets a value indicating whether the RadControls Accessible custom object is enabled.
(Inherited from RadControl.)
Public propertyEnableTheming
Gets or sets value indicating whether the control is styled through theme
(Inherited from RadControl.)
Public propertyFocusable (Inherited from RadControl.)
Public propertyFocusedElement (Inherited from RadControl.)
Public propertyFont
Gets or sets the Font of the control. This is actually the Font property of the root element.
(Inherited from RadControl.)
Public propertyForeColor
Gets or sets the ForeColor of the control. This is actually the ForeColor property of the root element.
(Inherited from RadControl.)
Public propertyImage (Inherited from RadButtonBase.)
Public propertyImageAlignment
Gets or sets the alignment of image content on the drawing surface.
(Inherited from RadButtonBase.)
Public propertyImageIndex (Inherited from RadButtonBase.)
Public propertyImageKey (Inherited from RadButtonBase.)
Public propertyImageList
Gets or sets the ImageList that contains the images displayed by this control.
(Inherited from RadControl.)
Public propertyImageScalingSize
Gets or sets the image scaling size.
(Inherited from RadControl.)
Public propertyIsDesignMode (Inherited from RadControl.)
Public propertyIsDisplayed
Determines whether the control is currently displayed on the screen.
(Inherited from RadControl.)
Public propertyIsInitializing (Inherited from RadControl.)
Public propertyIsLoaded
Determines whether the control is properly loaded.
(Inherited from RadControl.)
Public propertyLayoutManager (Inherited from RadControl.)
Public propertyMaximumSize
Gets or sets the size that is the upper limit that GetPreferredSize can specify.
(Inherited from RadControl.)
Public propertyMeasureTrailingSpaces
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.
(Inherited from RadButtonBase.)
Public propertyMinimumSize
Gets or sets the size that is the lower limit that GetPreferredSize can specify
(Inherited from RadControl.)
Public propertyPadding
Gets or sets padding within the control.
(Inherited from RadControl.)
Public propertyRootElement
Gets the RootElement of the control.
(Inherited from RadControl.)
Public propertyShowItemToolTips
Gets or sets a value indicating whether ToolTips are shown for the RadItem objects contained in the RadControl.
(Inherited from RadControl.)
Public propertySite (Inherited from RadControl.)
Public propertySmallImageList
Gets or sets the SmallImageList that contains the small images which are displayed when there's not enough space.
(Inherited from RadControl.)
Public propertySmallImageScalingSize
Gets or sets the small image scaling size.
(Inherited from RadControl.)
Public propertyText
Gets or sets the text associated with this item.
(Inherited from RadButtonBase.)
Public propertyTextAlignment
Gets or sets the alignment of text content on the drawing surface.
(Inherited from RadButtonBase.)
Public propertyTextImageRelation
Gets or sets the position of text and image relative to each other.
(Inherited from RadButtonBase.)
Public propertyTextWrap (Inherited from RadButtonBase.)
Public propertyThemeClassName
Gets or sets the class name string that ThemeResolutionService will use to find the themes registered for the control.
(Inherited from RadControl.)
Public propertyThemeName
Gets or sets control's preferred theme name. Themes are stored and retrieved using APIs of ThemeResolutionService.
(Inherited from RadControl.)
Public propertyUseCompatibleTextRendering
Determines whether to use compatible text rendering engine (GDI+) or not (GDI).
(Inherited from RadControl.)
Public propertyUseMnemonic
Determines whether the button can be clicked by using mnemonic characters.
(Inherited from RadButtonBase.)
Protected propertyValidationCancel (Inherited from RadControl.)
Top
Methods
  NameDescription
Public methodBeginInit
Suspends layout during initialization.
(Inherited from RadControl.)
Public methodCallAccessibilityNotifyClients
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnGotFocus
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnKeyDown
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnKeyPress
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnKeyUp
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnLostFocus
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnClick
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnDoubleClick
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnKeyDown
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnKeyPress
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnKeyUp
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseCaptureChanged
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseDown
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseEnter
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseHover
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseLeave
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseMove
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseUp
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseWheel
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnPreviewKeyDown
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnScreenTipNeeded
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnThemeNameChanged
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnToolTipTextNeeded
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnVisibleChanged
This method is used internally!
(Inherited from RadControl.)
Protected methodCanEditElementAtDesignTime
Determines whether an element may be edited via the EditUIElements dialog at design-time.
(Inherited from RadControl.)
Public methodCanEditUIElement
Determines whether an element from this element tree may be displayed in the EditUIElements dialog.
(Inherited from RadControl.)
Protected methodConstruct (Inherited from RadControl.)
Public methodControlDefinesThemeForElement (Inherited from RadButtonBase.)
Protected methodCreateAccessibilityInstance (Inherited from RadButtonBase.)
Protected methodCreateBehavior
Creates the input behavior instance. Allows inheritors to provide custom input implementations.
(Inherited from RadControl.)
Protected methodCreateButtonElement
Override this method to create custom main element. By default the main element is an instance of RadButtonElement.
(Inherited from RadButtonBase.)
Protected methodCreateChildItems (Inherited from RadButtonBase.)
Protected methodCreateRootElement (Inherited from RadControl.)
Public methodDisableGesture
Disable firing gesture events of the specified type.
(Inherited from RadControl.)
Protected methodDispose (Inherited from RadControl.)
Public methodEnableGesture
Enable firing gesture events of the specified type.
(Inherited from RadControl.)
Public methodEndInit
Resumes layout.
(Inherited from RadControl.)
Protected methodFindPropertyInChildren (Inherited from RadControl.)
Public methodGetChildAt
Method used by control Code Dom serializer to access element in the collection of RootElement.
(Inherited from RadControl.)
Public methodGetControlDefaultSize
This method is used internally!
(Inherited from RadControl.)
Protected methodGetInputElement (Inherited from RadControl.)
Public methodGetPlainText
Strips all html tags of the text set to the control and returns only the plain text.
(Inherited from RadControl.)
Public methodGetPreferredSize (Inherited from RadControl.)
Protected methodGetRootElementDesiredSize (Inherited from RadControl.)
Protected methodInitializeRootElement (Inherited from RadButtonBase.)
Public methodInvokeLayoutCallback (Inherited from RadControl.)
Protected methodIsInputKey (Inherited from RadControl.)
Public methodLoadElementTree
Loads the element tree. While not loaded, no layout operations are allowed upon the tree. By default, the tree will be loaded when the control is displayed for the first time.
(Inherited from RadControl.)
Public methodLoadElementTree(Size)
Loads the element tree using the specified desired size.
(Inherited from RadControl.)
Public methodNotifyDefault
Protected methodOnAutoSizeChanged (Inherited from RadControl.)
Protected methodOnBackColorChanged (Inherited from RadControl.)
Protected methodOnBindingContextChanged (Inherited from RadControl.)
Protected methodOnCaptureLosing (Inherited from RadControl.)
Protected methodOnClick (Inherited from RadButtonBase.)
Protected methodOnCreateControl (Inherited from RadControl.)
Protected methodOnDoubleClick (Inherited from RadControl.)
Protected methodOnEnabledChanged (Inherited from RadControl.)
Protected methodOnFontChanged (Inherited from RadControl.)
Protected methodOnForeColorChanged (Inherited from RadControl.)
Protected methodOnGesture (Inherited from RadControl.)
Protected methodOnGotFocus (Inherited from RadButtonBase.)
Protected methodOnHandleDestroyed (Inherited from RadControl.)
Protected methodOnInvalidated (Inherited from RadControl.)
Protected methodOnKeyDown (Inherited from RadControl.)
Protected methodOnKeyPress (Inherited from RadControl.)
Protected methodOnKeyUp (Inherited from RadControl.)
Protected methodOnLayout (Inherited from RadControl.)
Protected methodOnLoad
Notifies that the control is about to be visualized.
(Inherited from RadControl.)
Protected methodOnLocationChanged (Inherited from RadControl.)
Protected methodOnLostFocus (Inherited from RadControl.)
Protected methodOnMouseCaptureChanged (Inherited from RadControl.)
Protected methodOnMouseDown (Inherited from RadControl.)
Protected methodOnMouseEnter (Inherited from RadControl.)
Protected methodOnMouseHover (Inherited from RadControl.)
Protected methodOnMouseLeave (Inherited from RadControl.)
Protected methodOnMouseMove (Inherited from RadControl.)
Protected methodOnMouseUp (Inherited from RadControl.)
Protected methodOnMouseWheel (Inherited from RadControl.)
Protected methodOnNotifyPropertyChanged(PropertyChangedEventArgs) (Inherited from RadControl.)
Protected methodOnNotifyPropertyChanged(String)
Raises the PropertyChanged event
(Inherited from RadControl.)
Protected methodOnPaddingChanged (Inherited from RadControl.)
Protected methodOnPaint (Inherited from RadControl.)
Protected methodOnPanGesture
Fires the PanGesture event.
(Inherited from RadControl.)
Protected methodOnParentChanged (Inherited from RadControl.)
Protected methodOnPressAndTapGesture
Fires the PressAndTapGesture event.
(Inherited from RadControl.)
Protected methodOnPreviewKeyDown (Inherited from RadControl.)
Protected methodOnRightToLeftChanged (Inherited from RadControl.)
Protected methodOnRotateGesture
Fires the RotateGesture event.
(Inherited from RadControl.)
Protected methodOnScreenTipNeeded (Inherited from RadControl.)
Protected methodOnThemeChanged (Inherited from RadControl.)
Protected methodOnThemeNameChanged (Inherited from RadControl.)
Protected methodOnToolTipTextNeeded (Inherited from RadControl.)
Protected methodOnTwoFingerTapGesture
Fires the TwoFingerTapGesture event.
(Inherited from RadControl.)
Protected methodOnZoomGesture
Fires the ZoomGesture event.
(Inherited from RadControl.)
Public methodPerformClick (Overrides RadButtonBasePerformClick.)
Protected methodProcessAutoSizeChanged (Inherited from RadControl.)
Protected methodProcessCaptureChangeRequested
Processes a capture request from the specified element.
(Inherited from RadControl.)
Protected methodProcessCmdKey (Overrides ControlProcessCmdKey(Message, Keys).)
Protected methodProcessCodedUIMessage (Overrides RadControlProcessCodedUIMessage(IPCMessage).)
Protected methodProcessFocusRequested
Processes a focus request from the specified element.
(Inherited from RadControl.)
Protected methodProcessGesture (Inherited from RadControl.)
Protected methodProcessMnemonic (Inherited from RadButtonBase.)
Public methodRefresh (Inherited from RadControl.)
Public methodRegisterHostedControl (Inherited from RadControl.)
Protected methodResetBackColorThemeOverrides (Overrides RadControlResetBackColorThemeOverrides.)
Protected methodResetForeColorThemeOverrides (Overrides RadControlResetForeColorThemeOverrides.)
Public methodResolveStyleGroupForElement
Replaces the default style group for specific element.
(Inherited from RadControl.)
Public methodResumeUpdate (Inherited from RadControl.)
Public methodResumeUpdate(Boolean) (Inherited from RadControl.)
Protected methodScaleControl (Inherited from RadControl.)
Protected methodSetBackColorThemeOverrides (Overrides RadControlSetBackColorThemeOverrides.)
Protected methodSetBoundsCore (Inherited from RadControl.)
Protected methodSetForeColorThemeOverrides (Overrides RadControlSetForeColorThemeOverrides.)
Public methodSetIsInitializing
This method is used internally!
(Inherited from RadControl.)
Public methodShouldSerializeBackColor
Determines whether the BackColor property should be serialized.
(Inherited from RadControl.)
Public methodShouldSerializeFont
Determines whether the ForeColor property should be serialized.
(Inherited from RadControl.)
Public methodShouldSerializeForeColor
Determines whether the ForeColor property should be serialized.
(Inherited from RadControl.)
Protected methodShouldSerializeProperty
Determines whether the specified RadProperty should be serialized.
(Inherited from RadControl.)
Public methodSuspendUpdate (Inherited from RadControl.)
Public methodUnregisterHostedControl (Inherited from RadControl.)
Protected methodWndProc (Inherited from RadControl.)
Top
Events
  NameDescription
Public eventDoubleClick (Inherited from RadButtonBase.)
Public eventElementInvalidated (Inherited from RadControl.)
Public eventInitialized
Fires when the control is initialized.
(Inherited from RadControl.)
Public eventMouseDoubleClick (Inherited from RadButtonBase.)
Public eventPanGesture
Occurs when a pan gesture was sent by a touch input device.
(Inherited from RadControl.)
Public eventPressAndTapGesture
Occurs when a press-and-tap gesture was sent by a touch input device.
(Inherited from RadControl.)
Public eventPropertyChanged
Occurs when a property of an object changes change. Calling the event is developer's responsibility.
(Inherited from RadControl.)
Public eventRotateGesture
Occurs when a rotate gesture was sent by a touch input device.
(Inherited from RadControl.)
Public eventScreenTipNeeded
Occurs prior the ScreenTip of a RadItem instance inside the RadControl is displayed.
(Inherited from RadControl.)
Public eventThemeNameChanged
Fires when the theme name is changed.
(Inherited from RadControl.)
Public eventToolTipTextNeeded
Occurs when a RadItem instance inside the RadControl requires ToolTip text.
(Inherited from RadControl.)
Public eventTwoFingerTapGesture
Occurs when a two-finger-tap gesture was sent by a touch input device.
(Inherited from RadControl.)
Public eventZoomGesture
Occurs when a zoom gesture was sent by a touch input device.
(Inherited from RadControl.)
Top
Fields
  NameDescription
Protected fieldinvalidResizeRect (Inherited from RadControl.)
Protected fieldisAccessibilityRequested (Inherited from RadControl.)
Protected fieldisDisposing2 (Inherited from RadControl.)
Protected fieldisResizing2 (Inherited from RadControl.)
Top
See Also