ToolBarButton Kelas

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili tombol bilah alat Windows.

Kelas ini tidak tersedia di .NET Core 3.1 dan versi yang lebih baru. Gunakan ToolStripButton sebagai gantinya, yang menggantikan dan memperluas ToolBarButton kontrol.

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

public class ToolBarButton : System.ComponentModel.Component

type ToolBarButton = class
    inherit Component

Public Class ToolBarButton
Inherits Component

Warisan: Object

MarshalByRefObject

Component
ToolBarButton

Contoh

Contoh kode berikut membuat ToolBar dan tiga ToolBarButton kontrol. Tombol toolbar ditetapkan ke koleksi tombol, koleksi ditetapkan ke toolbar, dan toolbar ditambahkan ke formulir. ButtonClick Pada peristiwa toolbar, Button properti dievaluasi ToolBarButtonClickEventArgs dan kotak dialog yang sesuai dibuka. Kode ini mengharuskan bahwa Form, OpenFileDialog, a SaveFileDialog, dan PrintDialog semuanya telah dibuat.

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

Keterangan

Kelas ini tidak tersedia di .NET Core 3.1 dan versi yang lebih baru. Gunakan ToolStripButton sebagai gantinya.

ToolBarButton kontrol diinduk oleh ToolBar kontrol. Properti umum yang akan diatur setelah tombol toolbar dibuat adalah Text dan ImageIndex. Atur Text properti tombol untuk menampilkan teks di bawah atau di sebelah kanan gambar. Untuk menetapkan gambar ke tombol dengan membuat ImageList, menetapkannya ke ImageList properti toolbar; lalu tetapkan nilai indeks gambar ke ImageIndex properti tombol .

Untuk mengubah tampilan tombol toolbar yang ditetapkan ke toolbar, atur Appearance properti kontrol toolbar induk. Penampilan memberi ToolBarAppearance.Flat tombol penampilan datar. Saat penunjuk mouse bergerak di atas tombol, penampilannya berubah menjadi tiga dimensi. Pemisah tombol muncul sebagai garis daripada spasi di antara tombol saat tombol memiliki tampilan datar. Appearance Jika properti diatur ke ToolBarAppearance.Normal, tombol muncul dinaikkan dan tiga dimensi, dan pemisah muncul sebagai celah di antara tombol.

Anda dapat menetapkan ContextMenu ke tombol jika Style properti diatur ke ToolBarButtonStyle.DropDown. Saat tombol diklik, menu yang ditetapkan akan ditampilkan.

Untuk membuat kumpulan ToolBarButton kontrol untuk ditampilkan pada ToolBar, tambahkan tombol satu per satu dengan menggunakan Add metode Buttons properti . Atau, Anda dapat menambahkan beberapa tombol toolbar menggunakan metode .AddRange

Konstruktor

ToolBarButton()	Menginisialisasi instans baru kelas ToolBarButton.
ToolBarButton(String)	Menginisialisasi instans ToolBarButton baru kelas dan menampilkan teks yang ditetapkan pada tombol .

Properti

CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
DropDownMenu	Mendapatkan atau mengatur menu yang akan ditampilkan di tombol toolbar drop-down.
Enabled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah tombol diaktifkan.
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
ImageIndex	Mendapatkan atau mengatur nilai indeks gambar yang ditetapkan ke tombol .
ImageKey	Mendapatkan atau mengatur nama gambar yang ditetapkan ke tombol .
Name	Nama tombol.
Parent	Mendapatkan kontrol bilah alat tempat tombol toolbar ditetapkan.
PartialPush	Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol toolbar gaya tombol alih sebagian didorong.
Pushed	Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol toolbar gaya tombol alih saat ini dalam status didorong.
Rectangle	Mendapatkan persegi panjang pembatas untuk tombol toolbar.
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
Style	Mendapatkan atau mengatur gaya tombol toolbar.
Tag	Mendapatkan atau mengatur objek yang berisi data tentang tombol toolbar.
Text	Mendapatkan atau mengatur teks yang ditampilkan pada tombol toolbar.
ToolTipText	Mendapatkan atau mengatur teks yang muncul sebagai TipsAlat untuk tombol .
Visible	Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol toolbar terlihat.

Metode

CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang ToolBarButton digunakan oleh dan secara opsional merilis sumber daya terkelola.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Kedaluwarsa. Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
ToString()	Mengembalikan string yang mewakili ToolBarButton kontrol.

Acara

Disposed

Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode .

(Diperoleh dari Component)

Berlaku untuk

Bagikan melalui