ToolBar.Appearance-Eigenschaft

Ruft den Wert ab, der die Darstellung eines Symbolleisten-Steuerelements und der zugehörigen Schaltflächen bestimmt, oder legt diesen fest.

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

Syntax

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

value = instance.Appearance

instance.Appearance = value

[LocalizableAttribute(true)] 
public ToolBarAppearance Appearance { get; set; }

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

/** @property */
public ToolBarAppearance get_Appearance ()

/** @property */
public void set_Appearance (ToolBarAppearance value)

public function get Appearance () : ToolBarAppearance

public function set Appearance (value : ToolBarAppearance)

Eigenschaftenwert

Einer der ToolBarAppearance-Werte. Der Standardwert ist ToolBarAppearance.Normal.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidEnumArgumentException	Der zugewiesene Wert ist keiner der ToolBarAppearance-Werte.

Hinweise

Die Appearance-Eigenschaft legt die Darstellung der Schaltflächen fest, die der Symbolleiste zugewiesen wurden. Wenn die Darstellung auf ToolBarAppearance.Normal festgelegt wurde, werden die Schaltflächen der Symbolleiste dreidimensional und angehoben dargestellt. Legen Sie für eine flache Darstellung der Symbolleisten-Schaltflächen die Appearance-Eigenschaft der Symbolleiste auf ToolBarAppearance.Flat fest. Sobald sich der Mauszeiger über den flachen Schaltflächen befindet, werden diese angehoben und dreidimensional dargestellt. Trennlinien auf einer ToolBar, deren Appearance-Eigenschaft auf Flat festgelegt ist, werden nicht als Zwischenräume, sondern als geätzte Linien zwischen den angehobenen Schaltflächen dargestellt. Durch die flachen Schaltflächen erhält die Anwendung ein Web-ähnlicheres Erscheinungsbild.

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
ToolBarAppearance