ToolStripItem.BackgroundImageLayout Property
.NET Framework 4.5
Gets or sets the background image layout used for the ToolStripItem.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Property Value
Type: System.Windows.Forms.ImageLayoutOne of the ImageLayout values. The default value is Tile.
The following code example demonstrates how to set the BackgroundImageLayout property. This code example is part of a larger example provided for the ToolStripItem class.
// This utility method creates a RolloverItem // and adds it to a ToolStrip control. private RolloverItem CreateRolloverItem( ToolStrip owningToolStrip, string txt, Font f, string imgKey, TextImageRelation tir, string backImgKey) { RolloverItem item = new RolloverItem(); item.Alignment = ToolStripItemAlignment.Left; item.AllowDrop = false; item.AutoSize = true; item.BackgroundImage = owningToolStrip.ImageList.Images[backImgKey]; item.BackgroundImageLayout = ImageLayout.Center; item.DisplayStyle = ToolStripItemDisplayStyle.ImageAndText; item.DoubleClickEnabled = true; item.Enabled = true; item.Font = f; // These assignments are equivalent. Each assigns an // image from the owning toolstrip's image list. item.ImageKey = imgKey; //item.Image = owningToolStrip.ImageList.Images[infoIconKey]; //item.ImageIndex = owningToolStrip.ImageList.Images.IndexOfKey(infoIconKey); item.ImageScaling = ToolStripItemImageScaling.None; item.Owner = owningToolStrip; item.Padding = new Padding(2); item.Text = txt; item.TextAlign = ContentAlignment.MiddleLeft; item.TextDirection = ToolStripTextDirection.Horizontal; item.TextImageRelation = tir; return item; }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.