Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

BadgeDefaultProperties.StretchImage Property

Gets or sets whether or not this Badge should stretch its image to fit the text block. This property is obsolete. Use the BadgeDefaultProperties.ImageOptions.StretchImage property instead.

Namespace: DevExpress.Utils.VisualEffects

Assembly: DevExpress.Utils.v24.2.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.ImageOptions.Image offers. When this happens, you can set the ImageOptions.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.ImageOptions.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