IMESTRUCT 構造体 (ime.h)

SendIMEMessageEx によって使用され、入力メソッド エディター (IME) メッセージとそのパラメーターで実行されるサブ関数を指定します。 この構造体は、これらのサブ関数から戻り値を受け取るためにも使用されます。

構文

typedef struct tagIMESTRUCT {
  UINT   fnc;
  WPARAM wParam;
  UINT   wCount;
  UINT   dchSource;
  UINT   dchDest;
  LPARAM lParam1;
  LPARAM lParam2;
  LPARAM lParam3;
} IMESTRUCT, *PIMESTRUCT, *NPIMESTRUCT, *LPIMESTRUCT;

メンバー

fnc

サブ関数。 次のいずれかの値です。

IME_ENTERWORDREGISTERMODE

単語を登録するために使用されます。 単語は、単語とその読み取りを送信するアプリケーションとして登録されます。 構造体メンバーは、次のように解釈されます。

戻り値は、単語登録の結果を示します。 登録 が正常に処理されている場合は TRUE。それ以外の場合は FALSE。

音声の一部などの情報が必要な場合は、ユーザーに入力を求めるダイアログ ボックスが表示されます。 NULL は、メンバー lParam1 と lParam2 で指定できます。この場合、ダイアログ ボックスの関連する入力フィールドには何も表示されません。

IME_GETCONVERSIONMODE

IME の現在の変換モードを取得します。 このサブプログラムはパラメーターを使用しません。

これは、 IME_GET_MODEと同じです。

IME_MODE_ALPHANUMERICから IME_MODE_NOCODEINPUT への組 み合わせとして、IME の現在の変換モードを返 します。 変換モードは次のとおりです。

IME_GET_MODE

IME_GETCONVERSIONMODEと同じです。

IME_MOVECONVERTWINDOW

IME_SETCONVERSIONWINDOWと同じです。

IME_SETCONVERSIONFONTEX

変換ウィンドウに表示される未確定の文字列を表示するために使用するフォント。 構造体メンバーは、次のように解釈されます。

このサブ関数には戻り値がありません。

IME_SETCONVERSIONFONTEXで指定されたフォントは、未確定の文字列を表示するためにのみ使用できます。

既定の位置に未確定の文字列を表示するには、システム フォントを使用します。 表示位置が既定の位置でなくなった場合は、前に指定したフォントを有効にします。

LOGFONT 構造体を含むグローバル メモリは、アプリケーションによって解放されます。

変換ウィンドウを現在表示している IME が IME_SETCONVERSIONFONTEX コマンドを受け取り、コマンド処理の結果として変換ウィンドウが変更された場合、IME は WM_IME_REPORT:IR_CHANGECONVERT メッセージを送信する必要があります。 IME_SETCONVERSIONFONTEXで指定されたフォントが IME で使用されているフォントと同じである場合は、このメッセージを送信しないでください。

IME_SETCONVERSIONMODE

IME の変換モードを設定します。 wParam メンバーは、次の値の 1 つ以上を指定します。

戻り値は、指定された変換モードが正常に設定されたかどうかを示します。 新しい変換モードが設定されている場合は、以前に有効だった変換モードの状態を返します。それ以外の場合は NULL。

IME_SETCONVERSIONWINDOW

IME の外接する四角形のサイズと位置、および変換ウィンドウの初期位置。 IME は、このサブ関数で指定された位置に未確定の文字列を表示します。

wParam メンバーは、次のいずれかの値を指定します。

戻り値は、コマンドが実行されたかどうかを示します。 コマンド の実行が成功した場合は TRUE。それ以外の場合は FALSE。

未定義の文字列が外接する四角形をオーバーフローしているように見える場合、IME はレポート メッセージ WM_IME_REPORT:IR_FULLCONVERTをアプリケーションに発行してから、その文字列を表示する必要があります。 アプリケーションがこのメッセージを処理しない場合、ディスプレイの後続の処理はこの仕様では定式化されませんが、IME に任されます。 たとえば、未定義の文字列は、外接する四角形内でスクロールするか、一時的に既定の位置に移動できます。

