NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

Control.ProcessKeyPreview

Previews a keyboard message. 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. If this method returns true, the child control considers the message consumed and does not generate any keyboard events. The m parameter contains the window message to preview. Possible values for the m.msg field are WM_CHAR, WM_KEYDOWN, WM_SYSKEYDOWN, WM_KEYUP, and WM_SYSKEYUP. processKeyPreview() simply sends the character to the parent's processKeyPreview() method, or returns false if the control has no parent. The Form class overrides this method to perform actual processing of dialog keys. When overriding processKeyPreview(), a control should return true to indicate that it has processed the key. For keys that aren't processed by the control, the result of "base.processKeyEventArgs()" should be returned.

[Visual Basic]
Overridable Protected Function ProcessKeyPreview( _
   ByRef m As Message _
) As Boolean
[C#]
protected virtual bool ProcessKeyPreview(
   ref Message m
);
[C++]
protected: virtual bool ProcessKeyPreview(
   Message** m
);
[JScript]
protected function ProcessKeyPreview(
   m : Message
) : Boolean;

Parameters

m
window message to preview.

Return Value

true to consume the key, false to allow further processing.

See Also

Control Class | Control Members | System.WinForms Namespace