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.


継承クラスのすべてのウィンドウでこのメソッドを呼び出すために使用します。for all windows for inheriting classes to call this method. 列挙型に関連付けられている: AllWindows UIPermissionWindowします。Associated enumeration: AllWindows value of UIPermissionWindow.

直前の呼び出し元がアンマネージコードを呼び出す場合は。for the immediate caller to call unmanaged code. 関連付けられた列挙型: UnmanagedCodeAssociated enumeration: UnmanagedCode