Visão geral da entrada do teclado

Os aplicativos devem aceitar a entrada do usuário do teclado, bem como do mouse. Um aplicativo recebe entrada de teclado na forma de mensagens postadas em suas janelas.

Modelo de entrada de teclado

O sistema fornece suporte a teclado independente do dispositivo para aplicativos instalando um driver de dispositivo de teclado apropriado para o teclado atual. O sistema fornece suporte a teclado independente de linguagem usando o layout de teclado específico do idioma atualmente selecionado pelo usuário ou pelo aplicativo. O driver do dispositivo de teclado recebe códigos de verificação do teclado, que são enviados para o layout do teclado em que são convertidos em mensagens e postados nas janelas apropriadas em seu aplicativo.

Atribuído a cada tecla em um teclado é um valor exclusivo chamado código de verificação, um identificador dependente do dispositivo para a tecla no teclado. Um teclado gera dois códigos de verificação quando o usuário digita uma tecla: uma quando o usuário pressiona a tecla e outra quando o usuário libera a tecla.

O driver do dispositivo de teclado interpreta um código de verificação e o converte (mapeia) para um código de chave virtual, um valor independente do dispositivo definido pelo sistema que identifica a finalidade de uma chave. Depois de traduzir um código de verificação, o layout do teclado cria uma mensagem que inclui o código de verificação, o código da chave virtual e outras informações sobre o pressionamento de teclas e, em seguida, coloca a mensagem na fila de mensagens do sistema. O sistema remove a mensagem da fila de mensagens do sistema e a posta na fila de mensagens do thread apropriado. Eventualmente, o loop de mensagem do thread remove a mensagem e a passa para o procedimento de janela apropriado para processamento. A figura a seguir ilustra o modelo de entrada do teclado.

Foco e ativação do teclado

O sistema posta as mensagens do teclado na fila de mensagens do thread em primeiro plano que criou a janela com o foco do teclado. O foco do teclado é uma propriedade temporária de uma janela. O sistema compartilha o teclado entre todas as janelas no visor, deslocando o foco do teclado, na direção do usuário, de uma janela para outra. A janela que tem o foco do teclado recebe (da fila de mensagens do thread que a criou) todas as mensagens de teclado até que o foco mude para uma janela diferente.

Um thread pode chamar a função GetFocus para determinar qual de suas janelas (se houver) atualmente tem o foco do teclado. Um thread pode dar o foco do teclado a uma de suas janelas chamando a função SetFocus . Quando o foco do teclado muda de uma janela para outra, o sistema envia uma mensagem WM_KILLFOCUS para a janela que perdeu o foco e envia uma mensagem WM_SETFOCUS para a janela que ganhou o foco.

O conceito de foco do teclado está relacionado ao da janela ativa. A janela ativa é a janela de nível superior com a qual o usuário está trabalhando no momento. A janela com o foco do teclado é a janela ativa ou uma janela filha da janela ativa. Para ajudar o usuário a identificar a janela ativa, o sistema a coloca na parte superior da ordem Z e realça sua barra de título (se ela tiver uma) e borda.

O usuário pode ativar uma janela de nível superior clicando nela, selecionando-a usando a combinação de teclas Alt+Tab ou Alt+Esc ou selecionando-a na Lista de Tarefas. Um thread pode ativar uma janela de nível superior usando a função SetActiveWindow . Ele pode determinar se uma janela de nível superior que ele criou está ativa usando a função GetActiveWindow .

Quando uma janela é desativada e outra ativada, o sistema envia a mensagem WM_ACTIVATE . A palavra de baixa ordem do parâmetro wParam será zero se a janela estiver sendo desativada e diferente de zero se estiver sendo ativada. Quando o procedimento de janela padrão recebe a mensagem WM_ACTIVATE , ele define o foco do teclado para a janela ativa.

Para impedir que eventos de entrada de teclado e mouse atinjam aplicativos, use BlockInput. Observe que a função BlockInput não interferirá na tabela de estado de entrada do teclado assíncrono. Isso significa que chamar a função SendInput enquanto a entrada estiver bloqueada alterará a tabela de estado de entrada do teclado assíncrono.

Mensagens de pressionamento de tecla

Pressionar uma tecla faz com que uma mensagem WM_KEYDOWN ou WM_SYSKEYDOWN seja colocada na fila de mensagens de thread anexada à janela que tem o foco do teclado. A liberação de uma chave faz com que uma mensagem WM_KEYUP ou WM_SYSKEYUP seja colocada na fila.

As mensagens de tecla liberada e tecla pressionada normalmente ocorrem em pares, mas se o usuário mantiver pressionada uma tecla por tempo suficiente para iniciar o recurso de repetição automática do teclado, o sistema vai gerar uma série de mensagens WM_KEYDOWN ou WM_SYSKEYDOWN em uma linha. Em seguida, ele gera uma única mensagem de WM_KEYUP ou WM_SYSKEYUP quando o usuário libera a chave.

Esta seção contém os seguintes tópicos:

• Pressionamentos de teclas do sistema e que não são do sistema
• Virtual-Key Descrição dos códigos
• Sinalizadores de mensagem de pressionamento de tecla

Pressionamentos de teclas do sistema e que não são do sistema

O sistema faz uma distinção entre pressionamentos de teclas do sistema e pressionamentos de teclas que não são do sistema. Os pressionamentos de teclas do sistema produzem mensagens de pressionamento de tecla do sistema, WM_SYSKEYDOWN e WM_SYSKEYUP. Os pressionamentos de teclas fora do sistema produzem mensagens de teclas fora do sistema, WM_KEYDOWN e WM_KEYUP.

Se o procedimento de janela precisar processar uma mensagem de pressionamento de tecla do sistema, verifique se, depois de processar a mensagem, o procedimento a passará para a função DefWindowProc . Caso contrário, todas as operações do sistema envolvendo a tecla Alt serão desabilitadas sempre que a janela tiver o foco do teclado. Ou seja, o usuário não poderá acessar os menus da janela ou o menu sistema ou usar o pressionamento de tecla Alt+Esc ou Alt+Tab para ativar uma janela diferente.

As mensagens de pressionamento de tecla do sistema são usadas principalmente pelo sistema e não por um aplicativo. O sistema os usa para fornecer sua interface de teclado interna aos menus e para permitir que o usuário controle qual janela está ativa. As mensagens de pressionamento de tecla do sistema são geradas quando o usuário digita uma tecla em combinação com a tecla Alt ou quando o usuário digita e nenhuma janela tem o foco do teclado (por exemplo, quando o aplicativo ativo é minimizado). Nesse caso, as mensagens são postadas na fila de mensagens anexada à janela ativa.

Mensagens de pressionamento de tecla fora do sistema são usadas pelas janelas do aplicativo; a função DefWindowProc não faz nada com elas. Um procedimento de janela pode descartar qualquer mensagem de pressionamento de tecla que não é do sistema que não seja necessária.

Descrição dos códigos de tecla virtual

O parâmetro wParam de uma mensagem de pressionamento de tecla contém o código de chave virtual da chave que foi pressionada ou liberada. Um procedimento de janela processa ou ignora uma mensagem de pressionamento de tecla, dependendo do valor do código de chave virtual.

Um procedimento de janela típico processa apenas um pequeno subconjunto das mensagens de pressionamento de tecla que ele recebe e ignora o restante. Por exemplo, um procedimento de janela pode processar apenas WM_KEYDOWN mensagens de pressionamento de tecla e somente aquelas que contêm códigos de chave virtual para as chaves de movimento do cursor, chaves de deslocamento (também chamadas de chaves de controle) e chaves de função. Um procedimento de janela típico não processa mensagens de pressionamento de tecla por meio de teclas de caracteres. Em vez disso, ele usa a função TranslateMessage para converter a mensagem em mensagens de caractere. Para obter mais informações sobre TranslateMessage e mensagens de caractere, consulte Mensagens de Caractere.

Sinalizadores de mensagem de pressionamento de tecla

O parâmetro lParam de uma mensagem de pressionamento de tecla contém informações adicionais sobre o pressionamento de tecla que gerou a mensagem. Essas informações incluem a contagem de repetição, o código de verificação, o sinalizador de chave estendida, o código de contexto, o sinalizador de estado-chave anterior e o sinalizador de estado de transição. A ilustração a seguir mostra os locais desses sinalizadores e valores no parâmetro lParam .

Um aplicativo pode usar os valores a seguir para obter os sinalizadores de pressionamento de tecla da palavra de ordem superior do lParam.

Código de exemplo:

case WM_KEYDOWN:
case WM_KEYUP:
case WM_SYSKEYDOWN:
case WM_SYSKEYUP:
{
    WORD vkCode = LOWORD(wParam);                                 // virtual-key code
    
    WORD keyFlags = HIWORD(lParam);

    WORD scanCode = LOBYTE(keyFlags);                             // scan code
    BOOL isExtendedKey = (keyFlags & KF_EXTENDED) == KF_EXTENDED; // extended-key flag, 1 if scancode has 0xE0 prefix
    
    if (isExtendedKey)
        scanCode = MAKEWORD(scanCode, 0xE0);

    BOOL wasKeyDown = (keyFlags & KF_REPEAT) == KF_REPEAT;        // previous key-state flag, 1 on autorepeat
    WORD repeatCount = LOWORD(lParam);                            // repeat count, > 0 if several keydown messages was combined into one message

    BOOL isKeyReleased = (keyFlags & KF_UP) == KF_UP;             // transition-state flag, 1 on keyup

    // if we want to distinguish these keys:
    switch (vkCode)
    {
    case VK_SHIFT:   // converts to VK_LSHIFT or VK_RSHIFT
    case VK_CONTROL: // converts to VK_LCONTROL or VK_RCONTROL
    case VK_MENU:    // converts to VK_LMENU or VK_RMENU
        vkCode = LOWORD(MapVirtualKeyW(scanCode, MAPVK_VSC_TO_VK_EX));
        break;
    }

    // ...
}
break;

Contagem repetida

Você pode verificar a contagem de repetição para determinar se uma mensagem de pressionamento de tecla representa mais de um pressionamento de tecla. O sistema incrementa a contagem quando o teclado gera mensagens WM_KEYDOWN ou WM_SYSKEYDOWN mais rápido do que um aplicativo pode processá-las. Isso geralmente ocorre quando o usuário segura uma tecla por tempo suficiente para iniciar o recurso de repetição automática do teclado. Em vez de preencher a fila de mensagens do sistema com as mensagens de tecla resultantes, o sistema combina as mensagens em uma só mensagem de tecla pressionada e incrementa a contagem de repetição. A liberação de uma chave não pode iniciar o recurso de repetição automática, portanto, a contagem de repetição para WM_KEYUP e WM_SYSKEYUP mensagens é sempre definida como 1.

Códigos de verificação

O código de verificação é o valor que o sistema gera quando o usuário pressiona uma tecla. É um valor que identifica a tecla pressionada independentemente do layout do teclado ativo, em oposição ao caractere representado pela tecla. Um aplicativo normalmente ignora códigos de verificação. Em vez disso, ele usa os códigos de chave virtual para interpretar mensagens de pressionamento de tecla.

Os teclados modernos estão usando a especificação HID (Dispositivos de Interface Humana) para se comunicar com um computador. O driver de teclado converte os valores de HID Usage relatados enviados do teclado em códigos de escaneamento e os passa para aplicativos.

A tabela a seguir lista o conjunto de códigos de verificação, conforme reconhecido atualmente pelo Windows. Os valores da página de uso HID/ID de uso HID/Nome de uso HID fazem referência ao documento Tabelas de uso HID. Os valores Localização da Tecla fazem referência à imagem de teclado anterior.

O código Scan 1 Make é entregue nas mensagens WM_KEYDOWN/WM_KEYUP/WM_SYSKEYDOWN/WM_SYSKEYUP e WM_INPUT.

Observações:

1. O código de verificação de chave SysRq é emitido no pressionamento de tecla Alt+Imprimir tela
2. O código de verificação de chave Break é emitido no pressionamento de tecla Ctrl+Pause
3. Como visto em mensagens de teclado herdadas
4. A tecla está presente nos teclados brasileiros
5. A tecla está presente em teclados japoneses
6. O código de verificação é emitido somente no evento de liberação de tecla

Sinalizador Extended-Key

O sinalizador de tecla estendida indica se a mensagem de pressionamento de tecla se originou de uma das teclas adicionais do Teclado avançado de 101/102 teclas. As teclas estendidas consistem nas teclas Alt e Ctrl no lado direito do teclado; as teclas Inserir, Excluir, Página Inicial, Fim, Página Para Cima, Página Para Baixo e Seta nos clusters à esquerda do teclado numérico; a tecla Break (Ctrl+Pause) ; a tecla Tela de Impressão; as teclas Divide (/) e Enter no teclado numérico; e as chaves Windows e application. Observe que a chave Num Lock tem um código de verificação separado da tecla Pause (que usa o mesmo código de verificação sem o sinalizador de chave estendida) e não é considerada uma chave estendida, apesar de aparecer na tabela de nomes de chave estendida. A tecla Shift à direita também não é considerada uma chave estendida; ele tem um código de verificação separado (0x36) em vez disso.

