RibbonProperties.ScaleIcons Property

Gets or sets whether icons for bar items are automatically stretched to match the current DPI settings of the user’s monitor.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v19.1.dll

Declaration

C#

[DefaultValue(true)]
public bool ScaleIcons { get; set; }

VB.NET

<DefaultValue(True)>
Public Property ScaleIcons As Boolean

Property Value

Type	Default	Description
Boolean	**true**	true if bar item icons are scaled to match the current DPI settings; otherwise, false

Remarks

Increasing the DPI for your monitor enlarges the size of screen items. Use the ScaleIcons property to specify whether bar item icons should match the DPI settings of the user’s monitor. If this property is set to true, the bar item icons are scaled up if the DPI is increased and vice versa. Otherwise, the icons will remain a constant size, in terms of pixels.

Note that you can also provide large images for bar items. This can be accomplished via the BarItem.LargeGlyph and BarItem.LargeImageIndex properties.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ScaleIcons property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-show-large-images-48x48-64x64-on-a-button-within-ribboncontrol-e3726/CS/CustomRibbonControl/CustomRibbonViewInfo.cs#L33

int imSize = 16 * iScaleCoeff;
if (Manager.GetController().PropertiesRibbon.ScaleIcons)
    imSize = (int)(imSize * (Manager as CustomRibbonBarManager).DrawParameters.RibbonImageScaleFactor);

VB.NET

how-to-show-large-images-48x48-64x64-on-a-button-within-ribboncontrol-e3726/VB/CustomRibbonControl/CustomRibbonViewInfo.vb#L31

Dim imSize As Integer = 16 * iScaleCoeff
If Manager.GetController().PropertiesRibbon.ScaleIcons Then
    imSize = CInt((imSize * (TryCast(Manager, CustomRibbonBarManager)).DrawParameters.RibbonImageScaleFactor))