Metodo ITfKeystrokeMgr::P reserveKey (msctf.h)

Articolo
08/24/2023

Registra una chiave mantenuta.

Sintassi

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

Parametri

[in] tid

Contiene l'identificatore client del servizio di testo TSF. Questo valore viene passato al servizio di testo TSF nel metodo ITfTextInputProcessor::Activate .

[in] rguid

Contiene il GUID del comando della chiave mantenuta. Questo valore viene passato al metodo ITfKeyEventSink::OnPreservedKey del servizio di testo TSF per identificare la chiave mantenuta quando viene attivata la chiave mantenuta.

[in] prekey

Puntatore a una struttura TF_PRESERVEDKEY che specifica la chiave mantenuta. Il membro uVKey contiene il codice della chiave virtuale e il membro uModifiers identifica i modificatori della chiave mantenuta.

[in] pchDesc

Puntatore a una stringa Unicode contenente la descrizione della chiave mantenuta. Non può essere NULL a meno che cchDesc non sia zero.

[in] cchDesc

Specifica il numero di caratteri in pchDesc. Passare zero per questo parametro se non è necessaria alcuna descrizione.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
TF_E_ALREADY_EXISTS	La chiave mantenuta viene registrata.
E_INVALIDARG	Uno o più parametri non sono validi.
E_OUTOFMEMORY	Si è verificato un errore di allocazione della memoria.
E_FAIL	Si è verificato un errore non specificato.

Commenti

I tasti mantenuti vengono registrati dai servizi di testo TSF e forniscono tasti di scelta rapida ai comandi comuni implementati dal servizio di testo TSF.

Requisiti


Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

ITfKeyEventSink::OnPreservedKey

ITfKeystrokeMgr

ITfKeystrokeMgr::UnpreserveKey

ITfTextInputProcessor::Activate

TF_PRESERVEDKEY

Condividi tramite