BackgroundImageLayout Property
.NET Framework Class Library
Control..::.BackgroundImageLayout Property

Gets or sets the background image layout as defined in the ImageLayout enumeration.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
Visual Basic (Declaration)
Public Overridable Property BackgroundImageLayout As ImageLayout
Visual Basic (Usage)
Dim instance As Control
Dim value As ImageLayout

value = instance.BackgroundImageLayout

instance.BackgroundImageLayout = value
C#
public virtual ImageLayout BackgroundImageLayout { get; set; }
Visual C++
public:
virtual property ImageLayout BackgroundImageLayout {
    ImageLayout get ();
    void set (ImageLayout value);
}
JScript
public function get BackgroundImageLayout () : ImageLayout
public function set BackgroundImageLayout (value : ImageLayout)

Property Value

Type: System.Windows.Forms..::.ImageLayout
One of the values of ImageLayout (Center , None, Stretch, Tile, or Zoom). Tile is the default value.
ExceptionCondition
InvalidEnumArgumentException

The specified enumeration value does not exist.

Use the BackgroundImageLayout property to specify the position and behavior of an image you have placed onto a control. BackgroundImageLayout takes effect only if the BackgroundImage property is set.

You can increase performance for large images if you set BackgroundImageLayout to something other than Tile.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Processing
Page view tracker