ITextStoreAnchor

ITextStoreAnchor インターフェイスは Microsoft Active Accessibility クライアントによって実装され、TSF マネージャーがテキストストリームを操作するために使用します。

ITextStoreAnchor::AdviseSink メソッドは、ITextStoreAnchorSink インターフェイスの新しいアドバイズシンクをインストールするか、既存のアドバイズシンクを変更します。

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

値	説明
S_OK	メソッドは成功しました。
E_FAIL	指定されたシンクインターフェイス riid を取得できませんでした。
E_INVALIDARG	指定されたシンクインターフェイスはサポートされていません。
E_UNEXPECTED	指定されたシンクオブジェクトを取得できませんでした。

punk パラメーターで表される同じインターフェイスに対する 2 回目以降の呼び出しは、dwMask パラメーターの更新要求として処理されます。サーバーは、このような要求に応じてシンクに対して AddRef メソッドを呼び出してはなりません。

サーバーが保持する接続ポイントは 1 つだけです。元のシンクオブジェクトが解除されるまで、2 つ目のシンクオブジェクトをアドバイズしようとしても失敗します。通知が不要になった場合、アプリケーションは ITextStoreAnchor::UnadviseSink メソッドを使用してシンクオブジェクトの登録を解除してください。

ITextStoreAnchor::UnadviseSink メソッド

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

値	説明
S_OK	メソッドは成功しました。
CONNECT_E_NOCONNECTION	アクティブなシンクオブジェクトがありません。

新しいシンクオブジェクトを登録する ITextStoreAnchor::AdviseSink メソッドの呼び出しごとに、このメソッドの呼び出しを対応させる必要があります。AdviseSink が、既に登録済みのシンクの dwMask パラメーターを更新しただけの場合は、UnadviseSink の呼び出しは不要です。

たとえば、シンクオブジェクトを登録するために、アプリケーションは最初に AdviseSink メソッドを呼び出します。その後、同じシンクオブジェクトを指定して AdviseSink メソッドを再度呼び出し、dwMask パラメーターを変更できます。シンクオブジェクトの登録を解除するには、UnadviseSink メソッドを呼び出します。

punk パラメーターは、AdviseSink メソッドに最初に渡したポインターと同一の COM アイデンティティを持つ必要があります。

ITextStoreAnchor::RequestLock メソッド

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

値	説明
S_OK	メソッドは成功しました。
E_FAIL	原因不明のエラーが発生しました。

このメソッドは ITextStoreAnchorSink::OnLockGranted メソッドを使用してドキュメントをロックします。アプリケーションは、ITextStoreAnchor::RequestLock メソッドの内部でドキュメントを変更したり、ITextStoreAnchorSink::OnTextChange メソッドで変更通知を送信したりしてはなりません。報告すべき変更が保留中の場合、アプリケーションは非同期のロック要求にのみ応答できます。

アプリケーションは、複数の ITextStoreAnchor::RequestLock メソッド呼び出しをキューに入れようとしないでください。必要なコールバックは 1 回だけだからです。ただし、呼び出し側が複数の読み取り要求と 1 つ以上の書き込み要求を行った場合、コールバックは書き込みアクセス用にする必要があります。

同期ロックの要求が成功した場合、その要求は非同期ロックの要求に優先します。同期ロックの要求が失敗した場合は、非同期ロックの要求に優先しません。実装側は、未処理の非同期要求が存在する場合、その要求を引き続き処理する必要があります。

ITextStoreAnchor::RequestLock メソッドが返る前にロックが許可された場合、phrSession パラメーターは ITextStoreAnchorSink::OnLockGranted メソッドが返した HRESULT を受け取ります。呼び出しは成功したものの、ロックが後で許可される場合、phrSession パラメーターは TS_S_ASYNC フラグを受け取ります。ITextStoreAnchor::RequestLock が S_OK 以外を返した場合、phrSession パラメーターは無視してください。

