ToolBar.ToolBarButtonCollection.Item[] Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece un ToolBarButton dentro de la colección.

Sobrecargas

Item[String]	Obtiene un control ToolBarButton con la clave especificada de la colección.
Item[Int32]	Obtiene o establece el botón de barra de herramientas en la ubicación indizada especificada en la colección de botones de barra de herramientas.

Item[String]

Obtiene un control ToolBarButton con la clave especificada de la colección.

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

key

String

Nombre del objeto ToolBarButton que se va a recuperar.

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.

Item[Int32]

Obtiene o establece el botón de barra de herramientas en la ubicación indizada especificada en la colección de botones de barra de herramientas.

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

index

Int32

Ubicación indizada del control ToolBarButton en la colección.

Valor de propiedad

ToolBarButton

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

Excepciones

ArgumentNullException

El valor index es null.

ArgumentOutOfRangeException

El valor de index es menor que cero.

o bien El valor de indexes mayor que el número de botones de la colección, y la colección de botones no es null.

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