Método ITfKeystrokeMgr::P reserveKey (msctf.h)

Registra uma chave preservada.

Sintaxe

HRESULT PreserveKey(
  [in] TfClientId            tid,
  [in] REFGUID               rguid,
  [in] const TF_PRESERVEDKEY *prekey,
  [in] const WCHAR           *pchDesc,
  [in] ULONG                 cchDesc
);

Parâmetros

[in] tid

Contém o identificador do cliente do serviço de texto TSF. Esse valor é passado para o serviço de texto TSF em seu método ITfTextInputProcessor::Activate .

[in] rguid

Contém o GUID de comando da chave preservada. Esse valor é passado para o método ITfKeyEventSink::OnPreservedKey do serviço de texto TSF para identificar a chave preservada quando a chave preservada é ativada.

[in] prekey

Ponteiro para uma estrutura TF_PRESERVEDKEY que especifica a chave preservada. O membro uVKey contém o código de chave virtual e o membro uModifiers identifica os modificadores da chave preservada.

[in] pchDesc

Ponteiro para uma cadeia de caracteres Unicode que contém a descrição da chave preservada. Isso não pode ser NULL , a menos que cchDesc seja zero.

[in] cchDesc

Especifica o número de caracteres em pchDesc. Passe zero para esse parâmetro se nenhuma descrição for necessária.

Valor retornado

Esse método pode retornar um desses valores.

Comentários

As teclas preservadas são registradas pelos serviços de texto TSF e fornecem atalhos de teclado para comandos comuns implementados pelo serviço de texto TSF.

Requisitos

Confira também

ITfKeyEventSink::OnPreservedKey

ITfKeystrokeMgr

ITfKeystrokeMgr::UnpreserveKey

ITfTextInputProcessor::Activate

TF_PRESERVEDKEY