ToolBar.ToolBarButtonCollection.Item[] Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen ToolBarButton in der Auflistung ab oder legt diesen fest.

Überlädt

Item[String]	Ruft einen ToolBarButton mit dem angegebenen Schlüssel aus der Auflistung ab.
Item[Int32]	Ruft die Symbolleisten-Schaltfläche an der angegebenen indizierten Position in der Auflistung der Symbolleisten-Schaltflächen ab oder legt diese fest.

Item[String]

Ruft einen ToolBarButton mit dem angegebenen Schlüssel aus der Auflistung ab.

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

Parameter

key

String

Der Name der abzurufenden ToolBarButton.

Eigenschaftswert

ToolBarButton

Das ToolBarButton, dessen Name-Eigenschaft mit dem angegebenen Schlüssel übereinstimmt.

Hinweise

Die Name Eigenschaft entspricht dem Schlüssel für eine ToolBarButton in der ToolBar.ToolBarButtonCollection.

Der Schlüsselvergleich ist nicht groß- und kleinschreibungsgeschützt. Wenn der key Parameter oder eine leere Zeichenfolge ist null , Item[] wird zurückgegeben null.

Item[Int32]

Ruft die Symbolleisten-Schaltfläche an der angegebenen indizierten Position in der Auflistung der Symbolleisten-Schaltflächen ab oder legt diese fest.

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

Parameter

index

Int32

Die indizierte Position des ToolBarButton in der Auflistung.

Eigenschaftswert

ToolBarButton

Ein ToolBarButton, der die Symbolleisten-Schaltfläche an der angegebenen indizierten Position darstellt.

Ausnahmen

ArgumentNullException

Der index-Wert ist null.

ArgumentOutOfRangeException

Der index-Wert ist kleiner als 0.

- oder - Der index-Wert ist größer als die Anzahl der Schaltflächen in der Auflistung, und die Auflistung der Schaltflächen ist nicht null.

Beispiele

Im folgenden Codebeispiel wird die letzte Symbolleistenschaltfläche in einer Symbolleiste ersetzt. Dieser Code erfordert, dass mindestens eine ToolBar ToolBarButton erstellt wurde. Das Beispiel ruft die Anzahl der Schaltflächen auf der Symbolleiste ab und ersetzt die letzte Schaltfläche durch eine neu erstellte. Der index Wert der ersetzten Symbolleistenschaltfläche wird auf die Count Eigenschaft festgelegt, minus eins, da die ToolBarButton Auflistung ein nullbasierter Index ist.

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

Hinweise

Um Steuerelementen einem bestimmten Speicherort zuzuweisen ToolBarButton oder sie aus dem ToolBar.ToolBarButtonCollectionObjekt abzurufen, können Sie auf das Auflistungsobjekt mit einem bestimmten Indexwert verweisen. Der Indexwert des ToolBar.ToolBarButtonCollection Indexes ist ein nullbasierter Index.

Siehe auch

• Count
• ToolBarButton