ImmGetProperty 関数 (imm.h)
指定した入力ロケールに関連付けられている IME のプロパティと機能を取得します。
構文
DWORD ImmGetProperty(
HKL unnamedParam1,
DWORD unnamedParam2
);
パラメーター
unnamedParam1
unnamedParam2
戻り値
dwIndex パラメーターの値に応じて、プロパティまたは機能の値を返します。 dwIndex が IGP_PROPERTY に設定されている場合、関数は次の値の 1 つ以上を返します。
| 値 | 意味 |
|---|---|
| IME_PROP_AT_CARET | 設定した場合、変換ウィンドウはキャレット位置にあります。 オフの場合、ウィンドウはキャレット位置の近くになります。 |
| IME_PROP_SPECIAL_UI | 設定されている場合、IME には標準以外のユーザー インターフェイスがあります。 アプリケーションが IME ウィンドウに描画されないようにする必要があります。 |
| IME_PROP_CANDLIST_START_FROM_1 | 設定した場合、候補リストの文字列には 1 から始まる番号が付きます。 オフの場合、文字列は 0 から始まります。 |
| IME_PROP_UNICODE | 設定すると、IME は Unicode IME として表示されます。 オペレーティング システムと IME は、Unicode IME インターフェイスを介して通信します。 オフの場合、IME は ANSI インターフェイスを使用してオペレーティング システムと通信します。 |
| IME_PROP_COMPLETE_ON_UNSELECT | 設定すると、IME が非アクティブ化されると、IME によってコンポジション文字列が完了します。 オフの場合、IME は、キーボード レイアウトの変更など、IME が非アクティブ化されたときにコンポジション文字列を取り消します。 |
| IME_PROP_ACCEPT_WIDE_VKEY | 設定されている場合、IME は、VK_PACKETを使用して SendInput 関数から挿入された Unicode を処理します。 オフの場合、IME は挿入された Unicode を処理せず、挿入された Unicode をアプリケーションに直接送信する可能性があります。 |
dwIndex が IGP_UI に設定されている場合、関数は次の 1 つ以上の値を返します。
| 値 | 意味 |
|---|---|
| UI_CAP_2700 | 0 または 2700 のテキスト エスケープメント値をサポートします。 詳細については、LOGFONT 構造体の lfEscapement メンバーを参照してください。 |
| UI_CAP_ROT90 | 0、900、1800、または 2700 のテキスト エスケープメント値をサポートします。 詳細については、「 lfEscapement」を参照してください。 |
| UI_CAP_ROTANY | 任意のテキスト エスケープメント値をサポートします。 詳細については、「 lfEscapement」を参照してください。 |
dwIndex が IGP_SETCOMPSTR に設定されている場合、関数は次の 1 つ以上の値を返します。
| 値 | 意味 |
|---|---|
| SCS_CAP_COMPSTR | SCS_SETSTR値を使用して ImmSetCompositionString 関数を呼び出して、コンポジション文字列を作成します。 |
| SCS_CAP_MAKEREAD | SCS_SETSTRで lpRead を設定せずに ImmSetCompositionString 関数を使用する場合は、対応するコンポジション文字列から読み取り文字列を作成します。 |
| SCS_CAP_SETRECONVERTSTRING: | この IME では、再変換をサポートできます。 再変換を行うには、 ImmSetCompositionString を使用します。 |
dwIndex が IGP_SELECT に設定されている場合、関数は次の 1 つ以上の値を返します。
| 値 | 意味 |
|---|---|
| SELECT_CAP_CONVMODE | 新しい IME が選択されている場合は、変換モードを継承します。 |
| SELECT_CAP_SENTENCE | 新しい IME が選択されている場合は、文モードを継承します。 |
dwIndex が IGP_GETIMEVERSION に設定されている場合、関数は次の値の 1 つ以上を返します。
| 値 | 意味 |
|---|---|
| IMEVER_0310 | IME は Windows 3.1 用に作成されました。 |
| IMEVER_0400 | IME は Windows Me/98/95 用に作成されました。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP [デスクトップ アプリのみ]、東アジア言語のサポートがインストールされています。 |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | imm.h (Immdev.h、Windows.h を含む) |
| Library | Imm32.lib |
| [DLL] | Imm32.dll |