NavBarControl.ScaleImages Property

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

Namespace: DevExpress.XtraNavBar

Assembly: DevExpress.XtraNavBar.v21.2.dll

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

Declaration

C#

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

VB.NET

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

Property Value

Type	Default	Description
DefaultBoolean	Default	True, if icons are scaled to match the current DPI settings; otherwise, Default or False.

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 icons should match the DPI settings of the user’s monitor. If this property is set to True, the button icons are scaled up if the DPI is increased and vice versa. Otherwise, the icons will remain a constant size, in terms of pixels.