BaseGallery.ScaleImages Property

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

Namespace: DevExpress.XtraBars.Ribbon.Gallery

Assembly: DevExpress.XtraBars.v21.2.dll

NuGet Packages: DevExpress.Win.Design, DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Behavior")]
public DefaultBoolean ScaleImages { get; set; }

VB.NET

<DXCategory("Behavior")>
<DefaultValue(DefaultBoolean.Default)>
Public Property ScaleImages As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	True, if gallery items are scaled to match the current DPI settings; otherwise, Default or False. For galleries within the RibbonControl, Default uses the RibbonProperties.ScaleGalleryItems setting.

Available values:

Name	Description
True	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

Remarks

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