ToolBar.ToolBarButtonCollection.Item[] Propiedad

public:
 virtual property System::Windows::Forms::ToolBarButton ^ default[System::String ^] { System::Windows::Forms::ToolBarButton ^ get(System::String ^ key); };

public virtual System.Windows.Forms.ToolBarButton this[string key] { get; }

member this.Item(string) : System.Windows.Forms.ToolBarButton

Default Public Overridable ReadOnly Property Item(key As String) As ToolBarButton

Parámetros

Valor de propiedad

ToolBarButton

ToolBarButton cuya propiedad Name coincide con la clave especificada.

Comentarios

La Name propiedad corresponde a la clave de en ToolBarButton .ToolBar.ToolBarButtonCollection

La comparación de claves no distingue mayúsculas de minúsculas. Si el key parámetro es null o una cadena vacía, Item[] devuelve null.

public:
 virtual property System::Windows::Forms::ToolBarButton ^ default[int] { System::Windows::Forms::ToolBarButton ^ get(int index); void set(int index, System::Windows::Forms::ToolBarButton ^ value); };

public virtual System.Windows.Forms.ToolBarButton this[int index] { get; set; }

member this.Item(int) : System.Windows.Forms.ToolBarButton with get, set

Default Public Overridable Property Item(index As Integer) As ToolBarButton

Parámetros

Valor de propiedad

ToolBarButton

ToolBarButton que representa el botón de barra de herramientas en la ubicación indizada especificada.

Excepciones

Ejemplos

En el ejemplo de código siguiente se reemplaza el último botón de la barra de herramientas de una barra de herramientas. Este código requiere que se haya creado un ToolBar y al menos uno ToolBarButton . En el ejemplo se obtiene el número de botones de la barra de herramientas y se reemplaza el último botón por uno recién creado. El index valor del botón de la barra de herramientas que se va a reemplazar se establece en la Count propiedad , menos uno, ya que la ToolBarButton colección es un índice de base cero.

void ReplaceMyToolBarButton()
{
   int btns;
   btns = toolBar1->Buttons->Count;
   ToolBarButton^ toolBarButton1 = gcnew ToolBarButton;
   toolBarButton1->Text = "myButton";
   
   // Replace the last ToolBarButton in the collection.
   toolBar1->Buttons[ btns - 1 ] = toolBarButton1;
}

public void ReplaceMyToolBarButton()
 {
    int btns;
    btns = toolBar1.Buttons.Count;
    ToolBarButton toolBarButton1 = new ToolBarButton();
    toolBarButton1.Text = "myButton";
 
    // Replace the last ToolBarButton in the collection.
    toolBar1.Buttons[btns - 1] = toolBarButton1;
 }

Public Sub ReplaceMyToolBarButton()
    Dim btns As Integer
    btns = toolBar1.Buttons.Count
    Dim toolBarButton1 As New ToolBarButton()
    toolBarButton1.Text = "myButton"
    
    ' Replace the last ToolBarButton in the collection.
    toolBar1.Buttons(btns - 1) = toolBarButton1
End Sub

Comentarios

Para asignar ToolBarButton controles a una ubicación específica, o para recuperarlos de ToolBar.ToolBarButtonCollection, puede hacer referencia al objeto de colección con un valor de índice específico. El valor de índice de ToolBar.ToolBarButtonCollection es un índice de base cero.

Consulte también

• Count
• ToolBarButton