IButtonControl Schnittstelle

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

public interface class IButtonControl

public interface IButtonControl

type IButtonControl = interface

Public Interface IButtonControl

Abgeleitet

System.Windows.Forms.Button

System.Windows.Forms.LinkLabel

Beispiele

Das folgende Beispiel erbt von der ButtonBase -Klasse und implementiert die IButtonControl -Schnittstelle. Die Implementierung wird der -Eigenschaft und den DialogResultNotifyDefault Methoden und PerformClick hinzugefügt.

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

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

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

Hinweise

Ein Beispiel für die Implementierung dieser Schnittstelle ist die Standard- und Abbrechen der Schaltflächenverarbeitung. Standardschaltflächen werden benachrichtigt, wenn eine nicht verarbeitete EINGABETASTE für ein Formular eingegeben wird, genau wie ein Dialogfeld geschlossen wird. Ebenso werden Abbrechen-Schaltflächen benachrichtigt, wenn ein nicht verarbeiteter ESC-Schlüssel in ein Formular eingegeben wird, ähnlich wie ein Dialogfeld geschlossen wird.

Hinweise für Ausführende

Implementieren Sie diese Schnittstelle in Klassen, die als Schaltflächensteuerelemente fungieren. Die Member dieser Schnittstelle stellen grundlegende Schaltflächenfunktionen bereit, z. B. die Bereitstellung einer DialogResult für das übergeordnete Formular oder die Möglichkeit, ein Click Ereignis auszuführen, oder als Standardschaltfläche eines Formulars zu fungieren.

Eigenschaften

DialogResult

Ruft den Wert ab, der beim Klicken auf die Schaltfläche an das übergeordnete Formular zurückgegeben wird, oder legt diesen fest.

Methoden

NotifyDefault(Boolean)	Benachrichtigt ein Steuerelement darüber, dass es als Standardschaltfläche fungiert, wodurch dessen Darstellung und Verhalten entsprechend angepasst werden.
PerformClick()	Generiert ein Click-Ereignis für das Steuerelement.

Weitere Informationen

• Button
• Form