ToolBarButton Klas

Definitie

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

public class ToolBarButton : System.ComponentModel.Component

type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

Overname

Object

MarshalByRefObject

Component

ToolBarButton

Voorbeelden

In het volgende codevoorbeeld worden een ToolBar en drie ToolBarButton besturingselementen gemaakt. De werkbalkknoppen worden toegewezen aan de knopverzameling, de verzameling wordt toegewezen aan de werkbalk en de werkbalk wordt toegevoegd aan het formulier. In de ButtonClick gebeurtenis van de werkbalk wordt de Button eigenschap van de ToolBarButtonClickEventArgs werkbalk geëvalueerd en het juiste dialoogvenster geopend. Voor deze code is vereist dat een Form, een OpenFileDialog, een SaveFileDialogen een PrintDialog allemaal zijn gemaakt.

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

Opmerkingen

Deze klasse is niet beschikbaar in .NET Core 3.1 en nieuwere versies. Gebruik in plaats daarvan ToolStripButton.

ToolBarButton besturingselementen worden bovenliggend door ToolBar besturingselementen. Algemene eigenschappen die moeten worden ingesteld zodra de werkbalkknop is gemaakt, zijn Text en ImageIndex. Stel de Text eigenschap van de knop in om tekst onder of rechts van de afbeelding weer te geven. Als u afbeeldingen wilt toewijzen aan de knoppen door een ImageListafbeelding te maken, wijst u deze toe aan de ImageList eigenschap van de werkbalk en wijst u vervolgens de waarde van de afbeeldingsindex toe aan de ImageIndex eigenschap van de knop.

Als u het uiterlijk wilt wijzigen van de werkbalkknoppen die aan de werkbalk zijn toegewezen, stelt u de Appearance eigenschap van het bovenliggende werkbalkbesturingselement in. Het ToolBarAppearance.Flat uiterlijk geeft de knoppen een plat uiterlijk. Terwijl de muis aanwijzer over de knoppen beweegt, verandert het uiterlijk ervan in driedimensionaal. Knopscheidingstekens worden weergegeven als lijnen in plaats van spaties tussen de knoppen wanneer de knoppen een plat uiterlijk hebben. Als de Appearance eigenschap is ingesteld ToolBarAppearance.Normalop, worden de knoppen omhoog en driedimensionaal weergegeven en worden de scheidingstekens weergegeven als een tussenruimte tussen de knoppen.

U kunt een ContextMenu knop toewijzen als de Style eigenschap is ingesteld op ToolBarButtonStyle.DropDown. Wanneer op de knop wordt geklikt, wordt het toegewezen menu weergegeven.

Als u een verzameling ToolBarButton besturingselementen wilt maken die op een ToolBarmoeten worden weergegeven, voegt u de knoppen afzonderlijk toe met behulp van de Add methode van de Buttons eigenschap. U kunt ook verschillende werkbalkknoppen toevoegen met behulp van de AddRange methode.

Zie ook

• ToolBar
• MenuItem
• ImageList
• ToolTip