次の方法で共有

ITfReverseConversionMgr::GetReverseConversion メソッド (msctf.h)

  • [アーティクル]

[GetReverseConversion は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 内部使用の場合のみ。]

逆変換を実行できる ITfReverseConversion オブジェクトを取得します。

構文

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

パラメーター

[in] langid

ターゲット文字列が属するプロファイルの言語 ID。

[in] guidProfile

ターゲット文字列が属するプロファイルの GUID。

[in] dwflag

値 意味
TF_RCM_COMLESS
0x00000001
 COM を使用せずに逆変換インターフェイスをアクティブ化します。
TF_RCM_VKEY
0x00000002
 出力は、(文字キー コードではなく) 仮想キー コードの配列である必要があります。
TF_RCM_HINT_READING_LENGTH
0x00000004
 逆変換では、入力シーケンスの長さに基づいて出力リスト内のエントリの順序に優先順位を付け、最初に最短のシーケンスを指定する必要があります。 衝突数が少ない入力シーケンスは、類似した (ただし少し高い) 競合カウントを持つ入力シーケンスよりもはるかに大きくなる可能性があります。 このフラグの解釈は、IME によって異なります。
TF_RCM_HINT_COLLISION
0x00000008
 逆変換では、競合数に基づいて出力リスト内のエントリの順序に優先順位を付け、エントリには最初に最も少ない競合数が含まれている必要があります。 入力シーケンスが、少し長い入力シーケンスよりも多くの文字に対応する場合は、代わりに長い入力シーケンスを使用することをお勧めします。 IME は、このフラグが逆変換出力に影響するかどうかを決定します。

[out] ppReverseConversion

指定した逆変換を実行できる ITfReverseConversion オブジェクトのアドレスへのポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

戻り値 説明
S_OK
 指定した langid と guidProfile の組み合わせに対する ITfReverseConversion を使用できます。
E_NOTIMPL
 指定した langid と guidProfile の 組み合わせは、逆変換をサポートしていません。
E_FAIL
 未指定のエラーが発生しました。

解説

逆変換では、指定した文字列を作成するために必要なキーストローク シーケンスが提供されます。

dwflag に対してTF_RCM_HINT_COLLISIONフラグまたはTF_RCM_HINT_READING_LENGTH フラグが指定されていない場合、IME は出力を任意の順序で並べ替えない可能性があります。

要件

要件 値
サポートされている最小のクライアント Windows Vista と SP2 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 SP1 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー msctf.h
[DLL] Msctf.dll

こちらもご覧ください

ITfReverseConversionMgr