PostKeybdMessage

9/9/2008

Essa função envia uma mensagem de teclado para a janela especificada.

Syntax

BOOL PostKeybdMessage( 
  HWND hwnd, 
  UINT VKey, 
  KEY_STATE_FLAGS KeyStateFlags, 
  UINT cCharacters, 
  UINT* pShiftStateBuffer, 
  UINT* pCharacterBuffer 
);

Parameters

• hwnd
  [no] Identificador para a janela que recebe a mensagem. Ela deve identificar uma janela pertencente o segmento chamado. Se hwnd é NULL, em seguida, a mensagem do teclado é enviada para o janela ativa ou janela com o foco do segmento de chamado. Se hwnd é – 1, em seguida, a mensagem do teclado é enviada para a janela com o foco do segmento de sistema primeiro plano ou janela ativa.

• VKey
  [no] Virtual código de chave. Este parâmetro pode ser definido como 0.

• KeyStateFlags
  [no] Estado da chave. A chave estados são descritos na seguinte tabela.

  Sinalizador	Descrição
  KeyStateToggledFlag	Chave é alternada.
  KeyStatePrevDownFlag	Chave anteriormente estava inoperante.
  KeyStateDownFlag	A chave é no momento para baixo.
  KeyShiftAnyCtrlFlag	Esquerdo ou direito chave CTRL está inoperante.
  KeyShiftAnyShiftFlag	Esquerdo ou direito chave SHIFT está inoperante.
  KeyShiftAnyAltFlag	Esquerdo ou direito ALT chave está inoperante.
  KeyShiftCapitalFlag	VK_CAPITAL é alternado.
  KeyShiftLeftCtrlFlag	Chave Left CTRL está inoperante.
  KeyShiftLeftShiftFlag	Chave Left SHIFT está inoperante.
  KeyShiftLeftAltFlag	Chave Left ALT está inoperante.
  KeyShiftLeftWinFlag	Left Windows logo key is down.
  KeyShiftRightCtrlFlag	Chave Right CTRL está inoperante.
  KeyShiftRightShiftFlag	Chave Right SHIFT está inoperante.
  KeyShiftRightAltFlag	Chave Right ALT está inoperante.
  KeyShiftRightWinFlag	Right Windows logo key is down
  KeyShiftDeadFlag	Caractere correspondente é caractere inativo.
  KeyShiftNoCharacterFlag	Nenhum caractere no pCharacterBuffer Para traduzir.

• cCharacters
  [no] Número de caracteres de pCharacterBuffer matriz.

• pShiftStateBuffer
  [no] Ponteiro para uma reserva que contém um correspondente deslocar estado entrada para cada caractere na pCharacterBuffer matriz. O estado SHIFT para cada caractere deve ser igual a KeyStateFlags parâmetro. Esse parâmetro não pode ser NULL.

• pCharacterBuffer
  [no] Ponteiro para uma reserva que contém os caracteres para enviar. Esse parâmetro não pode ser NULL.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Os caracteres pCharacterBuffer São os caracteres postados para fila do receptor quando TranslateMessage é chamado para a chave VK evento. Ao contrário de keybd_event função, PostKeybdMessage Não afeta a estado da chave global.

PostKeybdMessage traduzido não suporte um estado diferente para cada caractere. Se um estado diferente é exigido para cada caractere, individual, em seguida, chama a PostKeybdMessage devem ser feitas.

Se VKey é definido como 0 quando TranslateMessage for chamado, a chave Virtual conversão também for definida como 0. Porque 0 não é válido para chave virtual, um aplicativo deve ignorá-lo.

Requirements

Header	winuser.h
Library	Kbdui.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

keybd_event
TranslateMessage
Keyboard Functions