ToolBar.ButtonSize-Eigenschaft

Ruft die Größe der Schaltflächen auf dem Symbolleisten-Steuerelement ab oder legt diese fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Property ButtonSize As Size
'Usage
Dim instance As ToolBar
Dim value As Size

value = instance.ButtonSize

instance.ButtonSize = value

[LocalizableAttribute(true)] 
public Size ButtonSize { get; set; }

[LocalizableAttribute(true)] 
public:
property Size ButtonSize {
    Size get ();
    void set (Size value);
}

/** @property */
public Size get_ButtonSize ()

/** @property */
public void set_ButtonSize (Size value)

public function get ButtonSize () : Size

public function set ButtonSize (value : Size)

Eigenschaftenwert

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 Pixel, sie ist jedoch mindestens so groß, dass das Image und der Text aufgenommen werden können.

Ausnahmen

Hinweise

Wenn die ButtonSize nicht festgelegt ist, wird sie auf den Standardwert festgelegt. Eine andere Möglichkeit ist die Berechnung von Size für die Aufnahme des größten Image und Textes, die den ToolBarButton-Steuerelementen zugewiesen sind.

Beispiel

Im folgenden Codebeispiel wird ein ToolBar-Steuerelement erstellt, einige seiner häufig verwendeten Eigenschaften werden festgelegt, und es wird einem Form hinzugefügt. Dem ButtonClick-Ereignis und dem ButtonDropDown-Ereignis werden auch Delegaten hinzugefügt. Für dieses Beispiel ist es erforderlich, dass eine ToolBar mit der Bezeichnung toolBar1 und eine ImageList mit der Bezeichnung imageList1 deklariert wurden.

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

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);
}

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.set_Appearance(System.Windows.Forms.ToolBarAppearance.Flat);
    toolBar1.set_BorderStyle(System.Windows.Forms.BorderStyle.None);
    toolBar1.get_Buttons().Add(this.toolBarButton1);
    toolBar1.set_ButtonSize(new System.Drawing.Size(24, 24));
    toolBar1.set_Divider(true);
    toolBar1.set_DropDownArrows(true);
    toolBar1.set_ImageList(this.imageList1);
    toolBar1.set_ShowToolTips(true);
    toolBar1.set_Size(new System.Drawing.Size(292, 25));
    toolBar1.set_TabIndex(0);
    toolBar1.set_TextAlign(System.Windows.Forms.ToolBarTextAlign.Right);
    toolBar1.set_Wrappable(false);
    // Add handlers for the ButtonClick and ButtonDropDown events.
    toolBar1.add_ButtonDropDown(new ToolBarButtonClickEventHandler
        (toolBar1_ButtonDropDown));
    toolBar1.add_ButtonClick(new ToolBarButtonClickEventHandler
        (toolBar1_ButtonClicked));
    // Add the toolbar to the form.
    this.get_Controls().Add(toolBar1);
} //AddToolBar

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ToolBar-Klasse
ToolBar-Member
System.Windows.Forms-Namespace
Size
ToolBarButton