UIElement.KeyDown Evento
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.
public:
virtual event KeyEventHandler ^ KeyDown;// Register
event_token KeyDown(KeyEventHandler const& handler) const;
// Revoke with event_token
void KeyDown(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::KeyDown_revoker KeyDown(auto_revoke_t, KeyEventHandler const& handler) const;public event KeyEventHandler KeyDown;function onKeyDown(eventArgs) { /* Your code */ }
uIElement.addEventListener("keydown", onKeyDown);
uIElement.removeEventListener("keydown", onKeyDown);
- or -
uIElement.onkeydown = onKeyDown;Public Custom Event KeyDown As KeyEventHandler <uiElement KeyDown="eventhandler"/>
Tipo de evento
Comentários
Os controles em sua interface do usuário geram eventos de teclado somente quando têm foco de entrada. Por padrão, o primeiro elemento focalizável na árvore visual recebe o foco do sistema. Um controle individual ganha foco quando o usuário clica ou toca diretamente nesse controle no layout ou usa a tecla Tab para entrar em uma sequência de guias dentro da área de conteúdo. Você também pode concentrar controles programaticamente chamando UIElement.Focus(Microsoft. Interface do usuário. Xaml.FocusState).
KeyDown é um evento roteado. Para obter mais informações sobre o conceito de evento roteado, consulte Eventos e visão geral de eventos roteado.
KeyDown usa dados de evento KeyRoutedEventArgs . As propriedades mais relevantes da maioria dos cenários de KeyRoutedEventArgs manipulador são Key e possivelmente KeyStatus. Para obter mais informações sobre como lidar com eventos de teclado, incluindo o código de exemplo para definir um método KeyEventHandler , consulte interações de teclado.
Um cenário para lidar com eventos de teclado é dar suporte a teclas de acesso ou teclas de acelerador para um aplicativo, ou uma região ou controle dentro de um aplicativo. Para obter mais informações sobre esse cenário, consulte a acessibilidade do teclado.
Controles de Windows Runtime específicos podem ter manipulação baseada em classe para o evento de entrada KeyDown. Nesse caso, o controle provavelmente terá uma substituição para o método OnKeyDown. Normalmente, esses manipuladores de classe destinam-se a processar um subconjunto de teclas que permitem a interação do usuário baseada em teclado com esse controle. Geralmente, essa interação dá suporte a um recurso de acessibilidade do teclado. Se uma tecla pressionar for tratada por manipulação baseada em classe, a tecla press será considerada já tratada e o evento KeyDown não será gerado para manipulação por nenhum manipulador de código de usuário nesse controle especificamente para essa chave. Normalmente, isso é apenas para algumas chaves dedicadas. Por exemplo, o ButtonBase tem tratamento de classe para que a tecla Space e a tecla Enter sejam tratadas como equivalentes de teclado para invocar o Botão. Isso fornece um equivalente de teclado interno para tocar no botão ou clicar nele com um mouse e habilita o cenário de acessibilidade de usar a interface do usuário e o botão usando apenas um teclado. Mas qualquer outra chave diferente de Space ou Enter ainda disparará um evento KeyDown e KeyUp para um Button. Para obter mais informações sobre como o tratamento baseado em classe para eventos funciona, consulte a visão geral de eventos e eventos roteado.
KeyDown dá suporte à capacidade de anexar manipuladores de eventos à rota que será invocada mesmo se os dados do evento estiverem marcados como Manipulados. Consulte AddHandler.