SendIMEMessageExA 関数 (ime.h)
[この関数は古く、使用しないでください。]
指定したサブ関数を使用して、入力メソッド エディター (IME) のアクションまたは処理を指定します。
構文
LRESULT SendIMEMessageExA(
HWND unnamedParam1,
LPARAM unnamedParam2
);
パラメーター
unnamedParam1
unnamedParam2
戻り値
サブ関数の処理の結果。 結果が成功しない場合は、次のいずれかのエラー コードが IMESTRUCT 構造体の wParam に格納されます。
リターン コード | 説明 |
---|---|
|
ディスク エラー。 |
|
一般的なエラー。 |
|
無効な文字が含まれています。 |
|
無効なサブ関数です。 |
|
サブ関数は入れ子になっているため、使用できません。 |
|
IME が選択されていません (インストールされていません)。 |
|
領域が不足しています。 |
|
候補が見つかりません。 |
|
Windows はシステム モードであり、データを IME に渡すことはできません。 |
|
文字が長すぎます。 |
解説
SendIMEMessageEx では、 WM_CONVERTREQUESTEX メッセージをサポートする IME に対してのみ、仕様に規定されているアクションが保証されます。 WM_CONVERTREQUESTEXをサポートしていない IME の場合、SendIMEMessageEx は WM_CONVERTREQUEST メッセージを IME に送信し、IMESTRUCT 構造体の wParam メンバーの内容を返します。 サブ関数の処理が正常に完了していない場合、これらの関数は wParamにIME_RS_ERROR設定されます。
Note
ime.h ヘッダーは、SendIMEMessageEx をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | ime.h (Windows.h を含む) |
Library | User32.lib |
[DLL] | User32.dll |