ToolStripItem.DisplayStyle Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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
Available since 2.0
Return to top