ToolBarButton Třída

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Tato třída není k dispozici v .NET Core 3.1 a novějších verzích. Místo toho použijte příkaz ToolStripButton , který nahradí a rozšíří ToolBarButton ovládací prvek.

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

public class ToolBarButton : System.ComponentModel.Component

type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

Dědičnost: Object

MarshalByRefObject

Component
ToolBarButton

Příklady

Následující příklad kódu vytvoří ToolBar a tři ToolBarButton ovládací prvky. Tlačítka na panelu nástrojů jsou přiřazena ke kolekci tlačítek, kolekce se přiřadí k panelu nástrojů a panel nástrojů se přidá do formuláře. ButtonClick V události panelu nástrojů se Button vyhodnotí vlastnost objektu ToolBarButtonClickEventArgs a příslušné dialogové okno se otevře. Tento kód vyžaduje vytvoření Form, , , SaveFileDialoga a PrintDialog OpenFileDialog.

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í k dispozici 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ím prvkům ToolBar . Běž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 se pod obrázkem nebo napravo od obrázku zobrazoval text. Pokud chcete tlačítkům přiřadit obrázky vytvořením ImageList, přiřaďte ho k ImageList vlastnosti panelu nástrojů a pak přiřaďte hodnotu indexu obrázku ImageIndex k vlastnosti tlačítka.

Pokud chcete změnit vzhled tlačítek na 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 přesune na tlačítka, změní se jejich vzhled na trojrozměrný. Pokud mají tlačítka plochý vzhled, zobrazují se oddělovače tlačítek jako čáry, a ne jako mezery mezi tlačítky. Appearance Pokud je vlastnost nastavena na ToolBarAppearance.Normal, tlačítka se zobrazí zvýšená a trojrozměrná a oddělovače se zobrazí jako mezera mezi tlačítky.

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

Pokud chcete vytvořit kolekci ovládacích ToolBarButton prvků pro zobrazení na objektu ToolBar, přidejte tlačítka jednotlivě pomocí Add metody Buttons vlastnosti . Alternativně můžete přidat několik tlačítek panelu AddRange nástrojů pomocí metody .

Konstruktory

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

Vlastnosti

CanRaiseEvents	Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
DropDownMenu	Získá nebo nastaví nabídku k zobrazení v rozevíracím panelu nástrojů tlačítko.
Enabled	Získá nebo nastaví hodnotu označující, zda je tlačítko povoleno.
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
ImageIndex	Získá nebo nastaví hodnotu indexu obrázku přiřazeného k tlačítku.
ImageKey	Získá nebo nastaví název obrázku přiřazeného k tlačítku.
Name	Název tlačítka.
Parent	Získá ovládací prvek panelu nástrojů, ke kterému je přiřazeno tlačítko panelu nástrojů.
PartialPush	Získá nebo nastaví hodnotu označující, zda je tlačítko přepínacího panelu nástrojů částečně stisknuto.
Pushed	Získá nebo nastaví hodnotu označující, zda přepínací tlačítko styl panelu nástrojů je nyní v pushed stavu.
Rectangle	Získá ohraničující obdélník pro tlačítko panelu nástrojů.
Site	Získá nebo nastaví ISite z Component. (Zděděno od Component)
Style	Získá nebo nastaví styl tlačítka panelu nástrojů.
Tag	Získá nebo nastaví objekt, který obsahuje data o tlačítku panelu nástrojů.
Text	Získá nebo nastaví text zobrazený na tlačítku panelu nástrojů.
ToolTipText	Získá nebo nastaví text, který se zobrazí jako popis tlačítka.
Visible	Získá nebo nastaví hodnotu označující, zda je tlačítko panelu nástrojů viditelné.

Metody

CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané nástrojem ToolBarButton a volitelně uvolní spravované prostředky.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo .Container (Zděděno od Component)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
ToString()	Vrátí řetězec, který představuje ToolBarButton ovládací prvek.

Událost

Disposed

Vyvolá se, když je komponenta uvolněna voláním Dispose() metody .

(Zděděno od Component)

Platí pro

Sdílet prostřednictvím