ImmSetCompositionStringW

ImmSetCompositionStringW (Unicode) 関数 (immdev.h) は、組み立て文字列と読み文字列の文字、属性、文節を設定する。

ImmSetCompositionStringW param0, dwIndex, lpComp, dwCompLen, lpRead, dwReadLen

param0 : [intptr] 
dwIndex : [int] 
lpComp : [intptr] dwIndex の値で指定される、組み立て文字列に設定する情報を格納したバッファへのポインタ。
dwCompLen : [int] 組み立て文字列の情報バッファのサイズ (バイト単位)。SCS_SETSTR が指定されバッファに Unicode 文字列が含まれる場合でもバイト単位。
lpRead : [intptr] dwIndex の値で指定される、読み文字列に設定する情報を格納したバッファへのポインタ。アプリケーションはこのパラメータに NULL を指定してもよい。
dwReadLen : [int] 読み文字列の情報バッファのサイズ (バイト単位)。SCS_SETSTR が指定されバッファに Unicode 文字列が含まれる場合でもバイト単位。

(プラグイン / モジュール : imm32.dll)

解説

ImmSetCompositionStringW (Unicode) 関数 (immdev.h)
は、組み立て文字列と読み文字列の文字、属性、文節を設定する。

[戻り値]
成功した場合は 0 以外の値を、失敗した場合は 0 を返す。

[備考]
アプリケーションは lpComp、lpRead、またはその両方を設定できる。アプリケーションが lpComp
に値を指定しない場合は、このパラメータを NULL に設定し、dwCompLen を 0
にしなければならない。アプリケーションが属性を変更するとき、1 つの文節内のすべての文字は同じ属性でなければならない。変換済み文字は
ATTR_CONVERTED または ATTR_TARGET_CONVERTED 属性を持たなければならない。未変換文字は
ATTR_INPUT または ATTR_TARGET_NOTCONVERTED
属性を持たなければならない。アプリケーションが文節情報を変更するときは、ターゲット文節のみを変更でき、一度に 1
つの境界にしか影響を与えない。ターゲット文節は ATTR_TARGET_CONVERTED または
ATTR_TARGET_NOTCONVERTED 属性を持つ。属性 (ATTR_* 値) の詳細については Composition
String を参照。IME が変更を完了すると、アプリケーションに WM_IME_COMPOSITION
メッセージを送信して変更を通知する。Windows Me/98、Windows 2000、Windows XP:
SCS_*CONVERTSTRING の値は再変換のために使われる。これらは SCS_CAP_SETRECONVERTSTRING
プロパティを持つ IME でのみ使用できる。アプリケーションはこれらの値を次のように使う:
（以下省略）

情報