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. |
|
False | The value is false. |
|
Default | The value is specified by a global option or a higher-level object. |
|
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.