Back to Devexpress

BaseGallery.ScaleImages Property

windowsforms-devexpress-dot-xtrabars-dot-ribbon-dot-gallery-dot-basegallery-48c8ebae.md

latest2.5 KB
Original Source

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.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

csharp
[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Behavior")]
public DefaultBoolean ScaleImages { get; set; }
vb
<DXCategory("Behavior")>
<DefaultValue(DefaultBoolean.Default)>
Public Property ScaleImages As DefaultBoolean

Property Value

TypeDefaultDescription
DefaultBooleanDefault

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:

NameDescriptionReturn Value
True

The value is true.

|

0

| | False |

The value is false.

|

1

| | Default |

The value is specified by a global option or a higher-level object.

|

2

|

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.

See Also

ScaleGalleryItems

Graphics Performance and High DPI

BaseGallery Class

BaseGallery Members

DevExpress.XtraBars.Ribbon.Gallery Namespace