ToolBar.ButtonSize Eigenschaft

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
ToolBar.cs
Quelle:
ToolBar.cs

Dient zum Abrufen oder Festlegen der Größe der Schaltflächen im Symbolleistensteuerelement.

public:
 property System::Drawing::Size ButtonSize { System::Drawing::Size get(); void set(System::Drawing::Size value); };
public System.Drawing.Size ButtonSize { get; set; }
member this.ButtonSize : System.Drawing.Size with get, set
Public Property ButtonSize As Size

Eigenschaftswert

Size

Ein Size Objekt, das die Größe der ToolBarButton Steuerelemente auf der Symbolleiste darstellt. Die Standardgröße hat eine Breite von 24 Pixel und eine Höhe von 22 Pixeln oder groß genug, um den und den Image Text aufzunehmen, je nachdem, welcher Wert größer ist.

Ausnahmen

ArgumentException

Die Width Eigenschaft Height des Size Objekts ist kleiner als 0.

Beispiele

Das folgende Codebeispiel erstellt ein ToolBar Steuerelement, legt einige seiner allgemeinen Eigenschaften fest und fügt es zu einem Form. Stellvertretungen werden auch zu den ButtonClick Ereignissen ButtonDropDown und Ereignissen hinzugefügt. In diesem Beispiel muss ein ToolBar Benannter toolBar1 und ein ImageList Benannter imageList1 deklariert werden.

void AddToolBar()
{
   
   // Add a toolbar and set some of its properties.
   toolBar1 = gcnew ToolBar;
   toolBar1->Appearance = System::Windows::Forms::ToolBarAppearance::Flat;
   toolBar1->BorderStyle = System::Windows::Forms::BorderStyle::None;
   toolBar1->Buttons->Add( this->toolBarButton1 );
   toolBar1->ButtonSize = System::Drawing::Size( 24, 24 );
   toolBar1->Divider = true;
   toolBar1->DropDownArrows = true;
   toolBar1->ImageList = this->imageList1;
   toolBar1->ShowToolTips = true;
   toolBar1->Size = System::Drawing::Size( 292, 25 );
   toolBar1->TabIndex = 0;
   toolBar1->TextAlign = System::Windows::Forms::ToolBarTextAlign::Right;
   toolBar1->Wrappable = false;
   
   // Add handlers for the ButtonClick and ButtonDropDown events.
   toolBar1->ButtonDropDown += gcnew ToolBarButtonClickEventHandler( this, &MyToolBar::toolBar1_ButtonDropDown );
   toolBar1->ButtonClick += gcnew ToolBarButtonClickEventHandler( this, &MyToolBar::toolBar1_ButtonClicked );
   
   // Add the toolbar to the form.
   this->Controls->Add( toolBar1 );
}

private void AddToolBar()
{
   // Add a toolbar and set some of its properties.
   toolBar1 = new ToolBar();
   toolBar1.Appearance = System.Windows.Forms.ToolBarAppearance.Flat;
   toolBar1.BorderStyle = System.Windows.Forms.BorderStyle.None;
   toolBar1.Buttons.Add(this.toolBarButton1);
   toolBar1.ButtonSize = new System.Drawing.Size(24, 24);
   toolBar1.Divider = true;
   toolBar1.DropDownArrows = true;
   toolBar1.ImageList = this.imageList1;
   toolBar1.ShowToolTips = true;
   toolBar1.Size = new System.Drawing.Size(292, 25);
   toolBar1.TabIndex = 0;
   toolBar1.TextAlign = System.Windows.Forms.ToolBarTextAlign.Right;
   toolBar1.Wrappable = false;
   
   // Add handlers for the ButtonClick and ButtonDropDown events.
   toolBar1.ButtonDropDown += 
     new ToolBarButtonClickEventHandler(toolBar1_ButtonDropDown);
   toolBar1.ButtonClick += 
     new ToolBarButtonClickEventHandler(toolBar1_ButtonClicked);

   // Add the toolbar to the form.
   this.Controls.Add(toolBar1);
}

Private Sub AddToolBar()
   ' Add a toolbar and set some of its properties.
   toolBar1 = New ToolBar()
   toolBar1.Appearance = System.Windows.Forms.ToolBarAppearance.Flat
   toolBar1.BorderStyle = System.Windows.Forms.BorderStyle.None
   toolBar1.Buttons.Add(Me.toolBarButton1)
   toolBar1.ButtonSize = New System.Drawing.Size(24, 24)
   toolBar1.Divider = True
   toolBar1.DropDownArrows = True
   toolBar1.ImageList = Me.imageList1
   toolBar1.ShowToolTips = True
   toolBar1.Size = New System.Drawing.Size(292, 25)
   toolBar1.TabIndex = 0
   toolBar1.TextAlign = System.Windows.Forms.ToolBarTextAlign.Right
   toolBar1.Wrappable = False

   ' Add handlers for the ButtonClick and ButtonDropDown events.
   AddHandler toolBar1.ButtonDropDown, AddressOf toolBar1_ButtonDropDown
   AddHandler toolBar1.ButtonClick, AddressOf toolBar1_ButtonClicked

   ' Add the toolbar to the form.
   Me.Controls.Add(toolBar1)
End Sub

Hinweise

Wenn der ButtonSize Wert nicht festgelegt ist, wird er auf seine Standardeinstellung festgelegt. Alternativ wird ein Size Berechnet, um den größten Image und dem Steuerelement zugewiesenen ToolBarButton Text aufzunehmen.

Gilt für:

Weitere Informationen