Control.ProcessKeyPreview メソッド

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

Control.ProcessKeyPreview メソッド

キーボード メッセージをプレビューします。

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

Visual Basic (宣言)

Protected Overridable Function
 ProcessKeyPreview ( _
    ByRef m As Message _
) As Boolean

Visual Basic (使用法)

Dim m As Message
Dim returnValue As Boolean

returnValue = Me.ProcessKeyPreview(m)

C#

protected virtual bool ProcessKeyPreview (
    ref Message m
)

C++

protected:
virtual bool ProcessKeyPreview (
    Message% m
)

J#

protected boolean ProcessKeyPreview (
    /** @ref */ Message m
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

m

処理するウィンドウ メッセージを表す、参照渡しされた Message。

戻り値
メッセージがコントロールによって処理された場合は true。それ以外の場合は false。

解説

このメソッドは、子コントロールがキーボードによるメッセージを受け取ると、子コントロールによって呼び出されます。子コントロールはこのメソッドを呼び出してから、メッセージのためのキーボード イベントを生成します。このメソッドが true を返すと、子コントロールはメッセージが処理されたと判断し、キーボード イベントを生成しません。m パラメータは、プレビューするウィンドウ メッセージを格納しています。Message.Msg プロパティで有効な値は、WM_CHAR、WM_KEYDOWN、WM_SYSKEYDOWN、WM_KEYUP、および WM_SYSKEYUP です。ProcessKeyPreview メソッドは、単に親の ProcessKeyPreview メソッドに文字を送信します。コントロールに親がない場合は false を返します。Form クラスは、このメソッドをオーバーライドして、ダイアログ キーの実際の処理を実行します。

継承時の注意 派生クラスで ProcessKeyPreview メソッドをオーバーライドする場合、コントロールはキーを処理したことを示すために true を返す必要があります。コントロールによって処理されないキーの場合は、基本クラスの ProcessKeyEventArgs メソッドを呼び出した結果が返されます。

.NET Framework のセキュリティ

• UIPermission  (継承クラスのすべてのウィンドウでこのメソッドを呼び出すために必要なアクセス許可)。UIPermissionWindow の AllWindows 値 (関連する列挙体)。
• SecurityPermission  (直前の呼び出し元がアンマネージ コードを呼び出すために必要なアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

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

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間
KeyPress
KeyDown
KeyUp