ToolBarButton Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje przycisk paska narzędzi systemu Windows.

Ta klasa nie jest dostępna na platformie .NET Core 3.1 i nowszych wersjach. Zamiast tego należy użyć ToolStripButton elementu , który zastępuje i rozszerza kontrolkę ToolBarButton .

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

public class ToolBarButton : System.ComponentModel.Component

type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

Dziedziczenie: Object

MarshalByRefObject

Component
ToolBarButton

Przykłady

Poniższy przykład kodu tworzy kontrolki ToolBar i trzy ToolBarButton . Przyciski paska narzędzi są przypisywane do kolekcji przycisków, kolekcja jest przypisywana do paska narzędzi, a pasek narzędzi jest dodawany do formularza. ButtonClick Na zdarzeniu paska narzędzi Button właściwość ToolBarButtonClickEventArgs jest oceniana i otwierane odpowiednie okno dialogowe. Ten kod wymaga utworzenia Form OpenFileDialogwszystkich elementów , , a SaveFileDialogi PrintDialog .

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

Uwagi

Ta klasa nie jest dostępna na platformie .NET Core 3.1 i nowszych wersjach. Zamiast tego użyj polecenia cmdlet ToolStripButton.

ToolBarButton kontrolki są nadrzędne za pomocą ToolBar kontrolek. Typowe właściwości ustawiane po utworzeniu przycisku paska narzędzi to Text i ImageIndex. Text Ustaw właściwość przycisku, aby wyświetlić tekst poniżej lub z prawej strony obrazu. Aby przypisać obrazy do przycisków, tworząc obiekt ImageList, przypisz go do ImageList właściwości paska narzędzi, a następnie przypisz wartość indeksu obrazu do ImageIndex właściwości przycisku.

Aby zmienić wygląd przycisków paska narzędzi przypisanych do paska narzędzi, ustaw Appearance właściwość nadrzędnego formantu paska narzędzi. Wygląd ToolBarAppearance.Flat daje przyciskom płaski wygląd. Gdy wskaźnik myszy przesuwa się nad przyciskami, ich wygląd zmienia się na trójwymiarowy. Separatory przycisków są wyświetlane jako linie, a nie spacje między przyciskami, gdy przyciski mają płaski wygląd. Appearance Jeśli właściwość jest ustawiona na ToolBarAppearance.Normal, przyciski pojawiają się podniesione i trójwymiarowe, a separatory są wyświetlane jako odstęp między przyciskami.

Możesz przypisać obiekt ContextMenu do przycisku, jeśli właściwość jest ustawiona Style na ToolBarButtonStyle.DropDownwartość . Po kliknięciu przycisku zostanie wyświetlone przypisane menu.

Aby utworzyć kolekcję ToolBarButton kontrolek do wyświetlenia na obiekcie ToolBar, dodaj przyciski pojedynczo przy użyciu Add metody Buttons właściwości . Alternatywnie można dodać kilka przycisków paska narzędzi przy użyciu AddRange metody .

Konstruktory

ToolBarButton()	Inicjuje nowe wystąpienie klasy ToolBarButton.
ToolBarButton(String)	Inicjuje ToolBarButton nowe wystąpienie klasy i wyświetla przypisany tekst na przycisku.

Właściwości

CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
DropDownMenu	Pobiera lub ustawia menu, które ma być wyświetlane na przycisku paska narzędzi listy rozwijanej.
Enabled	Pobiera lub ustawia wartość wskazującą, czy przycisk jest włączony.
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
ImageIndex	Pobiera lub ustawia wartość indeksu obrazu przypisanego do przycisku.
ImageKey	Pobiera lub ustawia nazwę obrazu przypisanego do przycisku.
Name	Nazwa przycisku.
Parent	Pobiera kontrolkę paska narzędzi, do której jest przypisany przycisk paska narzędzi.
PartialPush	Pobiera lub ustawia wartość wskazującą, czy przycisk paska narzędzi w stylu przełącznika jest częściowo wypychany.
Pushed	Pobiera lub ustawia wartość wskazującą, czy przycisk paska narzędzi w stylu przełącznika jest obecnie w stanie wypchnięcia.
Rectangle	Pobiera prostokąt ograniczenia dla przycisku paska narzędzi.
Site	Pobiera lub ustawia wartość ISite .Component (Odziedziczone po Component)
Style	Pobiera lub ustawia styl przycisku paska narzędzi.
Tag	Pobiera lub ustawia obiekt zawierający dane dotyczące przycisku paska narzędzi.
Text	Pobiera lub ustawia tekst wyświetlany na przycisku paska narzędzi.
ToolTipText	Pobiera lub ustawia tekst wyświetlany jako etykietka narzędzia dla przycisku.
Visible	Pobiera lub ustawia wartość wskazującą, czy przycisk paska narzędzi jest widoczny.

Metody

CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element ToolBarButton i opcjonalnie zwalnia zasoby zarządzane.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt, który reprezentuje usługę dostarczaną przez Component obiekt lub przez element Container. (Odziedziczone po Component)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
ToString()	Zwraca ciąg reprezentujący kontrolkę ToolBarButton .

Zdarzenia

Disposed

Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody .

(Odziedziczone po Component)

Dotyczy

Udostępnij za pośrednictwem