NativeWindow.CreateHandle メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

NativeWindow.CreateHandle メソッド

作成パラメータを指定してウィンドウとそのハンドルを作成します。

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

Visual Basic (宣言)

Public Overridable Sub CreateHandle
 ( _
    cp As CreateParams _
)

Visual Basic (使用法)

Dim instance As NativeWindow
Dim cp As CreateParams

instance.CreateHandle(cp)

public virtual void CreateHandle (
    CreateParams cp
)

C++

public:
virtual void CreateHandle (
    CreateParams^ cp
)

public void CreateHandle (
    CreateParams cp
)

JScript

public function CreateHandle (
    cp : CreateParams
)

パラメータ

cp: ウィンドウの作成パラメータを指定する CreateParams。

例外

例外の種類	条件
OutOfMemoryException	ネイティブウィンドウを作成しようとしたときに、オペレーティングシステムでリソース不足が発生しました。
Win32Exception	Win32 ネイティブ API が指定されたウィンドウを作成できませんでした。
InvalidOperationException	現在のネイティブウィンドウのハンドルが既に割り当てられています。つまり、Handle プロパティが Zero ではありません。

解説

cp パラメータは、ウィンドウとそのハンドルを作成するために Win32 のネイティブな CreateWindowEx メソッドに渡される値を指定します。

ClassName フィールドが null 参照 (Visual Basic では Nothing) ではない場合、新しく作成されるウィンドウハンドルは、指定したクラスから継承します。たとえば、ClassName を BUTTON に設定した場合、Win32 の BUTTON ウィンドウクラスに基づいた新しいウィンドウが作成されます。ClassName オブジェクトの Param プロパティは、null 参照 (Visual Basic では Nothing) または構造体として宣言されたクラスのインスタンスへの参照のいずれかである必要があります。

このコードは、NativeWindow クラスの概要で紹介されている例からの抜粋です。簡略にするため、コードの一部は示されていません。コード全体については、NativeWindow を参照してください。

メモ
指定したクラス名は、オペレーティングシステムで登録されます。

使用例

特定のオペレーティングシステムウィンドウクラス名を使用してウィンドウを作成するコード例を次に示します。この例では、これを達成するために、NativeWindow から継承するクラスを作成します。

MyNativeWindow クラスは、ClassName が BUTTON に設定された新しいウィンドウを作成します。これは Win32 ボタンウィンドウを作成します。ボタンの位置とサイズは、追加のウィンドウスタイルと併せて設定されます。このクラスは、CreateHandle メソッドを使用し、WndProc メソッドをオーバーライドして、受信されたウィンドウメッセージを受け取る方法を示しています。この例では WM_ACTIVATEAPP メッセージを処理していますが、実際のプログラムでは、作成した型に対応するウィンドウメッセージを使用できます。

メモ
コントロールの種類によっては、ウィンドウではなく、ウィンドウの親にウィンドウメッセージを送信します。詳細については、Windows プラットフォーム SDK を参照してください。

C++

// MyNativeWindow class to create a window given a class name.
ref class MyNativeWindow: public NativeWindow
{
private:

   // Constant values were found in the S"windows.h" header
 file.
   literal int WS_CHILD = 0x40000000,WS_VISIBLE = 0x10000000,WM_ACTIVATEAPP
 = 0x001C;
   int windowHandle;

public:
   MyNativeWindow( Form^ parent )
   {
      CreateParams^ cp = gcnew CreateParams;

      // Fill in the CreateParams details.
      cp->Caption = "Click here";
      cp->ClassName = "Button";

      // Set the position on the form
      cp->X = 100;
      cp->Y = 100;
      cp->Height = 100;
      cp->Width = 100;

      // Specify the form as the parent.
      cp->Parent = parent->Handle;

      // Create as a child of the specified parent
      cp->Style = WS_CHILD | WS_VISIBLE;

      // Create the actual window
      this->CreateHandle( cp );
   }

protected:

   // Listen to when the handle changes to keep the variable in sync

   virtual void OnHandleChange() override
   {
      windowHandle = (int)this->Handle;
   }

   virtual void WndProc( Message % m ) override
   {
      // Listen for messages that are sent to the button window. Some
 messages are sent
      // to the parent window instead of the button's window.
      switch ( m.Msg )
      {
         case WM_ACTIVATEAPP:
            
            // Do something here in response to messages
            break;
      }
      NativeWindow::WndProc( m );
   }
};

// MyNativeWindow class to create a window given a class name.
/** @attribute SecurityPermissionAttribute(SecurityAction.Demand, Flags=SecurityPermissionFlag.UnmanagedCode)
 */
public class MyNativeWindow extends NativeWindow
{
    // Constant values were found in the "windows.h" header
 file.
    private int WS_CHILD = 0x40000000;
    private int WS_VISIBLE = 0x10000000;
    private int WM_ACTIVATEAPP = 0x1C;
    private int windowHandle;

    public MyNativeWindow(Form parent)
    {
        CreateParams cp = new CreateParams();

        // Fill in the CreateParams details.
        cp.set_Caption("Click here");
        cp.set_ClassName("Button");

        // Set the position on the form
        cp.set_X(100);
        cp.set_Y(100);
        cp.set_Height(100);
        cp.set_Width(100);

        // Specify the form as the parent.
        cp.set_Parent(parent.get_Handle());

        // Create as a child of the specified parent
        cp.set_Style(WS_CHILD | WS_VISIBLE);

        // Create the actual window
        this.CreateHandle(cp);
    } //MyNativeWindow

    // Listen to when the handle changes to keep the variable in sync
    protected void OnHandleChange()
    {
        windowHandle = this.get_Handle().ToInt32();
    } //OnHandleChange

    protected void WndProc(Message m)
    {
        // Listen for messages that are sent to the button window. 
        // Some messages are sent to the parent window 
        // instead of the button's window.
        if (m.get_Msg() == WM_ACTIVATEAPP) {
            // Do something here in response to messages
        }
        super.WndProc(m);
    } //WndProc
} //MyNativeWindow