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.1.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
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:
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:
