Button-Klasse

Artikel
08/20/2007

Stellt ein Schaltflächen-Steuerelement von Windows dar.

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

Syntax

'Declaration
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class Button
    Inherits ButtonBase
    Implements IButtonControl
'Usage
Dim instance As Button

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
public class Button : ButtonBase, IButtonControl

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
public ref class Button : public ButtonBase, IButtonControl

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class Button extends ButtonBase implements IButtonControl

ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class Button extends ButtonBase implements IButtonControl

Hinweise

Wenn die Schaltfläche den Fokus hat, können Sie auf Button mit der Maus klicken oder entsprechend die EINGABETASTE oder die LEERTASTE drücken.

Legen Sie die AcceptButton-Eigenschaft oder die CancelButton-Eigenschaft von Form fest, um Benutzern das Klicken auf eine Schaltfläche durch Drücken der EINGABETASTE oder von ESC selbst dann zu ermöglichen, wenn die Schaltfläche den Fokus nicht besitzt. Hierdurch wird dem Formular das Verhalten eines Dialogfelds zugewiesen.

Beim Anzeigen eines Formulars mit der ShowDialog-Methode können Sie mithilfe der DialogResult-Eigenschaft einer Schaltfläche den Rückgabewert von ShowDialog angeben.

Sie können die Darstellung der Schaltfläche ändern. Wenn die Schaltfläche beispielsweise für eine Webansicht flach dargestellt werden soll, legen Sie die FlatStyle-Eigenschaft auf FlatStyle.Flat fest. Die FlatStyle-Eigenschaft kann auch auf FlatStyle.Popup festgelegt werden, sodass die Schaltfläche flach dargestellt ist, bis der Mauszeiger darüber geführt wird. Erst dann wird die Schaltfläche in der Standarddarstellung von Windows-Schaltflächen angezeigt.

Hinweis

Wenn das Steuerelement, das den Fokus besitzt, das Drücken der EINGABETASTE akzeptiert und verarbeitet, erfolgt keine Verarbeitung durch Button. Wenn beispielsweise eine mehrzeilige TextBox oder eine andere Schaltfläche den Fokus besitzt, wird das Drücken der EINGABETASTE nicht durch die Bestätigungsschaltfläche, sondern durch dieses Steuerelement verarbeitet.

Beispiel

Im folgenden Codebeispiel wird ein Button erstellt. Seine DialogResult-Eigenschaft wird auf DialogResult.OK festgelegt, und er wird einem Form hinzugefügt.

Private Sub InitializeMyButton()
    ' Create and initialize a Button.
    Dim button1 As New Button()
    
    ' Set the button to return a value of OK when clicked.
    button1.DialogResult = DialogResult.OK
    
    ' Add the button to the form.
    Controls.Add(button1)
End Sub 'InitializeMyButton

private void InitializeMyButton()
 {
    // Create and initialize a Button.
    Button button1 = new Button();
 
    // Set the button to return a value of OK when clicked.
    button1.DialogResult = DialogResult.OK;
 
    // Add the button to the form.
    Controls.Add(button1);
 }

private:
   void InitializeMyButton()
   {
      // Create and initialize a Button.
      Button^ button1 = gcnew Button;
      
      // Set the button to return a value of OK when clicked.
      button1->DialogResult = ::DialogResult::OK;
      
      // Add the button to the form.
      Controls->Add( button1 );
   }

private void InitializeMyButton()
{
    // Create and initialize a Button.
    Button button1 = new Button();
    
    // Set the button to return a value of OK when clicked.
    button1.set_DialogResult(get_DialogResult().OK);
    
    // Add the button to the form.
    get_Controls().Add(button1);
} //InitializeMyButton

private function InitializeMyButton()
 {
    // Create and initialize a Button.
    var button1 : Button = new Button();
 
    // Set the button to return a value of OK when clicked.
    button1.DialogResult = System.Windows.Forms.DialogResult.OK;
 
    // Add the button to the form.
    Controls.Add(button1);
 }

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
         System.Windows.Forms.ButtonBase
          System.Windows.Forms.Button

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Button-Member
System.Windows.Forms-Namespace
ButtonBase
RadioButton
CheckBox
IButtonControl

Freigeben über