AxHost.AboutBoxDelegate デリゲート

.NET Framework クラス ライブラリ リファレンス

AxHost.AboutBoxDelegate デリゲート

ActiveX コントロールの [バージョン情報] ダイアログ ボックスを表示するメソッドを表します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Protected Delegate Sub AboutBoxDelegate
 ()

Visual Basic (使用法)

Dim instance As New AboutBoxDelegate(AddressOf
 HandlerMethod)

C#

protected delegate void AboutBoxDelegate ()

C++

private delegate void AboutBoxDelegate ()

J#

/** @delegate */
protected delegate void AboutBoxDelegate ()

JScript

JScript では、デリゲートは使用できますが、新規に宣言することはできません。

解説

The AxHost.AboutBoxDelegate を使用すると、ActiveX コントロールの [バージョン情報] ボックスが表示されるときに通知を受け取ることができます。デリゲート メソッドに追加したコードは、[バージョン情報] ボックスが表示される前に実行されます。

AxHost.AboutBoxDelegate デリゲートを作成するときに、ActiveX コントロールの [バージョン情報] ダイアログ ボックスが存在する場合は、その表示を処理するメソッドを識別します。メソッドをハンドラに関連付けるには、デリゲートのインスタンスをメソッドに追加します。デリゲートを削除しない限り、メソッドを呼び出すと常にハンドラが呼び出されます。デリゲートの詳細については、「イベントとデリゲート」を参照してください。

使用例

Microsoft Masked Edit ActiveX コントロールをラップする AxHost の派生クラスのコンストラクタ、SetAboutBoxDelegate メソッド、および AttachInterfaces メソッドをオーバーライドする例を次に示します。このコードは、MSMask32.ocx ファイル上で /source スイッチを使用して AxImp.exe を実行し、編集対象となるラッパー クラスを生成することで、生成されるソース コードを作成済みであることを前提としています。AxImp.exe の出力言語は C# だけなので、ここでは C# 構文のコードだけを示します。

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
System.Windows.Forms 名前空間
SetAboutBoxDelegate
ShowAboutBox
AxHost.HasAboutBox プロパティ