ClassRadImageButtonElement
Represents an image button.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadImageButtonElement : RadButtonElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IButtonControl, IImageElement
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRadButtonItemRadButtonElementRadImageButtonElement
Derived Classes:
Implements:
Inherited Members
Constructors
RadImageButtonElement()
Declaration
public RadImageButtonElement()
Fields
ImageClickedProperty
Declaration
public static RadProperty ImageClickedProperty
Field Value
ImageHoveredProperty
Declaration
public static RadProperty ImageHoveredProperty
Field Value
ImageIndexClickedProperty
Declaration
public static RadProperty ImageIndexClickedProperty
Field Value
ImageIndexHoveredProperty
Declaration
public static RadProperty ImageIndexHoveredProperty
Field Value
ImageKeyClickedProperty
Declaration
public static RadProperty ImageKeyClickedProperty
Field Value
ImageKeyHoveredProperty
Declaration
public static RadProperty ImageKeyHoveredProperty
Field Value
Properties
DisplayStyle
Specifies the options for display of image and text primitives in the element.
Declaration
public override DisplayStyle DisplayStyle { get; set; }
Property Value
Overrides
ImageClicked
Gets or sets the image that is displayed on a button element when it is clicked.
Declaration
[TypeConverter(typeof(ImageTypeConverter))]
public virtual Image ImageClicked { get; set; }
Property Value
ImageHovered
Gets or sets the image that is displayed on a button element when it is hovered.
Declaration
[TypeConverter(typeof(ImageTypeConverter))]
public virtual Image ImageHovered { get; set; }
Property Value
ImageIndexClicked
Gets or sets the image list index value of the image displayed on the button control when it is clicked.
Declaration
[RelatedImageList("ElementTree.Control.ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual int ImageIndexClicked { get; set; }
Property Value
ImageIndexHovered
Gets or sets the image list index value of the image displayed on the button control when it is hovered.
Declaration
[RelatedImageList("ElementTree.Control.ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual int ImageIndexHovered { get; set; }
Property Value
ImageKeyClicked
Gets or sets the key accessor for the image for clicked state in the ImageList.
Declaration
[RelatedImageList("ElementTree.Control.ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual string ImageKeyClicked { get; set; }
Property Value
ImageKeyHovered
Gets or sets the key accessor for the image for hovered state in the ImageList.
Declaration
[RelatedImageList("ElementTree.Control.ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual string ImageKeyHovered { get; set; }
Property Value
Methods
CreateChildElements()
Creates the child elements that compose the button structure including fill, border, text, image, layout panel, and focus primitives. This method establishes the visual hierarchy and property bindings between the child elements.
Declaration
protected override void CreateChildElements()
Overrides
InitializeFields()
Initializes the fields of the RadButtonElement.
Declaration
protected override void InitializeFields()
Overrides
OnMouseLeave(EventArgs)
Handles the mouse leave event by releasing the pressed state and managing press-on-return behavior.
OnPropertyChanged(RadPropertyChangedEventArgs)
Handles property changes, specifically releasing the pressed state when the button is disabled.
Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters
e
The RadPropertyChangedEventArgs containing event data.
Overrides