BackgroundImageLayout Property
Collapse the table of content
Expand the table of content

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

public virtual ImageLayout BackgroundImageLayout { get; set; }
/** @property */
public ImageLayout get_BackgroundImageLayout ()

/** @property */
public void set_BackgroundImageLayout (ImageLayout value)

public function get BackgroundImageLayout () : ImageLayout

public function set BackgroundImageLayout (value : ImageLayout)

Not applicable.

Property Value

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

Exception typeCondition


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 98, Windows Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

© 2015 Microsoft