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, IImageElementInheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRadButtonItemRadButtonElementRadImageButtonElement...
Derived Classes:
Implements:
Inherited Members
Constructors
public RadImageButtonElement()Fields
Identifies the ImageClicked dependency property.
public static RadProperty ImageClickedPropertyIdentifies the ImageHovered dependency property.
public static RadProperty ImageHoveredPropertyIdentifies the ImageIndexClicked dependency property.
public static RadProperty ImageIndexClickedPropertyIdentifies the ImageIndexHovered dependency property.
public static RadProperty ImageIndexHoveredPropertyIdentifies the ImageKeyClicked dependency property.
public static RadProperty ImageKeyClickedPropertyIdentifies the ImageKeyHovered dependency property.
public static RadProperty ImageKeyHoveredPropertyProperties
Gets or sets the display style of this button element. Defaults to Image since this element is intended to show only images.
public override DisplayStyle DisplayStyle { get; set; }Overrides:
Gets or sets the image that is displayed on a button element when it is clicked.
[TypeConverter(typeof(ImageTypeConverter))]
public virtual Image ImageClicked { get; set; }Gets or sets the image that is displayed on a button element when it is hovered.
[TypeConverter(typeof(ImageTypeConverter))]
public virtual Image ImageHovered { get; set; }Gets or sets the image list index value of the image displayed on the button control when it is clicked.
[RelatedImageList("ElementTree.Control.ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.3.1014.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual int ImageIndexClicked { get; set; }Gets or sets the image list index value of the image displayed on the button control when it is hovered.
[RelatedImageList("ElementTree.Control.ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.3.1014.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual int ImageIndexHovered { get; set; }Gets or sets the key accessor for the image for clicked state in the ImageList.
[RelatedImageList("ElementTree.Control.ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.3.1014.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual string ImageKeyClicked { get; set; }Gets or sets the key accessor for the image for hovered state in the ImageList.
[RelatedImageList("ElementTree.Control.ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.3.1014.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual string ImageKeyHovered { get; set; }Methods
Creates the child primitives, making the button fill transparent so only the image is visible.
protected override void CreateChildElements()Overrides:
Initializes default field values, configuring the element to display only its image, centered.
protected override void InitializeFields()Overrides:
Handles property changes, swapping in the hovered or clicked image/index when the mouse-over, mouse-down, or Image property changes.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)A RadPropertyChangedEventArgs that contains the event data.
Overrides: