Control Properties


.NET Framework Class Library
Control.BackgroundImageLayout Property

Note: This property is new in the .NET Framework version 2.0.

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)

Syntax

Visual Basic (Declaration)
<LocalizableAttribute(True)> _
Public Overridable Property BackgroundImageLayout As ImageLayout
Visual Basic (Usage)
Dim instance As Control
Dim value As ImageLayout

value = instance.BackgroundImageLayout

instance.BackgroundImageLayout = value
C#
[LocalizableAttribute(true)] 
public virtual ImageLayout BackgroundImageLayout { get; set; }
C++
[LocalizableAttribute(true)] 
public:
virtual property ImageLayout BackgroundImageLayout {
    ImageLayout get ();
    void set (ImageLayout value);
}
J#
/** @property */
public ImageLayout get_BackgroundImageLayout ()

/** @property */
public void set_BackgroundImageLayout (ImageLayout value)
JScript
public function get BackgroundImageLayout () : ImageLayout

public function set BackgroundImageLayout (value : ImageLayout)

Property Value

One of the values of ImageLayout (Center , None, Stretch, Tile, or Zoom). Tile is the default value.
Exceptions

Exception typeCondition

InvalidEnumArgumentException

The specified enumeration value does not exist.

Remarks

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.

Platforms

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

Version Information

.NET Framework

Supported in: 2.0
See Also

Tags :


Page view tracker