呼び出し側は、このメソッドを再入的に呼び出してはなりません。ただし、呼び出し側が読み取り専用ロックを保持している場合は例外です。この場合、非同期の書き込みロックを要求するために再入的に呼び出すことができます。書き込みロックは、読み取り専用ロックが終了した後で許可されます。

ドキュメントのロックの詳細については、Document Locks を参照してください。

ITextStoreAnchor::GetStatus メソッドは、ドキュメントの状態を取得します。ドキュメントの状態は TS_STATUS 構造体として返されます。

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

値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	TS_STATUS パラメーターへのポインターが無効です。

ITextStoreAnchor::QueryInsert メソッドは、指定された開始アンカーと終了アンカーが有効かどうかを判定します。ドキュメントへの編集を実行する前に、その編集内容を調整するためにこのメソッドを使用します。このメソッドは、ドキュメントの範囲外の値を返してはなりません。

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

値	説明
S_OK	メソッドは成功しました。
E_FAIL	原因不明のエラーが発生しました。
E_INVALIDARG	paTestStart または paTestEnd パラメーターが無効です。
E_OUTOFMEMORY	ppaResultStart または ppaResultEnd のアンカーの生成に失敗しました。

ppaResultStart と ppaResultEnd の値は、アプリケーションがドキュメントにテキストを挿入する方法によって異なります。ppaResultStart と ppaResultEnd が paTestStart と同じ場合、挿入後のカーソルは挿入されたテキストの先頭に位置します。ppaResultStart と ppaResultEnd が paTextEnd と同じ場合、挿入後のカーソルは挿入されたテキストの末尾に位置します。

ITextStoreAnchor::GetSelection メソッドは、テキストストリーム内の選択テキストのオフセットを返します。このメソッドは複数のテキスト選択をサポートします。呼び出し側は、このメソッドを呼び出す前にドキュメントの読み取り専用ロックを取得しておく必要があります。

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

値	説明
S_OK	メソッドは成功しました。
E_FAIL	開始アンカーまたは終了アンカーを TS_SELECTION_ANCHOR 構造体に格納できませんでした。
E_OUTOFMEMORY	選択用のメモリを割り当てられませんでした。
TS_E_NOLOCK	呼び出し側がドキュメントの読み取り専用ロックを保持していません。
TS_E_NOSELECTION	ドキュメントに選択がありません。

ITextStoreAnchor::SetSelection メソッド

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

値	説明
S_OK	メソッドは成功しました。
E_FAIL	原因不明のエラーが発生しました。
E_OUTOFMEMORY	処理を完了するのに十分なメモリを割り当てられませんでした。
TF_E_INVALIDPOS	指定されたアンカー位置がドキュメント内のテキストの範囲を超えています。
TF_E_NOLOCK	呼び出し側が読み取り/書き込みロックを保持していません。

ITextStoreAnchor::GetText メソッドは、指定されたアンカー位置のテキストに関する情報を返します。このメソッドは表示テキストと非表示テキストを返し、埋め込みデータがテキストに付随しているかどうかを示します。

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

値	説明
S_OK	メソッドは正常に完了しました。
E_FAIL	paStart または paEnd の有効なインターフェイスポインターを取得できませんでした。
TF_E_INVALIDPOS	paStart または paEnd のアンカーがドキュメントのテキストの外部にあります。
TS_E_NOLOCK	呼び出し側がドキュメントの読み取り専用ロックを保持していません。

このメソッドを使用する呼び出し側は、ITextStoreAnchor::RequestLock メソッドを呼び出してドキュメントの読み取り専用ロックを取得しておく必要があります。読み取り専用ロックがない場合、このメソッドは失敗し TF_E_NOLOCK を返します。

アプリケーションは、内部的な理由によりメソッドの戻り値を切り詰めることがあります。

複数回の GetText 呼び出しでテキストを高速に走査するには、呼び出し側は fUpdateAnchor = TRUE を使用します。

paStart と paEnd の間の文字数が cchReq より少ない場合、実際にコピーされる文字数は cchReq より少なくなることがあります。

