Control.ProcessKeyPreview(Message) Metodo

Definizione

Visualizza in anteprima un messaggio della tastiera.Previews a keyboard message.

protected:
 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

Parametri

m
Message

Oggetto Message, passato per riferimento, che rappresenta il messaggio della finestra da elaborare.A Message, passed by reference, that represents the window message to process.

Restituisce

true se il messaggio è stato elaborato dal controllo; in caso contrario, false.true if the message was processed by the control; otherwise, false.

Commenti

Questo metodo viene chiamato da un controllo figlio quando il controllo figlio riceve un messaggio da tastiera.This method is called by a child control when the child control receives a keyboard message. Il controllo figlio chiama questo metodo prima di generare eventi di tastiera per il messaggio.The child control calls this method before generating any keyboard events for the message. Se questo metodo restituisce true, il controllo figlio considera il messaggio elaborato e non genera alcun evento tastiera.If this method returns true, the child control considers the message processed and does not generate any keyboard events. Il parametro m contiene il messaggio della finestra da visualizzare in anteprima.The m parameter contains the window message to preview. I valori possibili per la proprietà Message.Msg sono WM_CHAR, WM_KEYDOWN, WM_SYSKEYDOWN, WM_KEYUP e WM_SYSKEYUP.Possible values for the Message.Msg property are WM_CHAR, WM_KEYDOWN, WM_SYSKEYDOWN, WM_KEYUP, and WM_SYSKEYUP. Il metodo ProcessKeyPreview invia semplicemente il carattere al metodo ProcessKeyPreview dell'elemento padre oppure restituisce false se il controllo non dispone di un elemento padre.The ProcessKeyPreview method simply sends the character to the parent's ProcessKeyPreview method, or returns false if the control has no parent. La classe Form esegue l'override di questo metodo per eseguire l'elaborazione effettiva delle chiavi della finestra di dialogo.The Form class overrides this method to perform actual processing of dialog keys.

Note per gli eredi

Quando si esegue l'override del metodo ProcessKeyPreview(Message) in una classe derivata, un controllo deve restituire true per indicare che la chiave è stata elaborata.When overriding the ProcessKeyPreview(Message) method in a derived class, a control should return true to indicate that it has processed the key. Per le chiavi che non vengono elaborate dal controllo, deve essere restituito il risultato della chiamata al metodo ProcessKeyPreview(Message) della classe base.For keys that are not processed by the control, the result of calling the base class's ProcessKeyPreview(Message) method should be returned.

Sicurezza

UIPermission
per tutte le finestre per le classi che ereditano per chiamare questo metodo.for all windows for inheriting classes to call this method. Enumerazione associata: AllWindows valore di UIPermissionWindow.Associated enumeration: AllWindows value of UIPermissionWindow.

SecurityPermission
per il chiamante immediato per chiamare codice non gestito.for the immediate caller to call unmanaged code. Enumerazione associata: UnmanagedCodeAssociated enumeration: UnmanagedCode

Si applica a

Vedi anche