ToolBarButton Klasse

Definition

public ref class ToolBarButton : System::ComponentModel::Component

public class ToolBarButton : System.ComponentModel.Component

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`ToolBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class ToolBarButton : System.ComponentModel.Component

type ToolBarButton = class
    inherit Component

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`ToolBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

Vererbung

Object

MarshalByRefObject

Component

ToolBarButton

Attribute

BrowsableAttribute ObsoleteAttribute

Beispiele

Im folgenden Codebeispiel werden ein ToolBar und drei ToolBarButton Steuerelemente erstellt. Die Symbolleistenschaltflächen werden der Schaltflächensammlung zugewiesen, die Sammlung wird der Symbolleiste zugewiesen, und die Symbolleiste wird dem Formular hinzugefügt. Bei dem ButtonClick Ereignis der Symbolleiste wird die Button Eigenschaft der ToolBarButtonClickEventArgs Symbolleiste ausgewertet und das entsprechende Dialogfeld geöffnet. Dieser Code erfordert, dass ein , ein FormOpenFileDialog, ein SaveFileDialog, ein und ein PrintDialog - alle erstellt wurden.

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.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 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

Hinweise

Diese Klasse ist in .NET Core 3.1 und höheren Versionen nicht verfügbar. Verwenden Sie stattdessen ToolStripButton.

ToolBarButton Steuerelemente werden von ToolBar Steuerelementen übergeordnet. Allgemeine Eigenschaften, die festgelegt werden sollen, nachdem die Symbolleistenschaltfläche erstellt wurde, sind Text und ImageIndex. Legen Sie die Text Eigenschaft der Schaltfläche fest, um Text unter oder rechts neben dem Bild anzuzeigen. Wenn Sie den Schaltflächen Bilder zuweisen möchten, indem Sie ImageListsie ImageList der Eigenschaft der Symbolleiste zuweisen. Weisen Sie dann der ImageIndex Eigenschaft der Schaltfläche den Bildindexwert zu.

Um die Darstellung der Symbolleistenschaltflächen zu ändern, die der Symbolleiste zugewiesen sind, legen Sie die Appearance Eigenschaft des übergeordneten Symbolleistensteuerelements fest. Die ToolBarAppearance.Flat Darstellung gibt den Schaltflächen eine flache Darstellung. Wenn sich der Mauszeiger über die Schaltflächen bewegt, ändert sich die Darstellung in dreidimensional. Schaltflächentrennzeichen werden als Linien anstelle von Leerzeichen zwischen den Schaltflächen angezeigt, wenn die Schaltflächen eine flache Darstellung aufweisen. Wenn die Appearance Eigenschaft auf "Festgelegt" festgelegt ToolBarAppearance.Normalist, werden die Schaltflächen ausgelöst und dreidimensional angezeigt, und die Trennzeichen werden als Abstand zwischen den Schaltflächen angezeigt.

Sie können einer Schaltfläche eine ContextMenu Schaltfläche zuweisen, wenn die Style Eigenschaft auf ToolBarButtonStyle.DropDown. Wenn auf die Schaltfläche geklickt wird, wird das zugewiesene Menü angezeigt.

Um eine Auflistung von ToolBarButton Steuerelementen zu erstellen, die auf einem Steuerelement ToolBarangezeigt werden sollen, fügen Sie die Schaltflächen mithilfe der Methode der Buttons Eigenschaft einzeln Add hinzu. Alternativ können Sie mithilfe der AddRange Methode mehrere Symbolleistenschaltflächen hinzufügen.

Weitere Informationen

• ToolBar
• MenuItem
• ImageList
• ToolTip