Win32 API 日本語リファレンス
ホーム › Globalization › ISpellChecker

ISpellChecker

COM
📘 Microsoft Learn (日本語) · English
IIDb6fd0b71-e2bc-4653-8d05-f197e412770b継承元IUnknown自前メソッド開始 vtbl3

メソッド 14

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

vtbl 3 HRESULT get_LanguageTag(LPWSTR* value)
valueLPWSTR*outこのスペルチェッカーが対象とするBCP47言語タグを受け取る出力ポインタ。呼び出し側で解放する。
vtbl 4 HRESULT Check(LPWSTR text, IEnumSpellingError** value)
textLPWSTRinスペルチェック対象となる入力テキスト文字列。
valueIEnumSpellingError**out検出された各スペルエラーを列挙するIEnumSpellingErrorを受け取る出力ポインタ。
vtbl 5 HRESULT Suggest(LPWSTR word, IEnumString** value)
wordLPWSTRin修正候補を取得したい対象の単語文字列。
valueIEnumString**out推奨される修正候補を列挙するIEnumStringを受け取る出力ポインタ。
vtbl 6 HRESULT Add(LPWSTR word)
wordLPWSTRinユーザー辞書へ正しい語として追加し、以後誤りと扱わない単語文字列。
vtbl 7 HRESULT Ignore(LPWSTR word)
wordLPWSTRin現セッション中に限り誤りとして無視させる単語文字列。
vtbl 8 HRESULT AutoCorrect(LPWSTR from, LPWSTR to)
fromLPWSTRin自動修正の対象となる誤った語(置換元)文字列。
toLPWSTRinfromを検出した際に自動で置き換える正しい語(置換先)文字列。
vtbl 9 HRESULT GetOptionValue(LPWSTR optionId, BYTE* value)
optionIdLPWSTRin値を取得したいスペルチェックオプションの識別子文字列。
valueBYTE*out指定オプションの現在値(0始まりのインデックス)を受け取る出力バイトポインタ。
vtbl 10 HRESULT get_OptionIds(IEnumString** value)
valueIEnumString**outこのチェッカーがサポートする全オプションIDを列挙するIEnumStringを受け取る出力ポインタ。
vtbl 11 HRESULT get_Id(LPWSTR* value)
valueLPWSTR*outスペルチェッカー実装(プロバイダー)を識別する文字列IDを受け取る出力ポインタ。呼び出し側で解放する。
vtbl 12 HRESULT get_LocalizedName(LPWSTR* value)
valueLPWSTR*outユーザーへ表示するローカライズ済みのチェッカー名を受け取る出力ポインタ。呼び出し側で解放する。
vtbl 13 HRESULT add_SpellCheckerChanged(ISpellCheckerChangedEventHandler* handler, DWORD* eventCookie)
handlerISpellCheckerChangedEventHandler*inチェッカー状態変化時に呼び出されるコールバックハンドラへのポインタ。
eventCookieDWORD*out登録解除に使用する識別クッキー(DWORD)を受け取る出力ポインタ。
vtbl 14 HRESULT remove_SpellCheckerChanged(DWORD eventCookie)
eventCookieDWORDinadd_SpellCheckerChangedで取得した登録解除用クッキー(DWORD)。
vtbl 15 HRESULT GetOptionDescription(LPWSTR optionId, IOptionDescription** value)
optionIdLPWSTRin説明を取得したいスペルチェックオプションの識別子文字列。
valueIOptionDescription**out指定オプションの説明(見出し・本文・ラベル群)を表すIOptionDescriptionを受け取る出力ポインタ。
vtbl 16 HRESULT ComprehensiveCheck(LPWSTR text, IEnumSpellingError** value)
textLPWSTRinより高精度な包括的スペルチェックを行う対象の入力テキスト文字列。
valueIEnumSpellingError**out検出された各スペルエラーを列挙するIEnumSpellingErrorを受け取る出力ポインタ。

HSP用 COM定義

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

出力引数: 
#define global IID_ISpellChecker "{B6FD0B71-E2BC-4653-8D05-F197E412770B}"
#usecom global ISpellChecker IID_ISpellChecker "{}"
#comfunc global ISpellChecker_get_LanguageTag             3 var
#comfunc global ISpellChecker_Check                       4 wstr,sptr
#comfunc global ISpellChecker_Suggest                     5 wstr,sptr
#comfunc global ISpellChecker_Add                         6 wstr
#comfunc global ISpellChecker_Ignore                      7 wstr
#comfunc global ISpellChecker_AutoCorrect                 8 wstr,wstr
#comfunc global ISpellChecker_GetOptionValue              9 wstr,var
#comfunc global ISpellChecker_get_OptionIds               10 sptr
#comfunc global ISpellChecker_get_Id                      11 var
#comfunc global ISpellChecker_get_LocalizedName           12 var
#comfunc global ISpellChecker_add_SpellCheckerChanged     13 sptr,var
#comfunc global ISpellChecker_remove_SpellCheckerChanged  14 int
#comfunc global ISpellChecker_GetOptionDescription        15 wstr,sptr
#comfunc global ISpellChecker_ComprehensiveCheck          16 wstr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。