GetText の動作は、返されるテキストが含むリージョン境界の影響を受けません。

ITextStoreAnchor::SetText メソッドは、指定された 2 つのアンカー位置の間のテキスト選択を設定します。

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

値	説明
S_OK	メソッドは成功しました。
E_FAIL	アンカー paStart または paEnd のいずれかを生成できませんでした。
TS_E_INVALIDPOS	paStart または paEnd の位置がドキュメントのテキストの外部にあります。
TS_E_NOLOCK	呼び出し側が読み取り/書き込みロックを保持していません。
TS_E_READONLY	ドキュメントは読み取り専用です。内容を変更できません。
TS_E_REGION	リージョン境界をまたいでテキストを変更しようとしました。

アプリケーションは、まず ITextStoreAnchor::InsertTextAtSelection を使用してコンポジション(変換中の文字列)を開始してください。ITextStoreAnchor::SetText は、既存のコンポジション内でのみ使用してください。SetText を呼び出した時点でアクティブなコンポジションが存在しない場合、TSF マネージャーは SetText の呼び出しを包含するだけの短命なコンポジションを作成します。

呼び出し側は、ITextStoreAnchor::RequestLock で取得した書き込みロックを保持している必要があります。保持していない場合、ITextStoreAnchor::SetText は TS_E_NOLOCK で失敗します。

paStart が paEnd と同じ位置にある場合、操作は挿入となり、既存のテキストは削除されません。

TS_CHAR_EMBEDDED をこのメソッドに渡すことはできません。埋め込みオブジェクトには、代わりに ITextStoreAnchor::InsertEmbedded を使用してください。

置き換えるテキスト範囲がリージョン境界をまたぐ場合、このメソッドは失敗します。その場合、呼び出し側はリージョンごとにメソッドを複数回呼び出してください。

ITextStoreAnchor::GetFormattedText メソッドは、テキストストリームから書式付きテキストの情報を返します。

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

値	説明
S_OK	メソッドは成功しました。
E_FAIL	開始アンカーまたは終了アンカーの有効なインターフェイスポインターを取得できませんでした。
E_NOTIMPL	メソッドが実装されていない場合、アプリケーションはこの値を返すことができます。
TS_E_NOLOCK	呼び出し側がドキュメントの読み取り/書き込みロックを保持していません。

テキスト、埋め込みオブジェクト、およびすべての書式は、単一の IDataObject オブジェクトにまとめられます。これにより、クライアントはテキストに関連付けられたアプリケーション固有のプライベートな書式を保持できます。

ITextStoreAnchor::GetEmbedded メソッドは、テキストストリームから埋め込みオブジェクトを取得します。

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

値	説明
S_OK	メソッドは成功しました。
E_FAIL	要求されたオブジェクトを取得できませんでした。
E_INVALIDARG	1 つ以上のパラメーターが無効です。
E_NOTIMPL	実装側のアプリケーションは、テキストストリーム内に埋め込みオブジェクトを公開していません。
TF_E_INVALIDPOS	要求された paPos アンカーがドキュメント内にありません。
TS_E_NOINTERFACE	要求されたインターフェイスの型はサポートされていません。
TS_E_NOLOCK	呼び出し側が読み取り専用ロックを保持していません。
TS_E_NOOBJECT	TS_CHAR_EMBEDDED 文字の直前に paPos アンカーがありません。
TS_E_NOSERVICE	rguidService で指定されたサービスの種類はサポートされていません。

呼び出し側は QueryInterface を使用して適切なインターフェイスを探索する必要があります。対象となるインターフェイスには、IOleObject、IDataObject、IViewObject、IPersistStorage、IOleCache、IDispatch など、埋め込みドキュメントやコントロールに関連するものが含まれます。

ITextStoreAnchor::InsertEmbedded メソッド

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

