ToolBarButton Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

Stellt eine Schaltfläche einer Windows-Symbolleiste dar.

Diese Klasse ist in .NET Core 3.1 und höheren Versionen nicht verfügbar. Verwenden Sie stattdessen ToolStripButton. Dadurch wird das ToolBarButton-Steuerelement ersetzt und erweitert.

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

public class ToolBarButton : System.ComponentModel.Component

type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

Vererbung: Object

MarshalByRefObject

Component
ToolBarButton

Beispiele

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

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 durch ToolBar Steuerelemente übergeordnet. Allgemeine Eigenschaften, die nach dem Erstellen der Symbolleistenschaltfläche festgelegt werden sollen, sind Text und ImageIndex. Legen Sie die Text -Eigenschaft der Schaltfläche fest, um Text unterhalb oder rechts neben dem Bild anzuzeigen. Um den Schaltflächen Bilder zuzuweisen, indem Sie einen ImageListerstellen, weisen Sie sie der ImageList -Eigenschaft der Symbolleiste zu. Weisen Sie dann den Bildindexwert der ImageIndex -Eigenschaft der Schaltfläche 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 verleiht den Schaltflächen eine flache Darstellung. Wenn der Mauszeiger über die Schaltflächen bewegt wird, ändert sich ihre Darstellung in dreidimensional. Schaltflächentrennzeichen werden als Linien anstelle von Leerzeichen zwischen den Schaltflächen angezeigt, wenn die Schaltflächen flach dargestellt werden. Wenn die Appearance -Eigenschaft auf ToolBarAppearance.Normalfestgelegt ist, werden die Schaltflächen angehoben und dreidimensional angezeigt, und die Trennzeichen werden als Lücke zwischen den Schaltflächen angezeigt.

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

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

Konstruktoren

ToolBarButton()	Initialisiert eine neue Instanz der ToolBarButton-Klasse.
ToolBarButton(String)	Initialisiert eine neue Instanz der ToolBarButton-Klasse und zeigt den zugewiesenen Text auf der Schaltfläche an.

Eigenschaften

CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
Container	Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component)
DesignMode	Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component)
DropDownMenu	Ruft das anzuzeigende Menü der Dropdown-Schaltfläche der Symbolleiste ab oder legt dieses fest.
Enabled	Ruft einen Wert ab, der angibt, ob die Schaltfläche aktiviert ist, oder legt diesen fest.
Events	Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component)
ImageIndex	Ruft den Indexwert des Bildes ab, das der Schaltfläche zugeordnet ist, oder legt diesen fest.
ImageKey	Ruft den Namen des Bilds ab, das der Schaltfläche zugeordnet ist, oder legt diesen fest.
Name	Der Name der Schaltfläche.
Parent	Ruft das Symbolleisten-Steuerelement ab, dem die Symbolleisten-Schaltfläche zugewiesen ist.
PartialPush	Ruft einen Wert ab, der angibt, ob eine An-Aus-Schaltfläche einer Symbolleiste teilweise gedrückt ist, oder legt diesen fest.
Pushed	Ruft einen Wert ab, der angibt, ob eine An-Aus-Schaltfläche einer Symbolleiste gegenwärtig gedrückt ist, oder legt diesen fest.
Rectangle	Ruft das umschließende Rechteck für eine Symbolleisten-Schaltfläche ab.
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
Style	Ruft das Format der Symbolleisten-Schaltfläche ab oder legt dieses fest.
Tag	Ruft das Objekt ab, das die Daten über die Symbolleisten-Schaltfläche enthält, oder legt dieses fest.
Text	Ruft den Text ab, der auf der Symbolleisten-Schaltfläche angezeigt wird, oder legt diesen fest.
ToolTipText	Ruft den Text ab, der als QuickInfo für die Schaltfläche angezeigt wird, oder legt diesen fest.
Visible	Ruft einen Wert ab, der angibt, ob die Symbolleisten-Schaltfläche sichtbar ist, oder legt diesen fest.

Methoden

CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die von ToolBarButton verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetService(Type)	Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
ToString()	Gibt eine Zeichenfolge zurück, die das ToolBarButton-Steuerelement darstellt.

Ereignisse

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.

(Geerbt von Component)

Gilt für: