ToolStripItem.Alignment Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece un valor que indica si el elemento se alinea hacia el principio o hacia al final del 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

Valor de propiedad

ToolStripItemAlignment

Uno de los valores de ToolStripItemAlignment. De manera predeterminada, es Left.

Excepciones

InvalidEnumArgumentException

El valor asignado no es uno de los valores de ToolStripItemAlignment.

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer la Alignment propiedad . Este ejemplo de código es parte de un ejemplo mayor proporcionado para la clase ToolStripItem.

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

Comentarios

En un diseño de desbordamiento de pila, use la Alignment propiedad junto con la ToolStripItem.RightToLeft propiedad para controlar el extremo al que se alinean los elementos en un ToolStrip, o para determinar el final al que ya están alineados.

Si la ToolStripItem.RightToLeft propiedad es No, los elementos marcados como Left están alineados con el lado izquierdo de los ToolStrip elementos y marcados Right se alinean a la derecha.

Si la ToolStripItem.RightToLeft propiedad es Yes, los elementos marcados como Left se alinean al lado derecho de los ToolStrip elementos y marcados Right se alinean a la izquierda.

Nota

En los diseños de flujo y tabla, se omite la Alignment propiedad . En el diseño de flujo o tabla, use la Dock propiedad o Anchor para alinear los elementos dentro de la celda de fila o tabla.