IME が未確定の文字列を保持しているときにIME_SETCONVERSIONWINDOW メッセージが呼び出された場合、IME は WM_IME_REPORT:IR_CLOSECONVERT メッセージを発行する必要があります。文字列がパラメーターとして指定されたウィンドウに収まる場合、IME は WM_IME_REPORT:IR_OPENCONVERT メッセージを発行する必要があります。 その場合にのみ、変換ウィンドウを描画する必要があります。 文字列がウィンドウに収まらない場合、IME は WM_IME_REPORT:IR_FULLCONVERT メッセージを発行する必要があります。

外接する四角形の位置は、物理的な画面領域の外側で指定できます。 外接する四角形全体が物理画面の外側にある場合は、未確定の文字列を表示することはできません。 外接する四角形の一部が物理画面の外側にある場合、IME は境界四角形をクリップして、未確定の文字列の一部が画面をオーバーフローしないようにし、表示開始位置も調整します。

変換ウィンドウに表示される最大文字数または最大文字数を設定しないことをお勧めします。

変換ウィンドウがシステム ウィンドウと重なる場合は、変換ウィンドウを表示する必要があります。 たとえば、変換ウィンドウにディスプレイの優先度を最も高くしたり、システム ウィンドウを別の場所に移動したりできます。

変換ウィンドウのサイズ、表示内容、または表示色が変更された場合、IME はIR_CHANGECONVERT メッセージを送信する必要があります。 ただし、未確定の文字列が指定されたウィンドウに収まらない場合、IME はIR_CHANGECONVERTではなくIR_FULLCONVERTメッセージを送信する必要があります。

IME がMCW_WINDOWモードまたはMCW_SCREEN モードからMCW_DEFAULTに移行した場合、未定義の文字列が存在する場合は、IR_CLOSECONVERT メッセージを送信する必要があります。

IME がMCW_WINDOWモードまたはMCW_SCREEN モードからMCW_HIDDENに移行した場合、未確定の文字列が存在する場合は、IR_CLOSECONVERT メッセージを送信する必要があります。

IME がMCW_HIDDEN モードからMCW_DEFAULT、MCW_SCREEN、またはMCW_WINDOWに移行した場合、IME は、未確定の文字列 = 0 と決定された文字列 = 0 のIR_UNDETERMINE メッセージを送信する必要があります。

IME_SETLEVEL

現在のアプリケーションで IME レベルを設定する韓国語固有のサブ関数。 wParam メンバーは、次のいずれかのレベル値を受け入れます。

IME_SETOPEN

IME のかなから漢字への変換機能の状態を設定します。

IME を開くには wParam メンバーを 0 以外に設定し、IME を閉じるには 0 を設定します

戻り値は、かなから漢字への変換機能の以前の状態を示します。 開いている場合 は TRUE を 返します。それ以外の場合は FALSE。

かなから漢字への変換機能がIME_SETOPENによって閉じられている場合は、未確定の文字列を決定しないでください。

かなから漢字への変換機能をIME_SETOPENで閉じる場合、IME がMCW_WINDOWモードまたは MCW-SCREEN モードで、変換ウィンドウが開いている場合、IME はIR_CLOSECONVERTメッセージを送信する必要があります。 ただし、IME がMCW_HIDDEN モードの場合、および未確定の文字列が存在する場合は、IR_CLOSECONVERTを発行する必要はありません。

IME_SET_MODEK

IME_SETCONVERSIONMODEの韓国語固有のバージョン。

wParam

使用法は、 fnc で指定されたサブ関数によって異なります。

wCount

使用法は、 fnc で指定されたサブ関数によって異なります。

dchSource

使用法は、 fnc で指定されたサブ関数によって異なります。

dchDest

使用法は、 fnc で指定されたサブ関数によって異なります。

lParam1

使用法は、 fnc で指定されたサブ関数によって異なります。

lParam2

使用法は、 fnc で指定されたサブ関数によって異なります。

lParam3

使用法は、 fnc で指定されたサブ関数によって異なります。

要件

関連項目

クリップボード

概念

リファレンス

SetClipboardData