ホーム › UI.Input.Ime › IImePlugInDictDictionaryList

IImePlugInDictDictionaryList

COM

IID98752974-b0a6-489b-8f6f-bff3769c8eeb継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IME プラグイン辞書の一覧へのアクセスを提供します。

解説(Remarks)

このインターフェースは、Microsoft 日本語 IME 用の ProgID="ImePlugInDictDictionaryList1041" のクラス、および Microsoft 簡体字中国語 IME 用の ProgID="ImePlugInDictDictionaryList2052" のクラスに実装されています。

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetDictionariesInUse(SAFEARRAY** prgDictionaryGUID, SAFEARRAY** prgDateCreated, SAFEARRAY** prgfEncrypted)

IME が使用している IME プラグイン辞書の辞書 ID (GUID) の一覧を、それぞれの作成日および暗号化フラグとともに取得します。

prgDictionaryGUID	SAFEARRAY**	out	IME が使用している IME プラグイン辞書の辞書 ID (GUID) の配列。
prgDateCreated	SAFEARRAY**	inout	prgDictionaryGUID で返される各 IME プラグイン辞書の作成日の配列。
prgfEncrypted	SAFEARRAY**	inout	prgDictionaryGUID で返される各 IME プラグイン辞書について、それぞれの辞書が暗号化されているかどうかを示すフラグの配列。

戻り値

このメソッドは次のいずれかの値を返します。

戻り値	説明
S_OK	成功しました。
E_OUTOFMEMORY	メモリが不足しています。
E_FAIL	その他のエラー。

vtbl 4 HRESULT DeleteDictionary(LPWSTR bstrDictionaryGUID)

IME のプラグイン辞書一覧から辞書を削除します。

bstrDictionaryGUID

LPWSTR

一覧から削除する辞書の辞書 ID (GUID)。

戻り値

このメソッドは次のいずれかの値を返します。

戻り値	説明
S_OK	指定した辞書が一覧に存在し、正常に削除されました。
S_FALSE	指定した辞書は一覧に存在しません。
E_FAIL	その他のエラー。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IImePlugInDictDictionaryList "{98752974-B0A6-489B-8F6F-BFF3769C8EEB}"
#usecom global IImePlugInDictDictionaryList IID_IImePlugInDictDictionaryList "{}"
#comfunc global IImePlugInDictDictionaryList_GetDictionariesInUse  3 var,var,var
#comfunc global IImePlugInDictDictionaryList_DeleteDictionary      4 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IImePlugInDictDictionaryList "{98752974-B0A6-489B-8F6F-BFF3769C8EEB}"
#usecom global IImePlugInDictDictionaryList IID_IImePlugInDictDictionaryList "{}"
#comfunc global IImePlugInDictDictionaryList_GetDictionariesInUse  3 sptr,sptr,sptr
#comfunc global IImePlugInDictDictionaryList_DeleteDictionary      4 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。