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

BaseView.BackgroundImageStretchMargins Property

Gets or sets stretching margins for a DocumentManager‘s background image in a View.

Namespace: DevExpress.XtraBars.Docking2010.Views

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

[DefaultValue(null)]
public Padding? BackgroundImageStretchMargins { get; set; }

#Property Value

Type Default Description
Nullable<Padding> null

A nullable System.Windows.Forms.Padding structure specifying stretching margins for a DocumentManager‘s background image.

#Remarks

You can set an image as a DocumentManager‘s background via the BaseView.BackgroundImage property. The image’s allocation can be specified via the BaseView.BackgroundImageLayoutMode property.

The BackgroundImageStretchMargins property specifies an image’s stretching margins. If the BackgroundImageStretchMargins property is not null, a background image is stretched, ignoring the BaseView.BackgroundImageLayoutMode property value. Image marginal areas specified by the BackgroundImageStretchMargins property are fixed (always shown in their original size), while the central image area inside these margins is stretched. The following scheme demonstrates these areas:

Stretch Margins Scheme

Look at the following code that applies an image as a DocumentManager‘s background and customizes its appearance.

documentManager1.View.BackgroundImage = Image.FromFile("D:\\Images\\dxWall.png");
documentManager1.View.BackgroundImageStretchMargins = new Padding(5);

The original image has a white border width of 5 pixels. These borders will not grow or shrink when resizing the DocumentManager due to the BackgroundImageStretchMargins property set to Padding(5). The central area inside these borders stretches to fill all the remaining free space. The figure below shows how the background image stretches for different sizes of the parent DocumentManager:

BackgroundImageStretchMargins example

See Also