ToolBarButton Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ToolBarButton.cs

Upozornění

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

Představuje tlačítko panelu nástrojů Systému Windows.

Tato třída není dostupná v .NET Core 3.1 a novějších verzích. Místo toho použijte ToolStripButton , který nahrazuje a rozšiřuje ToolBarButton ovládací prvek.

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

Dědičnost

Object

MarshalByRefObject

Component

ToolBarButton

Atributy

BrowsableAttribute ObsoleteAttribute

Příklady

Následující příklad kódu vytvoří ToolBar a tři ToolBarButton ovládací prvky. Tlačítka panelu nástrojů jsou přiřazena ke kolekci tlačítek, kolekce je přiřazena k panelu nástrojů a panel nástrojů se přidá do formuláře. ButtonClick Při události panelu nástrojů Button je vlastnost ToolBarButtonClickEventArgs vyhodnocena a příslušné dialogové okno otevřeno. Tento kód vyžaduje, aby Formbyl vytvořen znak , a OpenFileDialogSaveFileDialog, a PrintDialog vše bylo vytvořeno.

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

Poznámky

Tato třída není dostupná v .NET Core 3.1 a novějších verzích. Místo toho použijte ToolStripButton.

ToolBarButton ovládací prvky jsou nadřazené ovládacími ToolBar prvky. Společné vlastnosti, které se mají nastavit po vytvoření tlačítka panelu nástrojů, jsou Text a ImageIndex. Text Nastavte vlastnost tlačítka tak, aby zobrazoval text pod obrázkem nebo napravo od obrázku. Pokud chcete k tlačítkům přiřadit obrázky vytvořením ImageList, přiřaďte ho vlastnosti ImageList panelu nástrojů; potom přiřaďte hodnotu indexu obrázku vlastnosti ImageIndex tlačítka.

Pokud chcete změnit vzhled tlačítek panelu nástrojů přiřazených k panelu nástrojů, nastavte Appearance vlastnost nadřazeného ovládacího prvku panelu nástrojů. Vzhled ToolBarAppearance.Flat dává tlačítkům plochý vzhled. Když se ukazatel myši pohybuje nad tlačítky, jejich vzhled se změní na trojrozměrné. Oddělovače tlačítek se zobrazují jako čáry místo mezer mezi tlačítky, pokud mají tlačítka plochý vzhled. Pokud je vlastnost nastavena Appearance na ToolBarAppearance.Normal, tlačítka se zobrazí vyvýšená a trojrozměrná a oddělovače se zobrazí jako mezera mezi tlačítky.

K tlačítku můžete přiřadit ContextMenu , pokud je vlastnost nastavena Style na ToolBarButtonStyle.DropDown. Po kliknutí na tlačítko se zobrazí přiřazená nabídka.

Chcete-li vytvořit kolekci ovládacích ToolBarButton prvků, které se mají zobrazit na , ToolBarpřidejte tlačítka jednotlivě pomocí Add metody Buttons vlastnosti. Alternativně můžete pomocí této metody přidat několik tlačítek na panelu AddRange nástrojů.

Konstruktory

Name	Description
ToolBarButton()	Zastaralé. Inicializuje novou instanci ToolBarButton třídy.
ToolBarButton(String)	Zastaralé. Inicializuje novou instanci ToolBarButton třídy a zobrazí přiřazený text na tlačítku.

Vlastnosti

Name	Description
DropDownMenu	Zastaralé. Získá nebo nastaví nabídku, která se má zobrazit v rozevíracím panelu nástrojů tlačítko.
Enabled	Zastaralé. Získá nebo nastaví hodnotu označující, zda je tlačítko povoleno.
ImageIndex	Zastaralé. Získá nebo nastaví hodnotu indexu obrázku přiřazeného k tlačítku.
ImageKey	Zastaralé. Získá nebo nastaví název obrázku přiřazeného k tlačítku.
Name	Zastaralé. Název tlačítka.
Parent	Zastaralé. Získá ovládací prvek panelu nástrojů, ke kterému je tlačítko panelu nástrojů přiřazeno.
PartialPush	Zastaralé. Získá nebo nastaví hodnotu označující, zda je tlačítko přepínacího stylu panelu nástrojů částečně vloženo.
Pushed	Zastaralé. Získá nebo nastaví hodnotu označující, zda je tlačítko přepínacího stylu panelu nástrojů aktuálně v nabízeném stavu.
Rectangle	Zastaralé. Získá ohraničující obdélník pro tlačítko panelu nástrojů.
Style	Zastaralé. Získá nebo nastaví styl tlačítka panelu nástrojů.
Tag	Zastaralé. Získá nebo nastaví objekt, který obsahuje data o panelu nástrojů tlačítko.
Text	Zastaralé. Získá nebo nastaví text zobrazený na panelu nástrojů tlačítko.
ToolTipText	Zastaralé. Získá nebo nastaví text, který se zobrazí jako popis tlačítka.
Visible	Zastaralé. Získá nebo nastaví hodnotu určující, zda je tlačítko panelu nástrojů viditelné.

Viz také

• ToolBar
• MenuItem
• ImageList
• ToolTip