ITfKeystrokeMgr::GetPreservedKey-Methode (msctf.h)

Ruft die Befehls-GUID für einen beibehaltenen Schlüssel ab.

Syntax

HRESULT GetPreservedKey(
  [in]  ITfContext            *pic,
  [in]  const TF_PRESERVEDKEY *pprekey,
  [out] GUID                  *pguid
);

Parameter

[in] pic

Zeiger auf den Anwendungskontext. Dieser Wert wird von einem vorherigen Aufruf von ITfDocumentMgr::CreateContext zurückgegeben.

[in] pprekey

Zeiger auf eine TF_PRESERVEDKEY-Struktur , die den zu erhaltenden Schlüssel identifiziert. Das uVKey-Element enthält den virtuellen Schlüsselcode, und das uModifiers-Element identifiziert die Modifizierer des beibehaltenen Schlüssels. Das uVKey-Element muss kleiner als 256 sein.

[out] pguid

Zeiger auf einen GUID-Wert, der die Befehls-GUID des beibehaltenen Schlüssels empfängt. Dies ist die GUID, die im TSF-Textdienstaufruf an ITfKeystrokeMgr::P reserveKey übergeben wird. Dieser Wert empfängt GUID_NULL, wenn der beibehaltene Schlüssel nicht gefunden wird.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Beibehaltene Tasten werden von TSF-Textdiensten registriert und verwendet, um Tastenkombinationen für allgemeine Befehle bereitzustellen, die vom TSF-Textdienst implementiert werden.

Anforderungen

Weitere Informationen

ITfDocumentMgr::CreateContext

ITfKeystrokeMgr

ITfKeystrokeMgr::P reserveKey

TF_PRESERVEDKEY