ToolStripItem.ImageAlign Property

Gets or sets the alignment of the image on a ToolStripItem.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

[LocalizableAttribute(true)] 
public ContentAlignment ImageAlign { get; set; }
/** @property */
public ContentAlignment get_ImageAlign ()

/** @property */
public void set_ImageAlign (ContentAlignment value)

public function get ImageAlign () : ContentAlignment

public function set ImageAlign (value : ContentAlignment)

Not applicable.

Property Value

One of the System.Drawing.ContentAlignment values. The default is MiddleLeft.

Exception typeCondition

InvalidEnumArgumentException

The value assigned is not one of the ContentAlignment values.

Use the ImageAlign property to get or set image alignment on a ToolStripItem. Use the TextAlign property to get or set text alignment on a ToolStripItem.

The Image, ImageAlign, ImageIndex, ImageKey, and ImageScaling properties pertain to various aspects of image handling. Use images in ToolStrip controls by setting these properties directly or by setting the run-time–only ImageList property.

Image scaling is determined by the interaction of properties in both ToolStrip and ToolStripItem, as follows:

  • ImageScalingSize is the scale of the final image as determined by the combination of the image's ImageScaling setting and the container's AutoSize setting.

    • If AutoSize is true (the default) and ToolStripItemImageScaling is SizeToFit, no image scaling occurs, and the ToolStrip size is that of the largest item, or a prescribed minimum size.

    • If AutoSize is false and ToolStripItemImageScaling is None, neither image nor ToolStrip scaling occurs.

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);

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

ADD
Show: