ToolBar.ToolBarButtonCollection.RemoveAt-Methode
Entfernt eine angegebene Schaltfläche aus der Auflistung der Symbolleisten-Schaltflächen.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
Public Sub RemoveAt ( _
index As Integer _
)
'Usage
Dim instance As ToolBarButtonCollection
Dim index As Integer
instance.RemoveAt(index)
public void RemoveAt (
int index
)
public:
virtual void RemoveAt (
int index
) sealed
public final void RemoveAt (
int index
)
public final function RemoveAt (
index : int
)
Parameter
- index
Die indizierte Position des ToolBarButton in der Auflistung.
Ausnahmen
Ausnahmetyp | Bedingung |
---|---|
Der index-Wert ist kleiner als 0 oder größer als die Anzahl der Schaltflächen in der Auflistung. |
Hinweise
Die Remove-Methode entfernt den ToolBarButton aus der angegebenen Position in der ToolBar.ToolBarButtonCollection. Wenn alle ToolBarButton-Steuerelemente aus der Auflistung entfernt werden sollen, verwenden Sie die Clear-Methode.
Beispiel
Im folgenden Codebeispiel wird der letzte ToolBarButton auf der ToolBar entfernt. Der Indexwert der entfernten Symbolleisten-Schaltfläche wird entsprechend der Count-Eigenschaft minus eins festgelegt, da die ToolBarButton-Auflistung ein nullbasierter Index ist.
Public Sub RemoveMyButton()
Dim btns As Integer
btns = toolBar1.Buttons.Count
' Remove the last toolbar button.
toolBar1.Buttons.RemoveAt(btns - 1)
End Sub
public void RemoveMyButton()
{
int btns;
btns = toolBar1.Buttons.Count;
// Remove the last toolbar button.
toolBar1.Buttons.RemoveAt(btns - 1);
}
public:
void RemoveMyButton()
{
int btns;
btns = toolBar1->Buttons->Count;
// Remove the last toolbar button.
toolBar1->Buttons->RemoveAt( btns - 1 );
}
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
ToolBar.ToolBarButtonCollection-Klasse
ToolBar.ToolBarButtonCollection-Member
System.Windows.Forms-Namespace
Clear
ToolBarButton
Add