This documentation is archived and is not being maintained.

ToolStripItem.DisplayStyle Property

Gets or sets whether text and images are displayed on a ToolStripItem.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public virtual ToolStripItemDisplayStyle DisplayStyle { get; set; }

Property Value

Type: System.Windows.Forms.ToolStripItemDisplayStyle
One of the ToolStripItemDisplayStyle values. The default is ImageAndText .

Use DisplayStyle to set the values of an item's Text and Image properties while displaying only what you want. This is typically used to change only the display style when showing the same item in a different context.

The following code example demonstrates the Image, ImageAlign, DisplayStyle , and TextAlign properties for a ToolStripButton. This example is part of a larger example available in the ToolStripButton class overview.


			this.toolStripButton1.Image = Bitmap.FromFile("c:\\NewItem.bmp");
			this.toolStripButton1.DisplayStyle = System.Windows.Forms.ToolStripItemDisplayStyle.ImageAndText;
			this.toolStripButton1.ImageAlign = System.Drawing.ContentAlignment.MiddleLeft;
			this.toolStripButton1.Name = "toolStripButton1";
			this.toolStripButton1.Text = "&New";
			this.toolStripButton1.TextAlign = System.Drawing.ContentAlignment.MiddleRight;
			this.toolStripButton1.Click += new System.EventHandler(this.toolStripButton1_Click);


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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