Se especificado, o código de verificação consiste em uma sequência de dois bytes, em que o primeiro byte tem um valor de 0xE0.

Código de contexto

O código de contexto indica se a chave Alt estava inativa quando a mensagem de pressionamento de tecla foi gerada. O código será 1 se a chave Alt estiver inoperante e 0 se estiver ativada.

Sinal Key-State anterior

O sinalizador de estado-chave anterior indica se a chave que gerou a mensagem de pressionamento de tecla estava anteriormente para cima ou para baixo. É 1 se a tecla estava pressionada e 0 se a tecla estava liberada. Você pode usar esse sinalizador para identificar mensagens de pressionamento de tecla geradas pelo recurso de repetição automática do teclado. Esse sinalizador é definido como 1 para WM_KEYDOWN e WM_SYSKEYDOWN mensagens de pressionamento de tecla geradas pelo recurso de repetição automática. Ele é sempre definido como 1 para mensagens WM_KEYUP e WM_SYSKEYUP .

Sinalizador Transition-State

O sinalizador de estado de transição indica se pressionar uma chave ou liberar uma chave gerou a mensagem de pressionamento de tecla. Esse sinalizador é sempre definido como 0 para mensagens WM_KEYDOWN e WM_SYSKEYDOWN ; é sempre definido como 1 para mensagens WM_KEYUP e WM_SYSKEYUP .

Mensagens de Personagem

As mensagens de pressionamento de tecla fornecem muitas informações sobre pressionamentos de tecla, mas não fornecem códigos de caractere para pressionamentos de teclas de caractere. Para recuperar códigos de caractere, um aplicativo deve incluir a função TranslateMessage em seu loop de mensagem de thread. TranslateMessage envia uma mensagem WM_KEYDOWN ou WM_SYSKEYDOWN para o layout do teclado. O layout examina o código de chave virtual da mensagem e, se corresponder a uma chave de caractere, fornece o equivalente de código de caractere (levando em conta o estado das teclas Shift e Caps Lock ). Em seguida, ele gera uma mensagem de caractere que inclui o código de caractere e coloca a mensagem na parte superior da fila de mensagens. A próxima iteração do loop de mensagens remove a mensagem de caractere da fila e a envia para o procedimento de janela apropriado.

Esta seção contém os seguintes tópicos:

• Mensagens de caracteres fora do sistema
• Mensagens de caracteres inativos

Mensagens de caracteres não reconhecidos pelo sistema

Um procedimento de janela pode receber as seguintes mensagens de caractere: WM_CHAR, WM_DEADCHAR, WM_SYSCHAR, WM_SYSDEADCHAR e WM_UNICHAR. A função TranslateMessage gera uma mensagem de WM_CHAR ou WM_DEADCHAR quando processa uma mensagem de WM_KEYDOWN . Da mesma forma, ele gera uma mensagem de WM_SYSCHAR ou WM_SYSDEADCHAR quando processa uma mensagem de WM_SYSKEYDOWN .

Um aplicativo que processa a entrada de teclado normalmente ignora todas as mensagens, exceto as WM_CHAR e WM_UNICHAR, enviando todas as outras mensagens para a função DefWindowProc. Observe que WM_CHAR usa UTF-16 (formato de transformação Unicode de 16 bits) ou conjunto de caracteres ANSI enquanto WM_UNICHAR sempre usa UTF-32 (Formato de Transformação Unicode de 32 bits). O sistema usa as mensagens WM_SYSCHAR e WM_SYSDEADCHAR para implementar mnemônicos de menu.

O parâmetro wParam de todas as mensagens de caractere contém o código de caractere da tecla de caractere que foi pressionada. O valor do código de caractere depende da classe de janela da janela que recebe a mensagem. Se a versão Unicode da função RegisterClass foi usada para registrar a classe de janela, o sistema fornece caracteres Unicode para todas as janelas dessa classe. Caso contrário, o sistema fornece códigos de caractere ANSI. Para obter mais informações, consulte Registrar classes de janela e usar páginas de código UTF-8 em aplicativos do Windows.

O conteúdo do parâmetro lParam de uma mensagem de caractere é idêntico ao conteúdo do parâmetro lParam da mensagem de pressionamento de tecla que foi interpretada para gerar a mensagem de caractere. Para obter informações, confira Sinalizadores de mensagem de pressionamento de tecla.

Mensagens de caracteres inativos

Alguns teclados que não são em inglês contêm teclas de caracteres que não devem produzir caracteres sozinhas. Em vez disso, elas são usadas para adicionar um diacrítico ao caractere produzido pelo pressionamento de tecla seguinte. Essas chaves são chamadas chaves mortas. A tecla circunflexa em um teclado alemão é um exemplo de uma tecla morta. Para inserir o caractere que consiste em um "o" com um circunflexo, um usuário alemão digitaria a chave circunflexa seguida pela chave "o". A janela com o foco do teclado receberia a seguinte sequência de mensagens:

1. WM_KEYDOWN
2. WM_DEADCHAR
3. WM_KEYUP
4. WM_KEYDOWN
5. WM_CHAR
6. WM_KEYUP

TranslateMessage gera a mensagem WM_DEADCHAR quando processa a mensagem WM_KEYDOWN de uma chave morta. Embora o parâmetro wParam da mensagem WM_DEADCHAR contenha o código de caractere do diacrítico para a chave morta, um aplicativo normalmente ignora a mensagem. Em vez disso, ele processa a mensagem de WM_CHAR gerada pelo pressionamento de tecla subsequente. O parâmetro wParam da mensagem WM_CHAR contém o código de caractere da letra com o diacrítico. Se o pressionamento de tecla subsequente gerar um caractere que não pode ser combinado com um diacrítico, o sistema gerará duas mensagens WM_CHAR . O parâmetro wParam do primeiro contém o código de caractere do diacrítico; o parâmetro wParam do segundo contém o código de caractere da chave de caractere subsequente.

A função TranslateMessage gera a mensagem WM_SYSDEADCHAR quando processa a mensagem WM_SYSKEYDOWN de uma chave morta do sistema (uma tecla morta que é pressionada em combinação com a tecla Alt ). Normalmente, um aplicativo ignora a mensagem de WM_SYSDEADCHAR .

Status da tecla

Ao processar uma mensagem de teclado, um aplicativo pode precisar determinar o status de outra chave além daquela que gerou a mensagem atual. Por exemplo, um aplicativo de processamento de palavras que permite que o usuário pressione Shift+End para selecionar um bloco de texto deve verificar o status da tecla Shift sempre que receber uma mensagem de pressionamento de tecla da tecla End . O aplicativo pode usar a função GetKeyState para determinar o status de uma chave virtual no momento em que a mensagem atual foi gerada; ele pode usar a função GetAsyncKeyState para recuperar o status atual de uma chave virtual.

Algumas teclas são consideradas teclas de alternância que alteram o estado do layout do teclado. As teclas de alternância geralmente incluem teclas Caps Lock (VK_CAPITAL), Num Lock (VK_NUMLOCK) e Scroll Lock (VK_SCROLL). A maioria dos teclados tem indicadores LED correspondentes para essas teclas.

O layout do teclado mantém uma lista de nomes. O nome de uma chave que produz um único caractere é o mesmo que o caractere produzido pela chave. O nome de uma chave não caracter, como Tab e Enter , é armazenado como uma cadeia de caracteres. Um aplicativo pode recuperar o nome de qualquer chave do layout do teclado chamando a função GetKeyNameText .

Pressionamento de tecla e conversões de caracteres

O sistema inclui várias funções de finalidade especial que traduzem códigos de verificação, códigos de caractere e códigos de chave virtual fornecidos por várias mensagens de pressionamento de tecla. Essas funções incluem MapVirtualKey, ToAscii, ToUnicode e VkKeyScan.

Microsoft Rich Edit 3.0 dá suporte ao HexToUnicode IME, que permite ao usuário converter caracteres entre hexadecimal e Unicode usando teclas de atalho. Isso significa que, quando o Microsoft Rich Edit 3.0 for incorporado a um aplicativo, o aplicativo herdará os recursos do IME hexToUnicode.

Suporte às teclas de acesso

Uma tecla de atalho é uma combinação de teclas que gera uma mensagem WM_HOTKEY, uma mensagem que o sistema coloca na parte superior da fila de mensagens de um thread, ignorando as mensagens existentes na fila. Os aplicativos usam as teclas de acesso para obter a entrada de teclado de alta prioridade do usuário. Por exemplo, definindo uma chave dinâmica que consiste no pressionamento de tecla Ctrl+C , um aplicativo pode permitir que o usuário cancele uma operação prolongada.

Para definir uma chave ativa, um aplicativo chama a função RegisterHotKey , especificando a combinação de chaves que gera a mensagem WM_HOTKEY , o identificador para a janela para receber a mensagem e o identificador da chave ativa. Quando o usuário pressiona a tecla de atalho, uma mensagem WM_HOTKEY é colocada na fila de mensagens do thread que criou a janela. O parâmetro wParam da mensagem contém o identificador da chave ativa. O aplicativo pode definir várias teclas de acesso para um thread, mas cada chave ativa no thread deve ter um identificador exclusivo. Antes que o aplicativo seja encerrado, ele deve usar a função UnregisterHotKey para destruir a chave ativa.

Os aplicativos podem usar um controle de tecla de atalho para facilitar a escolha de uma tecla de atalho pelo usuário. Controles de teclas de atalho normalmente são usados para definir um atalho que ativa uma janela; eles não usam as funções RegisterHotKey e UnregisterHotKey. Em vez disso, um aplicativo que usa um controle de tecla de atalho normalmente envia a mensagem WM_SETHOTKEY para definir a tecla de atalho. Toda vez que o usuário pressiona a tecla de atalho, o sistema envia uma mensagem WM_SYSCOMMAND especificando SC_HOTKEY. Para obter mais informações sobre controles de teclas frequentes, consulte "Usando controles de teclas frequentes" em controles de teclas frequentes.

Teclas de teclado para navegação e outras funções

O Windows oferece suporte para teclados com chaves especiais para funções de navegador, funções de mídia, inicialização de aplicativos e gerenciamento de energia. O WM_APPCOMMAND dá suporte às teclas de teclado extras. Além disso, a função ShellProc é modificada para dar suporte às teclas de teclado extras.

É improvável que uma janela filha em um aplicativo de componente seja capaz de implementar comandos diretamente para essas teclas de teclado extras. Portanto, quando uma dessas teclas é pressionada, DefWindowProc enviará uma mensagem de WM_APPCOMMAND para uma janela. DefWindowProc também propagará a mensagem WM_APPCOMMAND para a janela pai. Isso é semelhante à maneira como os menus de contexto são invocados com o botão direito do mouse, que é quando o DefWindowProc envia uma mensagem WM_CONTEXTMENU em um clique de botão direito e a propaga para o pai. Além disso, se DefWindowProc receber uma mensagem WM_APPCOMMAND para uma janela de nível superior, ele chamará um gancho de shell com o código HSHELL_APPCOMMAND.

O Windows também dá suporte ao Microsoft IntelliMouse Explorer, que é um mouse com cinco botões. Os dois botões extras dão suporte à navegação do navegador para frente e para trás. Para obter mais informações, consulte XBUTTONs.

Simulando entrada

Para simular uma série ininterrupta de eventos de entrada do usuário, use a função SendInput . A função aceita três parâmetros. O primeiro parâmetro, cInputs, indica o número de eventos de entrada que serão simulados. O segundo parâmetro, rgInputs, é uma matriz de estruturas INPUT , cada uma descrevendo um tipo de evento de entrada e informações adicionais sobre esse evento. O último parâmetro, cbSize, aceita o tamanho da estrutura INPUT , em bytes.

A função SendInput funciona injetando uma série de eventos de entrada simulados no fluxo de entrada de um dispositivo. O efeito é semelhante a chamar a função keybd_event ou mouse_event repetidamente, exceto que o sistema garante que nenhum outro evento de entrada intercale com os eventos simulados. Quando a chamada for concluída, o valor retornado indicará o número de eventos de entrada executados com êxito. Se esse valor for zero, a entrada será bloqueada.

A função SendInput não redefine o estado atual do teclado. Portanto, se o usuário tiver teclas pressionadas ao chamar essa função, ele poderá interferir nos eventos gerados por essa função. Se você estiver preocupado com possíveis interferências, verifique o estado do teclado com a função GetAsyncKeyState e corrija conforme necessário.

Idiomas, localidades e layouts de teclado

Um idioma é natural, como inglês, francês e japonês. Uma sublíngua é uma variante de uma língua natural que é falada em uma região geográfica específica, como as sublínguas do inglês faladas no Reino Unido e nos Estados Unidos. Os aplicativos usam valores, chamados de identificadores de idioma, para identificar exclusivamente idiomas e sublanguages.

Normalmente, os aplicativos usam localidades para definir o idioma no qual a entrada e a saída são processadas. Definir a localidade do teclado, por exemplo, afeta os valores de caractere gerados pelo teclado. Definir a localidade para a exibição ou impressora afeta os glifos exibidos ou impressos. Os aplicativos definem a localidade de um teclado carregando e usando layouts de teclado. Eles definem a localidade para uma exibição ou impressora selecionando uma fonte que dá suporte à localidade especificada.

Um layout de teclado não só especifica a posição física das teclas no teclado, mas também determina os valores de caractere gerados pressionando essas teclas. Cada layout identifica o idioma de entrada atual e determina quais valores de caractere são gerados por quais chaves e combinações de chaves.

Cada layout de teclado tem um identificador correspondente que identifica o layout e o idioma. A palavra inferior do identificador é um identificador de idioma. A palavra superior é um identificador de dispositivo, especificando o layout físico, ou é zero, indicando um layout físico padrão. O usuário pode associar qualquer idioma de entrada a um layout físico. Por exemplo, um usuário de língua inglesa que trabalha muito ocasionalmente em francês pode definir o idioma de entrada do teclado como francês sem alterar o layout físico do teclado. Isso significa que o usuário pode inserir texto em francês usando o layout em inglês familiar.

Geralmente, não se espera que os aplicativos manipulem idiomas de entrada diretamente. Em vez disso, o usuário configura combinações de idioma e layout e alterna entre elas. Quando o usuário clica no texto marcado com um idioma diferente, o aplicativo chama a função ActivateKeyboardLayout para ativar o layout padrão do usuário para esse idioma. Se o usuário editar o texto em um idioma que não está na lista ativa, o aplicativo poderá chamar a função LoadKeyboardLayout com o idioma para obter um layout com base nesse idioma.

A função ActivateKeyboardLayout define o idioma de entrada para a tarefa atual. O parâmetro hkl pode ser a referência para o layout do teclado ou um identificador de idioma com extensão zero. Os identificadores de layout do teclado podem ser obtidos da função LoadKeyboardLayout ou GetKeyboardLayoutList . Os valores HKL_NEXT e HKL_PREV também podem ser usados para selecionar o teclado seguinte ou anterior.

A função GetKeyboardLayoutName recupera o nome do layout de teclado ativo para o thread de chamada. Se um aplicativo criar o layout ativo usando a função LoadKeyboardLayout , GetKeyboardLayoutName recuperará a mesma cadeia de caracteres usada para criar o layout. Caso contrário, a cadeia de caracteres é o identificador de idioma primário correspondente à localidade do layout ativo. Isso significa que a função pode não necessariamente diferenciar entre layouts diferentes com o mesmo idioma primário, portanto, não é possível retornar informações específicas sobre o idioma de entrada. No entanto, a função GetKeyboardLayout pode ser usada para determinar o idioma de entrada.

A função LoadKeyboardLayout carrega um layout de teclado e disponibiliza o layout para o usuário. Os aplicativos podem tornar o layout imediatamente ativo para o thread atual usando o valor KLF_ACTIVATE . Um aplicativo pode usar o valor KLF_REORDER para reordenar os layouts sem especificar também o valor KLF_ACTIVATE . Os aplicativos sempre devem usar o valor KLF_SUBSTITUTE_OK ao carregar layouts de teclado para garantir que a preferência do usuário, se houver, esteja selecionada.

Para suporte multilíngue, a função LoadKeyboardLayout fornece os sinalizadores KLF_REPLACELANG e KLF_NOTELLSHELL . O sinalizador KLF_REPLACELANG direciona a função para substituir um layout de teclado existente sem alterar o idioma. Tentar substituir um layout existente usando o mesmo identificador de idioma, mas sem especificar KLF_REPLACELANG é um erro. O sinalizador KLF_NOTELLSHELL impede que a função notifique o shell quando um layout de teclado é adicionado ou substituído. Isso é útil para aplicativos que adicionam vários layouts em uma série consecutiva de chamadas. Esse sinalizador deve ser usado em todas as chamadas, exceto na última.

A função UnloadKeyboardLayout é restrita, pois não pode descarregar o idioma de entrada padrão do sistema. Isso garante que o usuário sempre tenha um layout disponível para inserir texto usando o mesmo conjunto de caracteres usado pelo shell e pelo sistema de arquivos.