BadgeDefaultProperties.ImageStretchMargins Property
Gets or sets the image region that can be stretched.
Namespace: DevExpress.Utils.VisualEffects
Assembly: DevExpress.Utils.v23.2.dll
NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core
Declaration
[Browsable(false)]
[EditorBrowsable(EditorBrowsableState.Never)]
public Padding? ImageStretchMargins { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| Nullable<Padding> | *null* | A Padding structure that is the image stretch region. |
Remarks
When the BadgeDefaultProperties.StretchImage property is set to DefaultBoolean.True, the badge BadgeDefaultProperties.Image is automatically stretched to fit the badge BadgeDefaultProperties.Text. If the image has a complex shape (e.g., rounded corners), stretching these parts may cause them look blurry. For best visual results, you can use the ImageStretchMargins property to set left, top, right and bottom stretch margins for the image. After you do so, only the central image region will be able to stretch. Parts of the image that belong to the margins’ outer border will remain untouched.
For instance, your badge has an arrow image. The figure below illustrates custom stretch margins that will force this arrow to stretch only its tail, while its head will be displayed as is.
The difference between this arrow, stretched with and without using stretch margins, is shown below.
The ImageStretchMargins property has priority over the BadgeProperties.ImageStretchMargins property that affects all badges within this AdornerUIManager. If the ImageStretchMargins property is not set, individual badges inherit this global setting.
Note
Default badge images (circles) do not require setting custom stretch margins. For these images, stretch margins are set automatically.