ImmGetGuideLineA 関数 (imm.h)
エラーに関する情報を取得します。 アプリケーションは、ユーザー通知に情報を使用します。
構文
DWORD ImmGetGuideLineA(
[in] HIMC unnamedParam1,
[in] DWORD dwIndex,
[out, optional] LPSTR lpBuf,
[in] DWORD dwBufLen
);
パラメーター
[in] unnamedParam1
入力コンテキストへのハンドル。
[in] dwIndex
取得するガイドライン情報の種類。 このパラメーターには、次のいずれかの値を指定できます。
| 価値 | 意味 |
|---|---|
|
エラー レベルを返します。 |
|
エラー インデックスを返します。 |
|
エラー メッセージ文字列を返します。 |
|
逆変換に関する情報を返します。 |
[out, optional] lpBuf
関数がエラー メッセージ文字列を取得するバッファーへのポインター。 このパラメーターには、dwIndex
[in] dwBufLen
出力バッファーのサイズ (バイト単位)。 エラー メッセージ文字列を受け取るために必要なバッファー サイズを返す関数の場合、終了 null 文字を含まない場合、アプリケーションはこのパラメーターを 0 に設定します。
戻り値
dwIndex パラメーターの値に応じて、エラー レベル、エラー インデックス、またはエラー メッセージ文字列のサイズを返します。 dwIndex
| 価値 | 意味 |
|---|---|
| GL_LEVEL_ERROR | エラー。 IME を続行できない場合があります。 |
| GL_LEVEL_FATAL | 致命的なエラー。 IME を続行できず、データが失われる可能性があります。 |
| GL_LEVEL_INFORMATION | エラーなし。 ユーザーは情報を入手できます。 |
| GL_LEVEL_NOGUIDELINE | エラーなし。 表示されている場合は、前のエラー メッセージを削除します。 |
| GL_LEVEL_WARNING | 予期しない入力またはその他の結果。 ユーザーに警告が表示されますが、IME は続行できます。 |
dwIndex
| 価値 | 意味 |
|---|---|
| GL_ID_CANNOTSAVE | ディクショナリまたは統計データを保存できません。 |
| GL_ID_NOCONVERT | IME はそれ以上変換できません。 |
| GL_ID_NODICTIONARY | IME でディクショナリが見つからないか、ディクショナリに予期しない形式が設定されています。 |
| GL_ID_NOMODULE | IME で必要なモジュールが見つかりません。 |
| GL_ID_READINGCONFLICT | 読み取り競合が発生しました。 たとえば、一部の母音を一緒に配置して 1 つの文字を形成することはできません。 |
| GL_ID_TOOMANYSTROKE | 1 つの文字または 1 つの句に対してストロークが多すぎます。 |
| GL_ID_TYPINGERROR | 入力エラー。 IME はこの入力を処理できません。 |
| GL_ID_UNKNOWN | 不明なエラー。 エラー メッセージ文字列を参照してください。 |
| GL_ID_INPUTREADING | IME は、エンド ユーザーからの文字入力の読み取りを受け入れます。 |
| GL_ID_INPUTRADICAL | IME は、エンド ユーザーからのラジカル文字入力を受け入れます。 |
| GL_ID_INPUTCODE | IME は、エンド ユーザーからの文字コード入力を受け入れます。 |
| GL_ID_CHOOSECANDIDATE | IME は、エンド ユーザーからの候補文字列の選択を受け入れます。 |
| GL_ID_REVERSECONVERSION | 逆変換に関する情報は、GGL_PRIVATEを指定 ImmGetGuideLineを呼び出すことによって使用できます。 取得される情報は、CANDIDATELIST 形式 |
dwIndex
dwIndex
備考
アプリケーションは通常、IMN_GUIDELINE コマンドを受け取った後にこの関数を呼び出します。
手記
imm.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして ImmGetGuideLine を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ]、東アジア言語のサポートがインストールされています。 |
| サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | imm.h (Immdev.h、Windows.h を含む) |
| ライブラリ | Imm32.lib |
| DLL | Imm32.dll |