値	説明
S_OK	メソッドは成功しました。
E_FAIL	開始アンカーまたは終了アンカーの有効なインターフェイスポインターを取得できませんでした。
E_INVALIDARG	1 つ以上の入力パラメーターが無効です。
E_NOTIMPL	アプリケーションは埋め込みオブジェクトをサポートしていません。
TS_E_FORMAT	アプリケーションは pDataObject に含まれるデータ型をサポートしていません。
TS_E_INVALIDPOS	paStart または paEnd がドキュメント内にありません。
TS_E_NOLOCK	呼び出し側が読み取り/書き込みロックを保持していません。

ITextStoreAnchor::RequestSupportedAttrs メソッド

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

値	説明
S_OK	メソッドは成功しました。
E_FAIL	原因不明のエラーが発生しました。
E_OUTOFMEMORY	処理を完了するのに十分なメモリを割り当てられませんでした。

ITextStoreAnchor::RequestAttrsAtPosition メソッド

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

値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	paPos アンカーが無効です。

ITextStoreAnchor::RequestAttrsTransitioningAtPosition メソッド

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

値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	paPos が無効です。

「This is italic text.」という文では、italic 属性は単語 italic の前で開始し、単語 text の後で終了します。

dwFlags に TS_ATTR_FIND_WANT_END フラグが設定されている場合、「italic <anchor>normal」というテキストに対して、アンカー位置に終了の遷移があるため、メソッドは italic 属性を返します。

ITextStoreAnchor::FindNextAttrTransition メソッドは、属性値の遷移が発生するテキストストリーム内の位置を検索します。確認対象として指定する属性はアプリケーションに依存します。

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

値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	paStart または paHalt が無効です。
TS_E_INVALIDPOS	指定された文字位置がドキュメント内のテキストの範囲を超えています。

ITextStoreAnchor::RetrieveRequestedAttrs メソッド

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

値	説明
S_OK	メソッドは成功しました。

ITextStoreAnchor::GetStart メソッドは、テキストストリームの先頭に位置するアンカーを返します。

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

値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	ppaStart が無効です。
E_OUTOFMEMORY	テキストストリームの先頭にアンカーを生成できませんでした。

ITextStoreAnchor::GetEnd メソッドは、テキストストリームの末尾に位置するアンカーを返します。

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

値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	ppaEnd が無効です。
E_NOTIMPL	アプリケーションがこのメソッドを実装していません。これは通常、終了位置の算出に過大なリソースが必要であることを示します。終了位置が必要な場合は、ITextStoreAnchor::GetText を使用して算出できますが、これもディスクから任意の大きさのメモリをページインする、メモリを大量に消費する操作になる可能性があります。
E_OUTOFMEMORY	ドキュメントの末尾にアンカーを生成できませんでした。
TS_E_NOLOCK	呼び出し側が読み取り専用ロックを保持していません。

ITextStoreAnchor::GetActiveView メソッドは、現在のアクティブなビューを示す TsViewCookie データ型を返します。TSF はアクティブなビューを 1 つしかサポートしないため、特定のテキストストアは常に同じ TsViewCookie データ型を返す必要があります。

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

値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	pvcView が無効です。

ITextStoreAnchor::GetAnchorFromPoint メソッドは、スクリーン座標の点を、対応する位置に配置されたアンカーに変換します。

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

値	説明
S_OK	メソッドは成功しました。
E_FAIL	メソッドは失敗しました。
E_INVALIDARG	1 つ以上の入力パラメーターが無効です。
E_OUTOFMEMORY	指定された位置にアンカーを生成できませんでした。
TS_E_INVALIDPOINT	ptScreen パラメーターがどの文字の境界ボックスにも含まれていません。
TS_E_NOLAYOUT	アプリケーションがまだテキストレイアウトを算出していません。

点 1 のスクリーン座標は文字位置 0 の文字境界ボックス内にあるため、既定の場合、または dwFlags パラメーターに GXFPF_NEAREST を設定した場合、アンカー ppaSite のオフセット(文字位置)は 0 になります。点 1 に対して dwFlags パラメーターに GXFPF_ROUND_NEAREST を設定した場合、点 1 のスクリーン座標はレンジ位置 1 に最も近いため、アンカーのオフセットは 1 になります。レンジ位置 1 は、文字位置 1 の開始レンジ位置です。

