ToolBarButton Sınıf

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Bir Windows araç çubuğu düğmesini temsil eder.

Bu sınıf .NET Core 3.1 ve sonraki sürümlerde kullanılamaz. Bunun yerine, denetimin yerini alan ve genişleten öğesini ToolBarButton kullanınToolStripButton.

public ref class ToolBarButton : System::ComponentModel::Component
public class ToolBarButton : System.ComponentModel.Component
type ToolBarButton = class
    inherit Component
Public Class ToolBarButton
Inherits Component
Devralma
Object
MarshalByRefObject
Component
ToolBarButton

Örnekler

Aşağıdaki kod örneği bir ToolBar ve üç ToolBarButton denetim oluşturur. Araç çubuğu düğmeleri düğme koleksiyonuna atanır, koleksiyon araç çubuğuna atanır ve araç çubuğu forma eklenir. ButtonClick Araç çubuğunun olayında öğesinin ButtonToolBarButtonClickEventArgs özelliği değerlendirilir ve uygun iletişim kutusu açılır. Bu kod için , FormOpenFileDialogSaveFileDialogve PrintDialog değerlerinin tümünün oluşturulması gerekir.

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

Açıklamalar

Bu sınıf .NET Core 3.1 ve sonraki sürümlerde kullanılamaz. Bunun yerine ToolStripButton kullanın.

ToolBarButton denetimlerin üst öğesi ToolBar denetimlerdir. Araç çubuğu düğmesi oluşturulduktan sonra ayarlanacağı ortak özellikler ve ImageIndexşeklindedirText. Text Resmin altındaki veya sağındaki metni görüntülemek için düğmenin özelliğini ayarlayın. bir ImageListoluşturarak düğmelere görüntü atamak için, bunu araç çubuğunun ImageList özelliğine atayın ve ardından düğmenin ImageIndex özelliğine görüntü dizini değerini atayın.

Araç çubuğuna atanan araç çubuğu düğmelerinin görünümünü değiştirmek için üst araç çubuğu denetiminin özelliğini ayarlayın Appearance . Görünüm, ToolBarAppearance.Flat düğmelere düz bir görünüm verir. Fare işaretçisi düğmelerin üzerinde hareket ettikçe, bunların görünümü üç boyutluya dönüşür. Düğme ayırıcıları, düğmeler düz bir görünüme sahip olduğunda düğmeler arasında boşluklar yerine çizgiler olarak görünür. Appearance özelliği olarak ToolBarAppearance.Normalayarlanırsa, düğmeler yükseltilmiş ve üç boyutlu görünür ve ayırıcılar düğmeler arasında bir boşluk olarak görünür.

Özelliği olarak ayarlandıysa Style bir düğmeye ToolBarButtonStyle.DropDownatayabilirsinizContextMenu. Düğmeye tıklandığında, atanan menü görüntülenir.

üzerinde ToolBargörüntülenecek bir denetim koleksiyonu ToolBarButton oluşturmak için özelliğinin yöntemini Buttons kullanarak Add düğmeleri tek tek ekleyin. Alternatif olarak, yöntemini kullanarak AddRange birkaç araç çubuğu düğmesi ekleyebilirsiniz.

Oluşturucular

ToolBarButton()

ToolBarButton sınıfının yeni bir örneğini başlatır.
ToolBarButton(String)

Sınıfının yeni bir örneğini ToolBarButton başlatır ve atanan metni düğmede görüntüler.

Özellikler

CanRaiseEvents

Bileşenin bir olay oluşturup oluşturamayacağını belirten bir değer alır.

(Devralındığı yer: Component)
Container

öğesini IContainer içeren öğesini Componentalır.

(Devralındığı yer: Component)
DesignMode

öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır.

(Devralındığı yer: Component)
DropDownMenu

Açılan araç çubuğu düğmesinde görüntülenecek menüyü alır veya ayarlar.
Enabled

Düğmenin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.
Events

Bu Componentöğesine eklenen olay işleyicilerinin listesini alır.

(Devralındığı yer: Component)
ImageIndex

Düğmeye atanan görüntünün dizin değerini alır veya ayarlar.
ImageKey

Düğmeye atanan görüntünün adını alır veya ayarlar.
Name

Düğmenin adı.
Parent

Araç çubuğu düğmesinin atandığı araç çubuğu denetimini alır.
PartialPush

Geçiş stili araç çubuğu düğmesinin kısmen gönderilip gönderilmediğini belirten bir değer alır veya ayarlar.
Pushed

Geçiş stilindeki araç çubuğu düğmesinin şu anda gönderildi durumunda olup olmadığını belirten bir değer alır veya ayarlar.
Rectangle

Araç çubuğu düğmesinin sınırlayıcı dikdörtgenini alır.
Site

öğesini alır veya ayarlar ISiteComponent.

(Devralındığı yer: Component)
Style

Araç çubuğu düğmesinin stilini alır veya ayarlar.
Tag

Araç çubuğu düğmesiyle ilgili verileri içeren nesneyi alır veya ayarlar.
Text

Araç çubuğu düğmesinde görüntülenen metni alır veya ayarlar.
ToolTipText

Düğme için Araç İpucu olarak görünen metni alır veya ayarlar.
Visible

Araç çubuğu düğmesinin görünür olup olmadığını belirten bir değer alır veya ayarlar.

Yöntemler

CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur.

(Devralındığı yer: MarshalByRefObject)
Dispose()

Component tarafından kullanılan tüm kaynakları serbest bırakır.

(Devralındığı yer: Component)
Dispose(Boolean)

ToolBarButton tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetLifetimeService()
Geçersiz.

Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır.

(Devralındığı yer: MarshalByRefObject)
GetService(Type)

veya tarafından ComponentContainersağlanan bir hizmeti temsil eden bir nesnesi döndürür.

(Devralındığı yer: Component)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
InitializeLifetimeService()
Geçersiz.

Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır.

(Devralındığı yer: MarshalByRefObject)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur.

(Devralındığı yer: MarshalByRefObject)
ToString()

Denetimi temsil ToolBarButton eden bir dize döndürür.

Ekinlikler

Disposed

Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir.

(Devralındığı yer: Component)

Şunlara uygulanır

Ayrıca bkz.