ToolBarButton Klass

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

Arv

Object

MarshalByRefObject

Component

ToolBarButton

Attribut

BrowsableAttribute ObsoleteAttribute

Exempel

I följande kodexempel skapas en ToolBar och tre ToolBarButton kontroller. Knapparna i verktygsfältet tilldelas till knappsamlingen, samlingen tilldelas till verktygsfältet och verktygsfältet läggs till i formuläret. ButtonClick I händelse av verktygsfältet Button utvärderas egenskapen för ToolBarButtonClickEventArgs och lämplig dialogruta öppnas. Den här koden kräver att en Form, en OpenFileDialog, en SaveFileDialogoch en PrintDialog har skapats.

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

Kommentarer

Den här klassen är inte tillgänglig i .NET Core 3.1 och senare versioner. Använd ToolStripButton i stället.

ToolBarButton kontroller överordnas av ToolBar kontroller. Vanliga egenskaper som ska anges när verktygsfältsknappen har skapats är Text och ImageIndex. Text Ange egenskapen för knappen för att visa text under eller till höger om bilden. Om du vill tilldela bilder till knapparna genom att skapa en ImageList, tilldelar du den ImageList till egenskapen för verktygsfältet. Tilldela sedan värdet för bildindexet till ImageIndex egenskapen för knappen.

Om du vill ändra utseendet på verktygsfältsknapparna som tilldelats verktygsfältet anger du egenskapen för den Appearance överordnade verktygsfältskontrollen. Utseendet ToolBarAppearance.Flat ger knapparna ett platt utseende. När muspekaren flyttas över knapparna ändras deras utseende till tredimensionellt. Knappavgränsare visas som linjer i stället för blanksteg mellan knapparna när knapparna har ett platt utseende. Om egenskapen Appearance är inställd ToolBarAppearance.Normalpå visas knapparna upphöjda och tredimensionella, och avgränsarna visas som ett mellanrum mellan knapparna.

Du kan tilldela en ContextMenu till en knapp om egenskapen Style är inställd på ToolBarButtonStyle.DropDown. När du klickar på knappen visas den tilldelade menyn.

Om du vill skapa en samling ToolBarButton kontroller som ska visas på en ToolBarlägger du till knapparna individuellt med hjälp Add av egenskapens Buttons metod. Du kan också lägga till flera knappar i verktygsfältet med hjälp av AddRange metoden .

Se även

• ToolBar
• MenuItem
• ImageList
• ToolTip