ToolStripItem.Alignment Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit une valeur indiquant si l'élément est aligné au début ou à la fin de ToolStrip.

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

Valeur de propriété

ToolStripItemAlignment

Une des valeurs de l'objet ToolStripItemAlignment. La valeur par défaut est Left.

Exceptions

InvalidEnumArgumentException

La valeur assignée ne fait pas partie des valeurs ToolStripItemAlignment.

Exemples

L’exemple de code suivant montre comment définir la Alignment propriété . Cet exemple de code fait partie d’un exemple plus grand fourni pour la ToolStripItem classe .

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

Remarques

Dans une disposition de dépassement de capacité de pile, utilisez la Alignment propriété ainsi que la ToolStripItem.RightToLeft propriété pour contrôler la fin à laquelle les éléments sont alignés dans un ToolStrip, ou pour déterminer la fin à laquelle ils sont déjà alignés.

Si la ToolStripItem.RightToLeft propriété est No, les éléments marqués comme Left étant alignés sur le côté gauche du ToolStrip et les éléments marqués Right sont alignés à droite.

Si la ToolStripItem.RightToLeft propriété est Yes, les éléments marqués comme Left sont alignés sur le côté droit du ToolStrip et les éléments marqués Right sont alignés à gauche.

Notes

Dans les dispositions de flux et de table, la Alignment propriété est ignorée. Dans la disposition de flux ou de tableau, utilisez la Dock propriété ou Anchor pour aligner les éléments dans la ligne ou la cellule de tableau.