Skip to main content

BadgeDefaultProperties.StretchImage Property

Gets or sets whether or not this Badge should stretch its image to fit the text block.

Namespace: DevExpress.Utils.VisualEffects

Assembly: DevExpress.Utils.v24.1.dll

NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core

Declaration

[Browsable(false)]
[EditorBrowsable(EditorBrowsableState.Never)]
public DefaultBoolean StretchImage { get; set; }

Property Value

Type Default Description
DefaultBoolean Default

A DefaultBoolean enumerator value that specifies whether or not this Badge should stretch its image to fit the text block.

Available values:

Name Description Return 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

Text blocks, whose sizes are calculated as BadgeDefaultProperties.Text bounds plus the BadgeDefaultProperties.TextMargin, can require more space than the badge BadgeDefaultProperties.Image offers. When this happens, you can set the StretchImage property to DefaultBoolean.True to stretch this image vertically and/or horizontally until it fits the badge text. In order to prevent badge images from blurring, you can use the BadgeDefaultProperties.ImageStretchMargins property to set image regions that are never stretched.

If the StretchImage property is not set, the badge acts according to the common behavior, specified by the BadgeProperties.StretchImage property.

See Also