RibbonControl.Image Property
Gets or sets the custom background image for this RibbonControl.
Namespace: DevExpress.XtraBars.Ribbon
Assembly: DevExpress.XtraBars.v24.1.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
[Browsable(false)]
[DefaultValue(null)]
[DXCategory("Appearance")]
[EditorBrowsable(EditorBrowsableState.Never)]
public Image Image { get; set; }
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.
See Also