ToolBar.ToolBarButtonCollection.Item[] Propriedade

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 Propriedade

A ToolBarButton propriedade whose Name corresponde à chave especificada.

Observações

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

A comparação principal não é sensível a maiúsculas minúsculas. Se o key parâmetro for null ou uma cadeia vazia, Item[] devolve 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 Propriedade

A ToolBarButton que representa o botão da barra de ferramentas na localização indexada especificada.

Exceções

Exemplos

O seguinte exemplo de código substitui o último botão da barra de ferramentas numa barra de ferramentas. Este código exige que tenham sido criados um ToolBar e pelo menos um ToolBarButton . 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á a ser substituído é definido para 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

Observações

Para atribuir ToolBarButton controlos a uma localização específica, ou para os recuperar do ToolBar.ToolBarButtonCollection, pode referenciar o objeto de coleção com um valor de índice específico. O valor do índice é ToolBar.ToolBarButtonCollection um índice baseado em zero.

Ver também

• Count
• ToolBarButton