IButtonControl-Schnittstelle

Ermöglicht es einem Steuerelement, als Schaltfläche in einem Formular zu fungieren.

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

Syntax

'Declaration
Public Interface IButtonControl
'Usage
Dim instance As IButtonControl

public interface IButtonControl

public interface class IButtonControl

public interface IButtonControl

public interface IButtonControl

Hinweise

Ein Beispiel für eine mögliche Implementierung dieser Schnittstelle ist die Verarbeitung von Standardschaltflächen oder einer Schaltfläche Abbrechen. An Standardschaltflächen wird eine Meldung gesendet, wenn das Drücken der EINGABETASTE in einem Formular nicht verarbeitet wurde, beispielsweise für das Schließen eines Dialogfelds. In ähnlicher Weise wird eine Meldung an Schaltflächen zum Abbrechen gesendet, wenn das Drücken von ESC in einem Formular nicht verarbeitet wurde, z. B. bei Abbruch eines Dialogfelds durch den Benutzer.

Hinweise für Implementierer Implementieren Sie diese Schnittstelle in Klassen, die als Schaltflächen fungieren. Die Member dieser Schnittstelle stellen die grundlegenden Funktionen für Schaltflächen bereit. Beispielsweise wird ein DialogResult für das übergeordnete Formular bereitgestellt, die Ausführung von Click-Ereignissen oder die Festlegung als Standardschaltfläche in einem Formular ermöglicht.

Beispiel

Im folgenden Beispiel wird die ButtonBase-Klasse vererbt und die IButtonControl-Schnittstelle implementiert. Der DialogResult-Eigenschaft und der NotifyDefault-Methode sowie der PerformClick-Methode wird eine Implementierung hinzugefügt.

Imports System
Imports System.Windows.Forms
Imports System.Drawing


Public Class MyButton
   Inherits ButtonBase
   Implements IButtonControl 
   Private myDialogResult As DialogResult
      
   Public Sub New()
      ' Make the button White and a Popup style
      ' so it can be distinguished on the form.
      Me.FlatStyle = FlatStyle.Popup
      Me.BackColor = Color.White
   End Sub
   
   ' Add implementation to the IButtonControl.DialogResult property.
   Public Property DialogResult() As DialogResult Implements IButtonControl.DialogResult
      Get
         Return Me.myDialogResult
      End Get
      
      Set
         If [Enum].IsDefined(GetType(DialogResult), value) Then
            Me.myDialogResult = value
         End If
      End Set
   End Property
   
   ' Add implementation to the IButtonControl.NotifyDefault method.
   Public Sub NotifyDefault(value As Boolean) Implements IButtonControl.NotifyDefault
      If Me.IsDefault <> value Then
         Me.IsDefault = value
      End If
   End Sub 
      
   ' Add implementation to the IButtonControl.PerformClick method.
   Public Sub PerformClick() Implements IButtonControl.PerformClick
      If Me.CanSelect Then
         Me.OnClick(EventArgs.Empty)
      End If
   End Sub

End Class

using System;
using System.Windows.Forms;
using System.Drawing;

public class MyButton : ButtonBase, IButtonControl
{
    private DialogResult myDialogResult;

    public MyButton()
    {
        // Make the button White and a Popup style
        // so it can be distinguished on the form.
        this.FlatStyle = FlatStyle.Popup;
        this.BackColor = Color.White;
    }
        
    // Add implementation to the IButtonControl.DialogResult property.
    public DialogResult DialogResult
    {
        get
        {
            return this.myDialogResult;
        }

        set
        {
            if(Enum.IsDefined(typeof(DialogResult), value))             
            {
                this.myDialogResult = value;
            }
        }   
    }

    // Add implementation to the IButtonControl.NotifyDefault method.
    public void NotifyDefault(bool value)
    {
        if(this.IsDefault != value)
        {
            this.IsDefault = value;
        }
    }

    // Add implementation to the IButtonControl.PerformClick method.
    public void PerformClick()
    {
        if(this.CanSelect)
        {
            this.OnClick(EventArgs.Empty);
        }
    }
}

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;
using namespace System::Drawing;

public ref class MyButton: public ButtonBase, public IButtonControl
{
private:
   System::Windows::Forms::DialogResult myDialogResult;

public:
   MyButton()
   {
      // Make the button White and a Popup style
      // so it can be distinguished on the form.
      this->FlatStyle = ::FlatStyle::Popup;
      this->BackColor = Color::White;
   }

   property System::Windows::Forms::DialogResult DialogResult 
   {
      // Add implementation to the IButtonControl.DialogResult property.
      virtual System::Windows::Forms::DialogResult get()
      {
         return this->myDialogResult;
      }

      virtual void set( System::Windows::Forms::DialogResult value )
      {
         if ( Enum::IsDefined( System::Windows::Forms::DialogResult::typeid, value ) )
         {
            this->myDialogResult = value;
         }
      }
   }

   // Add implementation to the IButtonControl.NotifyDefault method.
   virtual void NotifyDefault( bool value )
   {
      if ( this->IsDefault != value )
      {
         this->IsDefault = value;
      }
   }

   // Add implementation to the IButtonControl.PerformClick method.
   virtual void PerformClick()
   {
      if ( this->CanSelect )
      {
         this->OnClick( EventArgs::Empty );
      }
   }
};

import System.*;
import System.Windows.Forms.*;
import System.Drawing.*;

public class MyButton extends ButtonBase implements IButtonControl
{
    private DialogResult myDialogResult;

    public MyButton()
    {
        // Make the button White and a Popup style
        // so it can be distinguished on the form.
        this.set_FlatStyle(get_FlatStyle().Popup);
        this.set_BackColor(Color.get_White());
    } //MyButton

    // Add implementation to the IButtonControl.DialogResult property.
    /** @property 
     */
    public DialogResult get_DialogResult()
    {
        return this.myDialogResult;
    } //get_DialogResult

    /** @property 
     */
    public void set_DialogResult(DialogResult value)
    {
        if (Enum.IsDefined(get_DialogResult().getClass().ToType(), value)) {
            this.myDialogResult = value;
        }
    }

    // Add implementation to the IButtonControl.NotifyDefault method.
    public void NotifyDefault(boolean value)
    {
        if (this.get_IsDefault() != value) {
            this.set_IsDefault(value);
        }
    } //NotifyDefault

    // Add implementation to the IButtonControl.PerformClick method.
    public void PerformClick()
    {
        if (this.get_CanSelect()) {
            this.OnClick(EventArgs.Empty);
        }
    } //PerformClick
} //MyButton

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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

IButtonControl-Member
System.Windows.Forms-Namespace
Button-Klasse
Form-Klasse