RibbonControl.Image Property

Gets or sets the custom background image for this RibbonControl.

Namespace : DevExpress.XtraBars.Ribbon

Assembly : DevExpress.XtraBars.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

C#
VB.NET

csharp

[Browsable(false)]
[DefaultValue(null)]
[DXCategory("Appearance")]
[EditorBrowsable(EditorBrowsableState.Never)]
public Image Image { get; set; }

<Browsable(False)>
<EditorBrowsable(EditorBrowsableState.Never)>
<DXCategory("Appearance")>
<DefaultValue(Nothing)>
Public Property Image As Image

Property Value

Type	Default	Description
Image	null

A Image object that is the custom background image for this RibbonControl.

Remarks

The Image property specifies the image drawn at the RibbonControl page header region and form title bar (in case the RibbonControl is embedded in a Ribbon Form).

An image assigned to the Image property is drawn as is, without scaling. The only layout option available for a background image is the RibbonControl.ImageAlignment property, which takes the following values.

HorzAlignment.Default or HorzAlignment.Near - the background image and the application button align to opposite Ribbon sides. When the right-to-left layout is disabled, the image will appear on the right Ribbon side; otherwise, on the left side.
HorzAlignment.Far - the background image and the application button.
HorzAlignment.Center - the background image is aligned to the middle of its parent Ribbon.