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 セキュリティ:

参照

Control クラス | Control メンバ | System.Windows.Forms 名前空間 | KeyPress | KeyDown | KeyUp