ToolBar.ToolBarButtonCollection.Item[] Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta un oggetto ToolBarButton nell'insieme.

Overload

Item[String]	Ottiene un oggetto ToolBarButton con la chiave specificata dall'insieme.
Item[Int32]	Ottiene o imposta il pulsante della barra degli strumenti in corrispondenza della posizione dell'indice specificata nell'insieme di pulsanti della barra degli strumenti.

Item[String]

Ottiene un oggetto ToolBarButton con la chiave specificata dall'insieme.

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

Parametri

key

String

Nome dell'oggetto ToolBarButton da recuperare.

Valore della proprietà

ToolBarButton

Oggetto ToolBarButton la cui proprietà Name corrisponde alla chiave specificata.

Commenti

La Name proprietà corrisponde alla chiave per un ToolBarButton oggetto in ToolBar.ToolBarButtonCollection.

Il confronto tra chiavi non fa distinzione tra maiuscole e minuscole. Se il key parametro è null o una stringa vuota, Item[] restituisce null.

Item[Int32]

Ottiene o imposta il pulsante della barra degli strumenti in corrispondenza della posizione dell'indice specificata nell'insieme di pulsanti della barra degli strumenti.

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

Parametri

index

Int32

La posizione indicizzata dell'oggetto ToolBarButton nell'insieme.

Valore della proprietà

ToolBarButton

Controllo ToolBarButton che rappresenta il pulsante della barra degli strumenti in corrispondenza della posizione dell'indice specificata.

Eccezioni

ArgumentNullException

Il valore index è null.

ArgumentOutOfRangeException

Il valore index è minore di zero.

-oppure- Il valore indexè maggiore del numero di pulsanti nell'insieme e l'insieme dei pulsanti non è null.

Esempio

Nell'esempio di codice seguente viene sostituito l'ultimo pulsante della barra degli strumenti su una barra degli strumenti. Questo codice richiede che sia stato creato un e ToolBar almeno uno ToolBarButton . L'esempio ottiene il numero di pulsanti sulla barra degli strumenti e sostituisce l'ultimo pulsante con uno appena creato. Il index valore del pulsante della barra degli strumenti da sostituire è impostato sulla Count proprietà , meno uno, poiché l'insieme ToolBarButton è un indice in base 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

Commenti

Per assegnare ToolBarButton controlli a una posizione specifica o per recuperarli da ToolBar.ToolBarButtonCollection, è possibile fare riferimento all'oggetto raccolta con un valore di indice specifico. Il valore di indice di ToolBar.ToolBarButtonCollection è un indice in base zero.

Vedi anche

• Count
• ToolBarButton