ToolBar-Klasse
Stellt eine Windows-Symbolleiste dar. Obwohl ToolStrip Funktionalität ersetzt und dem ToolBar-Steuerelement früherer Versionen hinzufügt, kann ToolBar aus Gründen der Abwärtskompatibilität und für eine künftige Verwendung erhalten bleiben, wenn Sie diese Option auswählen.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class ToolBar
Inherits Control
'Usage
Dim instance As ToolBar
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
public class ToolBar : Control
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
public ref class ToolBar : public Control
/** @attribute ComVisibleAttribute(true) */
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
public class ToolBar extends Control
ComVisibleAttribute(true)
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)
public class ToolBar extends Control
Hinweise
ToolBar-Steuerelemente werden für die Anzeige von ToolBarButton-Steuerelementen verwendet, die als Standardschaltfläche, als An-Aus-Schaltfläche oder als Dropdown-Schaltfläche dargestellt werden können. Sie können den Schaltflächen Bilder zuweisen, indem Sie eine ImageList erstellen, diese der ImageList-Eigenschaft der Symbolleiste zuweisen und den Indexwert des gewünschten Bildes der ImageIndex-Eigenschaft des jeweiligen ToolBarButton zuweisen. Dann können Sie einen unterhalb oder rechts neben dem Bild anzuzeigenden Text angeben, indem Sie die Text-Eigenschaft von ToolBarButton festlegen.
Legen Sie für eine flache Darstellung der Symbolleiste und der Schaltflächen die Appearance-Eigenschaft der Symbolleiste auf Flat fest. Sobald sich der Mauszeiger über den Schaltflächen befindet, werden diese dreidimensional dargestellt. Symbolleisten-Schaltflächen können durch Trennlinien in logische Gruppen unterteilt werden. Eine Trennlinie ist eine Symbolleisten-Schaltfläche, deren Style-Eigenschaft auf ToolBarButtonStyle.Separator festgelegt ist. Schaltflächen-Trennlinien werden bei einer flachen Symbolleistendarstellung als Linien und nicht als Zwischenräume zwischen den Schaltflächen angezeigt. Wenn die Appearance-Eigenschaft auf Normal festgelegt ist, werden die Symbolleisten-Schaltflächen angehoben und dreidimensional dargestellt.
Wenn Sie einen Wert für die ButtonSize-Eigenschaft angeben, werden alle Schaltflächen auf der Symbolleiste auf die angegebene Größe beschränkt. Andernfalls ist die Größe der Schaltflächen vom jeweiligen Inhalt abhängig, und die ButtonSize-Eigenschaft gibt die ursprüngliche Größe der größten Schaltfläche zurück.
Zum Erstellen einer Auflistung von ToolBarButton-Steuerelementen, die auf der ToolBar angezeigt werden sollen, fügen Sie die Schaltflächen einzeln mit der Add-Methode oder die Insert-Methode der Buttons-Eigenschaft hinzu.
Hinweis zu Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows CE: Formulare unterstützen nur eine einzige ToolBar. Beim Versuch, eine zusätzliche ToolBar hinzuzufügen, wird eine NotSupportedException ausgelöst. Das Hinzufügen einer ToolBar zu einem anderen Steuerelement als einem Formular, z. B. zu Panel, wird nicht unterstützt.
Beispiel
Im folgenden Codebeispiel werden eine ToolBar und drei ToolBarButton-Steuerelemente erstellt. Jede Symbolleisten-Schaltfläche wird der Auflistung der Schaltflächen und diese Auflistung der Symbolleiste zugewiesen. Die Symbolleiste wird dann dem Formular hinzugefügt. Beim Eintreten des ButtonClick-Ereignisses der Symbolleiste wird die Button-Eigenschaft von ToolBarButtonClickEventArgs ausgewertet und das entsprechende Dialogfeld geöffnet. Für dieses Beispiel ist es erforderlich, dass ein Form, ein OpenFileDialog, ein SaveFileDialog und ein PrintDialog erstellt wurden.
Public Sub InitializeMyToolBar()
' Create and initialize the ToolBar and ToolBarButton controls.
Dim toolBar1 As New ToolBar()
Dim toolBarButton1 As New ToolBarButton()
Dim toolBarButton2 As New ToolBarButton()
Dim toolBarButton3 As New ToolBarButton()
' Set the Text properties of the ToolBarButton controls.
toolBarButton1.Text = "Open"
toolBarButton2.Text = "Save"
toolBarButton3.Text = "Print"
' Add the ToolBarButton controls to the ToolBar.
toolBar1.Buttons.Add(toolBarButton1)
toolBar1.Buttons.Add(toolBarButton2)
toolBar1.Buttons.Add(toolBarButton3)
' Add the event-handler delegate.
AddHandler toolBar1.ButtonClick, AddressOf Me.toolBar1_ButtonClick
' Add the ToolBar to the Form.
Controls.Add(toolBar1)
End Sub
Private Sub toolBar1_ButtonClick(ByVal sender As Object, _
ByVal e As ToolBarButtonClickEventArgs)
' Evaluate the Button property to determine which button was clicked.
Select Case toolBar1.Buttons.IndexOf(e.Button)
Case 0
openFileDialog1.ShowDialog()
' Insert code to open the file.
Case 1
saveFileDialog1.ShowDialog()
' Insert code to save the file.
Case 2
printDialog1.ShowDialog()
' Insert code to print the file.
End Select
End Sub
public void InitializeMyToolBar()
{
// Create and initialize the ToolBar and ToolBarButton controls.
toolBar1 = new ToolBar();
ToolBarButton toolBarButton1 = new ToolBarButton();
ToolBarButton toolBarButton2 = new ToolBarButton();
ToolBarButton toolBarButton3 = new ToolBarButton();
// Set the Text properties of the ToolBarButton controls.
toolBarButton1.Text = "Open";
toolBarButton2.Text = "Save";
toolBarButton3.Text = "Print";
// Add the ToolBarButton controls to the ToolBar.
toolBar1.Buttons.Add(toolBarButton1);
toolBar1.Buttons.Add(toolBarButton2);
toolBar1.Buttons.Add(toolBarButton3);
// Add the event-handler delegate.
toolBar1.ButtonClick += new ToolBarButtonClickEventHandler (
this.toolBar1_ButtonClick);
// Add the ToolBar to the Form.
Controls.Add(toolBar1);
}
private void toolBar1_ButtonClick (
Object sender,
ToolBarButtonClickEventArgs e)
{
// Evaluate the Button property to determine which button was clicked.
switch(toolBar1.Buttons.IndexOf(e.Button))
{
case 0:
openFileDialog1.ShowDialog();
// Insert code to open the file.
break;
case 1:
saveFileDialog1.ShowDialog();
// Insert code to save the file.
break;
case 2:
printDialog1.ShowDialog();
// Insert code to print the file.
break;
}
}
public:
void InitializeMyToolBar()
{
// Create and initialize the ToolBar and ToolBarButton controls.
toolBar1 = gcnew ToolBar;
ToolBarButton^ toolBarButton1 = gcnew ToolBarButton;
ToolBarButton^ toolBarButton2 = gcnew ToolBarButton;
ToolBarButton^ toolBarButton3 = gcnew ToolBarButton;
// Set the Text properties of the ToolBarButton controls.
toolBarButton1->Text = "Open";
toolBarButton2->Text = "Save";
toolBarButton3->Text = "Print";
// Add the ToolBarButton controls to the ToolBar.
toolBar1->Buttons->Add( toolBarButton1 );
toolBar1->Buttons->Add( toolBarButton2 );
toolBar1->Buttons->Add( toolBarButton3 );
// Add the event-handler delegate.
toolBar1->ButtonClick += gcnew ToolBarButtonClickEventHandler(
this, &Form1::toolBar1_ButtonClick );
// Add the ToolBar to the Form.
Controls->Add( toolBar1 );
}
private:
void toolBar1_ButtonClick(
Object^ sender,
ToolBarButtonClickEventArgs^ e )
{
// Evaluate the Button property to determine which button was clicked.
switch ( toolBar1->Buttons->IndexOf( e->Button ) )
{
case 0:
openFileDialog1->ShowDialog();
// Insert code to open the file.
break;
case 1:
saveFileDialog1->ShowDialog();
// Insert code to save the file.
break;
case 2:
printDialog1->ShowDialog();
// Insert code to print the file.
break;
}
}
public void InitializeMyToolBar()
{
// Create and initialize the ToolBar and ToolBarButton controls.
toolBar1 = new ToolBar();
ToolBarButton toolBarButton1 = new ToolBarButton();
ToolBarButton toolBarButton2 = new ToolBarButton();
ToolBarButton toolBarButton3 = new ToolBarButton();
// Set the Text properties of the ToolBarButton controls.
toolBarButton1.set_Text("Open");
toolBarButton2.set_Text("Save");
toolBarButton3.set_Text("Print");
// Add the ToolBarButton controls to the ToolBar.
toolBar1.get_Buttons().Add(toolBarButton1);
toolBar1.get_Buttons().Add(toolBarButton2);
toolBar1.get_Buttons().Add(toolBarButton3);
// Add the event-handler delegate.
toolBar1.add_ButtonClick(new ToolBarButtonClickEventHandler(
this.toolBar1_ButtonClick));
// Add the ToolBar to the Form.
get_Controls().Add(toolBar1);
} //InitializeMyToolBar
protected void toolBar1_ButtonClick(Object sender,
ToolBarButtonClickEventArgs e)
{
// Evaluate the Button property to determine which button was clicked.
switch (toolBar1.get_Buttons().IndexOf(e.get_Button())) {
case 0 :
openFileDialog1.ShowDialog();
// Insert code to open the file.
break;
case 1 :
saveFileDialog1.ShowDialog();
// Insert code to save the file.
break;
case 2 :
printDialog1.ShowDialog();
// Insert code to print the file.
break;
}
} //toolBar1_ButtonClick
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ToolBar
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
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