Control.ProcessKeyPreview(Message) メソッド


キーボード メッセージをプレビューします。Previews a keyboard message.

 virtual bool ProcessKeyPreview(System::Windows::Forms::Message % m);
protected virtual bool ProcessKeyPreview (ref System.Windows.Forms.Message m);
abstract member ProcessKeyPreview : Message -> bool
override this.ProcessKeyPreview : Message -> bool
Protected Overridable Function ProcessKeyPreview (ByRef m As Message) As Boolean



処理するウィンドウ メッセージを表す、参照渡しされた MessageA Message, passed by reference, that represents the window message to process.



メッセージがコントロールによって処理された場合は true。それ以外の場合は falsetrue if the message was processed by the control; otherwise, false.


このメソッドは、子コントロールがキーボードメッセージを受信したときに子コントロールによって呼び出されます。This method is called by a child control when the child control receives a keyboard message. 子コントロールは、メッセージのキーボードイベントを生成する前にこのメソッドを呼び出します。The child control calls this method before generating any keyboard events for the message. このメソッドが trueを返す場合、子コントロールはメッセージを処理したと見なし、キーボードイベントを生成しません。If this method returns true, the child control considers the message processed and does not generate any keyboard events. m パラメーターには、プレビューするウィンドウメッセージが含まれています。The m parameter contains the window message to preview. Message.Msg プロパティに指定できる値は、WM_CHAR、WM_KEYDOWN、WM_SYSKEYDOWN、WM_KEYUP、および WM_SYSKEYUP です。Possible values for the Message.Msg property are WM_CHAR, WM_KEYDOWN, WM_SYSKEYDOWN, WM_KEYUP, and WM_SYSKEYUP. ProcessKeyPreview メソッドは、単純にその文字を親の ProcessKeyPreview メソッドに送信するか、コントロールに親がない場合は false を返します。The ProcessKeyPreview method simply sends the character to the parent's ProcessKeyPreview method, or returns false if the control has no parent. Form クラスは、このメソッドをオーバーライドして、ダイアログキーの実際の処理を実行します。The Form class overrides this method to perform actual processing of dialog keys.

注意 (継承者)

派生クラスの ProcessKeyPreview(Message) メソッドをオーバーライドする場合、コントロールは true を返して、キーが処理されたことを示す必要があります。When overriding the ProcessKeyPreview(Message) method in a derived class, a control should return true to indicate that it has processed the key. コントロールによって処理されないキーの場合は、基本クラスの ProcessKeyPreview(Message) メソッドを呼び出した結果が返されます。For keys that are not processed by the control, the result of calling the base class's ProcessKeyPreview(Message) method should be returned.