ImmGetProperty 関数 (immdev.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
ヘッダー immdev.h (Immdev.h、Windows.h を含む)
Library Imm32.lib
[DLL] Imm32.dll

関連項目

ImmSetCompositionString

入力メソッド マネージャー

入力メソッド マネージャー関数