Control.ProcessKeyPreview メソッド
キーボード メッセージをプレビューします。
Protected Overridable Function ProcessKeyPreview( _
ByRef m As Message _) As Boolean
[C#]
protected virtual bool ProcessKeyPreview( ref Messagem);
[C++]
protected: virtual bool ProcessKeyPreview(Message* m);
[JScript]
protected function ProcessKeyPreview(
m : Message) : Boolean;
パラメータ
- 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 メソッドを呼び出した結果が返されます。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- UIPermission (継承クラスのすべてのウィンドウでこのメソッドを呼び出すために必要なアクセス許可) UIPermissionWindow.AllWindows (関連する列挙体)
参照
Control クラス | Control メンバ | System.Windows.Forms 名前空間 | KeyPress | KeyDown | KeyUp