ToolBarButton Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

ToolBarButton.cs

Figyelemfelhívás

ToolBar is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use ToolStrip instead.

Egy Windows eszköztárgombot jelöl.

Ez az osztály nem érhető el .NET Core 3.1 és újabb verziókban. Helyette használja ToolStripButton , amely lecseréli és kibővíti a vezérlőt ToolBarButton .

public ref 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

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

Öröklődés

Object

MarshalByRefObject

Component

ToolBarButton

Attribútumok

BrowsableAttribute ObsoleteAttribute

Példák

Az alábbi példakód egy és három ToolBar vezérlőt ToolBarButton hoz létre. Az eszköztárgombok a gombgyűjteményhez vannak rendelve, a gyűjtemény az eszköztárhoz van rendelve, és az eszköztár hozzá lesz adva az űrlaphoz. ButtonClick Az eszköztár eseményén a rendszer kiértékeli a ButtonToolBarButtonClickEventArgs tulajdonságot, és megnyílik a megfelelő párbeszédpanel. Ehhez a kódhoz létre kell hoznia egy Form, egy OpenFileDialog, egy SaveFileDialogés egy PrintDialog elemet.

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

Megjegyzések

Ez az osztály nem érhető el .NET Core 3.1 és újabb verziókban. A ToolStripButton használható helyette.

ToolBarButton vezérlők szülőként ToolBar jelennek meg. Az eszköztár gomb létrehozása Text után beállítható általános tulajdonságok és ImageIndex. Állítsa be a Text gomb tulajdonságát a kép alatti vagy jobb oldali szöveg megjelenítéséhez. Ha képeket szeretne hozzárendelni a gombokhoz egy ImageListlétrehozásával, rendelje hozzá az ImageList eszköztár tulajdonságához, majd rendelje hozzá a képindex értékét a ImageIndex gomb tulajdonságához.

Az eszköztárhoz rendelt eszköztárgombok megjelenésének módosításához állítsa be a Appearance szülőpult vezérlőelem tulajdonságát. A ToolBarAppearance.Flat megjelenés sima megjelenést kölcsönöz a gomboknak. Ahogy az egérmutató a gombok fölé kerül, megjelenésük háromdimenziósra változik. A gombelválasztók sorokként jelennek meg, nem szóközökként a gombok között, ha a gombok megjelenése lapos. Ha a Appearance tulajdonság be van állítva ToolBarAppearance.Normal, a gombok emelve és háromdimenziósan jelennek meg, az elválasztók pedig résként jelennek meg a gombok között.

Gombhoz rendelhet hozzá egy ContextMenu gombot, ha a Style tulajdonság be van állítva ToolBarButtonStyle.DropDown. Amikor a gombra kattint, megjelenik a hozzárendelt menü.

Ha vezérlők ToolBarButtongyűjteményét ToolBar szeretné létrehozni, a tulajdonság metódusával egyenként adja hozzá a AddButtons gombokat. Másik lehetőségként több eszköztárgombot is hozzáadhat a AddRange metódussal.

Konstruktorok

Name	Description
ToolBarButton()	Elavult. Inicializálja a ToolBarButton osztály új példányát.
ToolBarButton(String)	Elavult. Inicializálja az ToolBarButton osztály új példányát, és megjeleníti a hozzárendelt szöveget a gombon.

Tulajdonságok

Name	Description
DropDownMenu	Elavult. Lekéri vagy beállítja a menü megjelenítését a legördülő eszköztár gombra.
Enabled	Elavult. Lekéri vagy beállít egy értéket, amely jelzi, hogy a gomb engedélyezve van-e.
ImageIndex	Elavult. Lekéri vagy beállítja a gombhoz rendelt kép indexértékét.
ImageKey	Elavult. Lekéri vagy beállítja a gombhoz rendelt kép nevét.
Name	Elavult. A gomb neve.
Parent	Elavult. Lekéri azt az eszköztár-vezérlőt, amelyhez az eszköztárgomb hozzá van rendelve.
PartialPush	Elavult. Lekéri vagy beállít egy értéket, amely jelzi, hogy a váltóstílusú eszköztár gombja részben le van-e nyomva.
Pushed	Elavult. Lekéri vagy beállít egy értéket, amely jelzi, hogy egy váltóstílusú eszköztárgomb jelenleg leküldéses állapotban van-e.
Rectangle	Elavult. Lekéri egy eszköztárgomb határolókeretét.
Style	Elavult. Lekéri vagy beállítja az eszköztár gomb stílusát.
Tag	Elavult. Lekéri vagy beállítja az eszköztár gomb adatait tartalmazó objektumot.
Text	Elavult. Lekéri vagy beállítja az eszköztár gombon megjelenő szöveget.
ToolTipText	Elavult. Lekéri vagy beállítja a gomb elemleírásaként megjelenő szöveget.
Visible	Elavult. Lekéri vagy beállít egy értéket, amely jelzi, hogy az eszköztár gomb látható-e.

Lásd még

• ToolBar
• MenuItem
• ImageList
• ToolTip