ToolBar.ToolBarButtonCollection.Item[] Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

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

Sobrecargas

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

Item[String]

Source:

ToolBar.ToolBarButtonCollection.cs

Obtiene un ToolBarButton objeto 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

cuya ToolBarButtonName propiedad 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]

Source:

ToolBar.ToolBarButtonCollection.cs

Obtiene o establece el botón de la barra de herramientas en la ubicación indizada especificada en la colección de botones de la 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 de en ToolBarButton la colección.

Valor de propiedad

ToolBarButton

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

Excepciones

ArgumentNullException

El valor de index es null.

ArgumentOutOfRangeException

El valor de index es menor que cero.

O bien

El index valor es mayor que el número de botones de la colección y la colección de botones no nulles .

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 elemento 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 , puede hacer referencia al objeto de ToolBar.ToolBarButtonCollectioncolecció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