Control.ProcessKeyPreview(Message) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Retornos
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.