ITfReverseConversionMgr::GetReverseConversion-Methode (msctf.h)

Artikel
08/24/2023

[GetReverseConversion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Nur zur internen Verwendung.]

Ruft ein ITfReverseConversion-Objekt ab, das Reversekonvertierungen ausführen kann.

Syntax

HRESULT GetReverseConversion(
  [in]  LANGID               langid,
  [in]  REFGUID              guidProfile,
  [in]  DWORD                dwflag,
  [out] ITfReverseConversion **ppReverseConversion
);

Parameter

[in] langid

Die Sprach-ID des Profils, zu dem die Zielzeichenfolgen gehören.

[in] guidProfile

Die GUID des Profils, zu dem die Zielzeichenfolgen gehören.

[in] dwflag

Wert	Bedeutung
TF_RCM_COMLESS 0x00000001	Aktivieren Sie die Reversekonvertierungsschnittstelle ohne COM.
TF_RCM_VKEY 0x00000002	Die Ausgabe sollte ein Array virtueller Schlüsselcodes (anstelle von Zeichenschlüsselcodes) sein.
TF_RCM_HINT_READING_LENGTH 0x00000004	Bei der umgekehrten Konvertierung sollte die Reihenfolge der Einträge in der Ausgabeliste basierend auf der Länge der Eingabesequenz priorisiert werden, wobei zuerst die kürzesten Sequenzen verwendet werden. Es ist möglich, dass eine Eingabesequenz mit einer niedrigen Kollisionsanzahl viel höher ist als eine Eingabesequenz mit einer ähnlichen (aber etwas höheren) Kollisionsanzahl. Die Interpretation dieses Flags variiert je nach IME.
TF_RCM_HINT_COLLISION 0x00000008	Die umgekehrte Konvertierung sollte die Reihenfolge der Einträge in der Ausgabeliste basierend auf der Kollisionsanzahl priorisieren, wobei die Einträge zuerst die niedrigste Anzahl von Kollisionen enthalten. Wenn eine Eingabesequenz viel mehr Zeichen als eine etwas längere Eingabesequenz entspricht, kann es vorzuziehen sein, stattdessen die längere Eingabesequenz zu verwenden. Die IME bestimmt, ob sich dieses Flag auf die Ausgabe der umgekehrten Konvertierung auswirkt.

[out] ppReverseConversion

Ein Zeiger auf die Adresse des ITfReverseConversion-Objekts, das die angegebene umgekehrte Konvertierung ausführen kann.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabewert	BESCHREIBUNG
S_OK	Eine ITfReverseConversion für die angegebene Kombination von langid und guidProfile ist verfügbar.
E_NOTIMPL	Die angegebene Kombination langid und guidProfile unterstützt keine umgekehrte Konvertierung.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Eine Reversekonvertierung stellt die Tastenkombinationen bereit, die zum Erstellen der angegebenen Zeichenfolge erforderlich sind.

Wenn weder das TF_RCM_HINT_COLLISION - noch TF_RCM_HINT_READING_LENGTH-Flag für dwflag angegeben wird, kann der IME die Ausgabe nicht in irgendeiner Reihenfolge anordnen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msctf.h
DLL	Msctf.dll

Weitere Informationen

ITfReverseConversionMgr

Freigeben über