点 2 のスクリーン座標は文字の境界ボックスの外にあるため、既定の場合、または dwFlags パラメーターに GXFPF_NEAREST を設定した場合、メソッドは TF_E_INVALIDPOINT を返します。dwFlags パラメーターに GXFPF_ROUND_NEAREST を設定した場合、点 2 のスクリーン座標に最も近い文字位置は文字位置 1 であるため、アンカーのオフセットは 1 になります。

点 1

• 既定 -- アンカーのオフセット = 0 -- 点のスクリーン座標が文字位置 0 の文字境界ボックス内にあるためです。
• GXFPF_ROUND_NEAREST -- アンカーのオフセット = 1 -- 点のスクリーン座標が、文字位置 1 の開始レンジ位置であるレンジ位置 1 に最も近いためです。
• GXFPF_NEAREST -- アンカーのオフセット = 0 -- 点が文字位置 0 の文字境界ボックス内にあるため、既定の動作になります。

点 2

• 既定 -- hr = TF_E_INVALIDPOINT -- 点のスクリーン座標が文字の境界ボックスの外にあるためです。
• GXFPF_ROUND_NEAREST -- hr = TF_E_INVALIDPOINT -- 点のスクリーン座標が文字の境界ボックスの外にあるため、既定の動作になります。
• GXFPF_NEAREST -- アンカーのオフセット = 1 -- 点のスクリーン座標に最も近い文字位置が文字位置 1 であるためです。

ITextStoreAnchor::GetTextExt メソッドは、テキスト範囲(レンジ)の境界ボックスをスクリーン座標で返します。呼び出し側は、このメソッドを呼び出す前にドキュメントの読み取り専用ロックを取得しておく必要があります。

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

値	説明
S_OK	メソッドは成功しました。
E_FAIL	開始アンカーまたは終了アンカーの有効なインターフェイスポインターを取得できませんでした。
TS_E_INVALIDARG	1 つ以上の入力パラメーターが無効です。
TS_E_INVALIDPOS	paStart および paEnd パラメーターで指定された範囲が、ドキュメントの先頭または末尾を越えています。
TS_E_NOLAYOUT	アプリケーションがテキストレイアウトを算出していません。アプリケーションが ITextStoreAnchorSink::OnLayoutChange を呼び出すまで、以降の呼び出しは成功しません。
TS_E_NOLOCK	呼び出し側がドキュメントの読み取り専用ロックを保持していません。

ドキュメントのウィンドウが最小化されている場合、または指定されたテキストが現在表示されていない場合、メソッドは prc パラメーターを {0,0,0,0} に設定して S_OK を返します。

ITextStoreAnchor::GetScreenExt メソッドは、テキストストリームが描画される表示面の境界ボックスをスクリーン座標で返します。

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

値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	指定された vcView パラメーターが無効です。

ドキュメントのウィンドウが最小化されている場合など、テキストが現在表示されていない場合、prc パラメーターは { 0, 0, 0, 0 } に設定されます。

ITextStoreAnchor::GetWnd メソッドは、現在のテキストストリームに対応するウィンドウのハンドルを返します。

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

値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	TsViewCookie データ型が無効です。

ドキュメントがメモリ上に存在するが画面に表示されていない場合、またはドキュメントがウィンドウレスコントロールであり、そのコントロールがウィンドウレスコントロールの所有者のウィンドウハンドルを認識していない場合、ドキュメントに対応するウィンドウハンドルが存在しないことがあります。呼び出し側は、メソッドが成功した場合でも phwnd パラメーターが非 NULL の値を受け取ると想定してはなりません。呼び出し側は phwnd パラメーターとして NULL を受け取ることもあります。

ITextStoreAnchor::QueryInsertEmbedded メソッド

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

値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	pFormatEtc パラメーターが NULL です。

ドキュメントがサポートするクリップボード形式は、アプリケーションに依存します。

ITextStoreAnchor::InsertTextAtSelection メソッド

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

