ToolStripItem.Alignment Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob das Element am Anfang oder am Ende des ToolStrip ausgerichtet wird, oder legt diesen Wert fest.

public:
 property System::Windows::Forms::ToolStripItemAlignment Alignment { System::Windows::Forms::ToolStripItemAlignment get(); void set(System::Windows::Forms::ToolStripItemAlignment value); };

public System.Windows.Forms.ToolStripItemAlignment Alignment { get; set; }

member this.Alignment : System.Windows.Forms.ToolStripItemAlignment with get, set

Public Property Alignment As ToolStripItemAlignment

Eigenschaftswert

ToolStripItemAlignment

Einer der ToolStripItemAlignment-Werte. Der Standardwert ist Left.

Ausnahmen

InvalidEnumArgumentException

Der zugewiesene Wert ist keiner der ToolStripItemAlignment-Werte.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Alignment Eigenschaft festgelegt wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ToolStripItem Klasse bereitgestellt wird.

// 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;
}

' This utility method creates a RolloverItem 
' and adds it to a ToolStrip control.
 Private Function CreateRolloverItem( _
 ByVal owningToolStrip As ToolStrip, _
 ByVal txt As String, _
 ByVal f As Font, _
 ByVal imgKey As String, _
 ByVal tir As TextImageRelation, _
 ByVal backImgKey As String) As RolloverItem

     Dim item As 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
 End Function

Hinweise

Verwenden Sie in einem Stapelüberlauflayout die Eigenschaft zusammen mit der Alignment ToolStripItem.RightToLeft Eigenschaft, um das Ende zu steuern, an dem Elemente in einem ToolStripElement ausgerichtet sind, oder um das Ende zu bestimmen, an das sie bereits ausgerichtet sind.

Wenn die ToolStripItem.RightToLeft Eigenschaft lautet No, werden Elemente, die als Left "ausgerichtet" auf der linken Seite der ToolStrip markierten Right Elemente markiert sind, rechts ausgerichtet.

Wenn die ToolStripItem.RightToLeft Eigenschaft lautet Yes, werden Elemente, die als Left "ausgerichtet" auf der rechten Seite der ToolStrip markierten Right Elemente markiert sind, an der linken Seite ausgerichtet.

Hinweis

In Fluss- und Tabellenlayouts wird die Alignment Eigenschaft ignoriert. Verwenden Sie im Fluss- oder Tabellenlayout die Dock Eigenschaft Anchor , um die Elemente in der Zeile oder Tabellenzelle auszurichten.