AxHost.SetAboutBoxDelegate-Methode

Artikel
08/20/2007

Ruft die ShowAboutBox-Methode auf, um das Info-Dialogfeld des ActiveX-Steuerelements anzuzeigen.

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

Syntax

'Declaration
Protected Sub SetAboutBoxDelegate ( _
    d As AboutBoxDelegate _
)
'Usage
Dim d As AboutBoxDelegate

Me.SetAboutBoxDelegate(d)

protected void SetAboutBoxDelegate (
    AboutBoxDelegate d
)

protected:
void SetAboutBoxDelegate (
    AboutBoxDelegate^ d
)

protected void SetAboutBoxDelegate (
    AboutBoxDelegate d
)

protected function SetAboutBoxDelegate (
    d : AboutBoxDelegate
)

Parameter

d
Der aufzurufende AxHost.AboutBoxDelegate.

Hinweise

Die SetAboutBoxDelegate-Methode ermöglicht es auch abgeleiteten Klassen, die ShowAboutBox-Methode ohne Anfügen eines Delegaten zu behandeln. Dies ist das bevorzugte Verfahren für die Behandlung der ShowAboutBox-Methode in einer abgeleiteten Klasse.

Hinweise für Erben Wenn Sie den SetAboutBoxDelegate in einer abgeleiteten Klasse überschreiben, müssen Sie unbedingt die SetAboutBoxDelegate-Methode der Basisklasse aufrufen, sodass registrierte Delegaten die ShowAboutBox-Methode empfangen.

Beispiel

Im folgenden Codebeispiel werden der Konstruktor sowie die SetAboutBoxDelegate-Methode und die AttachInterfaces-Methode einer von AxHost abgeleiteten Klasse überschrieben, die das Masked Edit-ActiveX-Steuerelement von Microsoft umschließt. Für diesen Code ist es erforderlich, dass Sie den generierten Quellcode erstellt haben, indem Sie die Datei AxImp.exe mit der Datei MSMask32.ocx und dem /source-Schalter ausgeführt haben, um die zu bearbeitende Wrapperklasse zu generieren. Dieser Code wird in C#-Syntax angezeigt, da dies die einzige von AxImp.exe ausgegebene Sprache ist.

public AxMaskEdBox()
    :
  base("c932ba85-4374-101b-a56c-00aa003668dc") // The ActiveX control's class identifier.
{
    // Make the AboutBox method the about box delegate.
    this.SetAboutBoxDelegate(new AboutBoxDelegate(AboutBox));
}

public virtual void AboutBox()
{
    // If the instance of the ActiveX control is null when the AboutBox method 
    // is called, raise an InvalidActiveXStateException exception.
    if ((this.ocx == null))
    {
        throw new System.Windows.Forms.AxHost.InvalidActiveXStateException(
          "AboutBox", System.Windows.Forms.AxHost.ActiveXInvokeKind.MethodInvoke);
    }
    // Show the about box if the ActiveX control has one.
    if (this.HasAboutBox)
    {
        this.ocx.AboutBox();
    }
}

protected override void AttachInterfaces()
{
    try
    {
        // Attach the IMSMask interface to the ActiveX control.
        this.ocx = ((MSMask.IMSMask)(this.GetOcx()));
    }
    catch (System.Exception ex)
    {
        System.Console.WriteLine(ex.Message);
    }
}

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

AxHost-Klasse
AxHost-Member
System.Windows.Forms-Namespace
HasAboutBox
ShowAboutBox
AxHost.AboutBoxDelegate

Freigeben über