ITfInputProcessorProfiles::AddLanguageProfile メソッド (msctf.h)

特定のテキスト サービスと特定の言語識別子で構成される言語プロファイルを作成します。

構文

HRESULT AddLanguageProfile(
  [in] REFCLSID    rclsid,
  [in] LANGID      langid,
  [in] REFGUID     guidProfile,
  [in] const WCHAR *pchDesc,
  [in] ULONG       cchDesc,
  [in] const WCHAR *pchIconFile,
  [in] ULONG       cchFile,
  [in] ULONG       uIconIndex
);

パラメーター

[in] rclsid

テキスト サービス CLSID を格納します。

[in] langid

テキスト サービスが追加されるプロファイルの言語識別子を指定する LANGID 値が含まれます。 このに -1 が含まれている場合、テキスト サービスはすべての言語に追加されます。

[in] guidProfile

言語プロファイルを識別する GUID 値が含まれます。 これは、プロファイルがアクティブな場合に ITfInputProcessorProfiles::GetActiveLanguageProfile によって取得される値です。

[in] pchDesc

プロファイル内のテキスト サービスの説明文字列を含む WCHAR バッファーへのポインター。 これは、言語バーに表示されるテキスト サービス名です。

[in] cchDesc

pchDesc の説明文字列の長さ (文字数) を格納します。 このに -1 が含まれている場合、 pchDesc は NULL で終わる文字列と見なされます。

[in] pchIconFile

プロファイル内のテキスト サービスの言語バーに表示されるアイコンを含むファイルのパスとファイル名を含む WCHAR バッファーへのポインター。 このファイルには、実行可能ファイル (.exe)、DLL (.dll)、またはアイコン (.ico) ファイルを指定できます。

このパラメーターは省略可能であり、 NULL にすることができます。 この場合、テキスト サービスの既定のアイコンが表示されます。

[in] cchFile

pchIconFile のアイコン ファイル文字列の長さ (文字数) を格納します。 このに -1 が含まれている場合、 pchIconFile は NULL で終わる文字列と見なされます。 pchIconFile が NULL の場合、このパラメーターは無視されます。

[in] uIconIndex

プロファイル内のテキスト サービスの言語バーに表示される pchIconFile のアイコンの 0 から始まるインデックスが含まれます。 pchIconFile が NULL の場合、このパラメーターは無視されます。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値	説明
S_OK	メソッドは正常に実行されました。
E_FAIL	未指定のエラーが発生しました。
E_INVALIDARG	pszDesc が無効です。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	msctf.h
[DLL]	Msctf.dll
再頒布可能パッケージ	Windows 2000 Professional 上の TSF 1.0

こちらもご覧ください

ITfInputProcessorProfiles

ITfInputProcessorProfiles::GetActiveLanguageProfile