ToolBar.ToolBarButtonCollection.Item[] Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define um ToolBarButton na coleção.

Sobrecargas

Item[String]	Obtém um ToolBarButton com a chave especificada da coleção.
Item[Int32]	Obtém ou define o botão de barra de ferramentas no local indexado especificado na coleção de botões de barra de ferramentas.

Item[String]

Obtém um ToolBarButton com a chave especificada da coleção.

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

O nome do ToolBarButton a ser recuperado.

Valor da propriedade

ToolBarButton

A ToolBarButton propriedade cuja Name propriedade corresponde à chave especificada.

Comentários

A Name propriedade corresponde à chave de um ToolBarButton no ToolBar.ToolBarButtonCollection.

A comparação de chave não diferencia maiúsculas de minúsculas. Se o key parâmetro for null ou uma cadeia de caracteres vazia, Item[] retornará null.

Item[Int32]

Obtém ou define o botão de barra de ferramentas no local indexado especificado na coleção de botões de barra de ferramentas.

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

O local indexado do ToolBarButton na coleção.

Valor da propriedade

ToolBarButton

Um ToolBarButton que representa o botão da barra de ferramentas no local indexado especificado.

Exceções

ArgumentNullException

O valor index é null.

ArgumentOutOfRangeException

O valor index é menor que zero.

- ou - O valor index é maior que o número de botões na coleção e a coleção de botões não é null.

Exemplos

O exemplo de código a seguir substitui o último botão da barra de ferramentas em uma barra de ferramentas. Esse código exige que um ToolBar e pelo menos um ToolBarButton tenham sido criados. O exemplo obtém o número de botões na barra de ferramentas e substitui o último botão por um recém-criado. O index valor do botão da barra de ferramentas que está sendo substituído é definido como a Count propriedade, menos um, uma vez que a ToolBarButton coleção é um índice baseado em zero.

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

Comentários

Para atribuir ToolBarButton controles a um local específico ou recuperá-los do ToolBar.ToolBarButtonCollectionobjeto de coleção com um valor de índice específico. O valor do ToolBar.ToolBarButtonCollection índice é um índice baseado em zero.

Confira também

• Count
• ToolBarButton