Control.ProcessKeyPreview(Message) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Visualiza uma mensagem do teclado.

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

Parâmetros

m

Message

Um Message, passado por referência, que representa a mensagem de janela a ser processada.

Retornos

Boolean

true se a mensagem foi processada pelo controle; caso contrário, false.

Comentários

Esse método é chamado por um controle filho quando o controle filho recebe uma mensagem de teclado. O controle filho chama esse método antes de gerar eventos de teclado para a mensagem. Se esse método retornar true, o controle filho considerará a mensagem processada e não gerará nenhum evento de teclado. O m parâmetro contém a mensagem de janela a ser visualizada. Os valores possíveis para a Message.Msg propriedade são WM_CHAR, WM_KEYDOWN, WM_SYSKEYDOWN, WM_KEYUP e WM_SYSKEYUP. O ProcessKeyPreview método simplesmente envia o caractere para o método pai ProcessKeyPreview ou retorna false se o controle não tem pai. A Form classe substitui esse método para executar o processamento real de chaves de caixa de diálogo.

Notas aos Herdeiros

Ao substituir o ProcessKeyPreview(Message) método em uma classe derivada, um controle deve retornar true para indicar que processou a chave. Para chaves que não são processadas pelo controle , o resultado da chamada do método da ProcessKeyPreview(Message) classe base deve ser retornado.

Confira também

• KeyPress
• KeyDown
• KeyUp