値	説明
S_OK	メソッドは成功しました。
E_FAIL	アンカー paStart または paEnd のいずれかを生成できませんでした。
E_INVALIDARG	pchText パラメーターが無効です。
TS_E_NOLOCK	呼び出し側がドキュメントのロックを保持していません。

ITextStoreAnchor::InsertEmbeddedAtSelection メソッドは、挿入ポイントまたは選択範囲に IDataObject オブジェクトを挿入します。このメソッドを呼び出すクライアントは、テキストストリームに IDataObject を挿入する前に読み取り/書き込みロックを取得しておく必要があります。

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

値	説明
S_OK	メソッドは成功しました。
E_FAIL	アンカー paStart または paEnd のいずれかを生成できませんでした。
E_INVALIDARG	pchText パラメーターが無効です。
E_OUTOFMEMORY	アンカー paStart または paEnd のいずれかを生成できませんでした。
TS_E_NOLOCK	呼び出し側がドキュメントのロックを保持していません。

TS_CHAR_EMBEDDED 定数は ITextStoreAnchor::SetText に渡せないため、クライアントはテキストストリームにオブジェクトを挿入する際に必ずこのメソッドを使用する必要があります。

#define global IID_ITextStoreAnchor "{9B2077B0-5F18-4DEC-BEE9-3CC722F5DFE0}"
#usecom global ITextStoreAnchor IID_ITextStoreAnchor "{}"
#comfunc global ITextStoreAnchor_AdviseSink                           3 var,sptr,int
#comfunc global ITextStoreAnchor_UnadviseSink                         4 sptr
#comfunc global ITextStoreAnchor_RequestLock                          5 int,var
#comfunc global ITextStoreAnchor_GetStatus                            6 var
#comfunc global ITextStoreAnchor_QueryInsert                          7 sptr,sptr,int,sptr,sptr
#comfunc global ITextStoreAnchor_GetSelection                         8 int,int,var,var
#comfunc global ITextStoreAnchor_SetSelection                         9 int,var
#comfunc global ITextStoreAnchor_GetText                              10 int,sptr,sptr,var,int,var,int
#comfunc global ITextStoreAnchor_SetText                              11 int,sptr,sptr,wstr,int
#comfunc global ITextStoreAnchor_GetFormattedText                     12 sptr,sptr,sptr
#comfunc global ITextStoreAnchor_GetEmbedded                          13 int,sptr,var,var,sptr
#comfunc global ITextStoreAnchor_InsertEmbedded                       14 int,sptr,sptr,sptr
#comfunc global ITextStoreAnchor_RequestSupportedAttrs                15 int,int,var
#comfunc global ITextStoreAnchor_RequestAttrsAtPosition               16 sptr,int,var,int
#comfunc global ITextStoreAnchor_RequestAttrsTransitioningAtPosition  17 sptr,int,var,int
#comfunc global ITextStoreAnchor_FindNextAttrTransition               18 sptr,sptr,int,var,int,var,var
#comfunc global ITextStoreAnchor_RetrieveRequestedAttrs               19 int,var,var
#comfunc global ITextStoreAnchor_GetStart                             20 sptr
#comfunc global ITextStoreAnchor_GetEnd                               21 sptr
#comfunc global ITextStoreAnchor_GetActiveView                        22 var
#comfunc global ITextStoreAnchor_GetAnchorFromPoint                   23 int,var,int,sptr
#comfunc global ITextStoreAnchor_GetTextExt                           24 int,sptr,sptr,var,var
#comfunc global ITextStoreAnchor_GetScreenExt                         25 int,var
#comfunc global ITextStoreAnchor_GetWnd                               26 int,sptr
#comfunc global ITextStoreAnchor_QueryInsertEmbedded                  27 var,var,var
#comfunc global ITextStoreAnchor_InsertTextAtSelection                28 int,wstr,int,sptr,sptr
#comfunc global ITextStoreAnchor_InsertEmbeddedAtSelection            29 int,sptr,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。