ToolBar.ToolBarButtonCollection.Item[] Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen einer ToolBarButton innerhalb der Auflistung.
Überlädt
| Name | Beschreibung |
|---|---|
| Item[String] |
Ruft einen ToolBarButton mit dem angegebenen Schlüssel aus der Auflistung ab. |
| Item[Int32] |
Dient zum Abrufen oder Festlegen der Symbolleistenschaltfläche an der angegebenen indizierten Position in der Symbolleistenschaltfläche -Auflistung. |
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.ToolBarButtonDefault Public Overridable ReadOnly Property Item(key As String) As ToolBarButtonParameter
- key
- String
Der Name des ToolBarButton abzurufenden Vorgangs.
Eigenschaftswert
Die ToolBarButton Eigenschaft, deren Name Eigenschaft dem angegebenen Schlüssel entspricht.
Hinweise
Die Name Eigenschaft entspricht dem Schlüssel für eine ToolBarButton in der ToolBar.ToolBarButtonCollection.
Bei dem Schlüsselvergleich wird die Groß-/Kleinschreibung nicht beachtet. Wenn der key Parameter oder eine leere Zeichenfolge ist null , Item[] wird zurückgegeben null.
Gilt für:
Item[Int32]
Dient zum Abrufen oder Festlegen der Symbolleistenschaltfläche an der angegebenen indizierten Position in der Symbolleistenschaltfläche -Auflistung.
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, setDefault Public Overridable Property Item(index As Integer) As ToolBarButtonParameter
- index
- Int32
Die indizierte Position der ToolBarButton Auflistung.
Eigenschaftswert
Ein ToolBarButton Wert, der die Symbolleistenschaltfläche an der angegebenen indizierten Position darstellt.
Ausnahmen
Der wert index ist null.
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 Sammlung von Schaltflächen ist nicht null.
Beispiele
Im folgenden Codebeispiel wird die letzte Symbolleistenschaltfläche auf einer Symbolleiste ersetzt. Dieser Code erfordert, dass mindestens ToolBar eine 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 Schaltfläche. Der index Wert der zu ersetzenden Symbolleistenschaltfläche wird auf die Count Eigenschaft minus 1 festgelegt, 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
Zum Zuweisen von ToolBarButton Steuerelementen zu einer bestimmten Position oder zum Abrufen aus dem ToolBar.ToolBarButtonCollectionObjekt können Sie auf das Auflistungsobjekt mit einem bestimmten Indexwert verweisen. Der Indexwert des Indexes ToolBar.ToolBarButtonCollection ist ein nullbasierter Index.
