ホーム › Web.MsHtml › IHTMLTxtRange
IHTMLTxtRange
COMIDispatch (デュアル)✅ IDispatch を実装(デュアルインターフェース)。HSP では
comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。メソッド 30
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
| p | LPWSTR* | out | 範囲内のテキストを HTML タグ付きで受け取る文字列ポインタである。 |
| v | LPWSTR | in | 範囲のプレーンテキスト内容を設定する文字列である。 |
| p | LPWSTR* | out | 範囲のプレーンテキスト内容を受け取る文字列ポインタである。 |
vtbl 10 HRESULT parentElement(IHTMLElement** parent)
| parent | IHTMLElement** | out | 範囲全体を含む親要素を受け取る IHTMLElement インターフェイスへのポインタである。 |
vtbl 11 HRESULT duplicate(IHTMLTxtRange** Duplicate)
| Duplicate | IHTMLTxtRange** | out | 現在の範囲を複製した新しいテキスト範囲を受け取る IHTMLTxtRange インターフェイスへのポインタである。 |
vtbl 12 HRESULT inRange(IHTMLTxtRange* Range, VARIANT_BOOL* InRange)
| Range | IHTMLTxtRange* | in | 包含関係を判定する対象のテキスト範囲を指定する IHTMLTxtRange へのポインタである。 |
| InRange | VARIANT_BOOL* | out | 指定範囲が現在の範囲に含まれるかどうかを受け取る真偽値ポインタである。 |
vtbl 13 HRESULT isEqual(IHTMLTxtRange* Range, VARIANT_BOOL* IsEqual)
| Range | IHTMLTxtRange* | in | 等価性を判定する対象のテキスト範囲を指定する IHTMLTxtRange へのポインタである。 |
| IsEqual | VARIANT_BOOL* | out | 両範囲が同一かどうかを受け取る真偽値ポインタである。 |
vtbl 14 HRESULT scrollIntoView(VARIANT_BOOL fStart)
| fStart | VARIANT_BOOL | in | VARIANT_TRUE のとき範囲の先頭が、VARIANT_FALSE のとき末尾が表示されるようにスクロールするかを指定する真偽値である。 |
vtbl 15 HRESULT collapse(VARIANT_BOOL Start)
| Start | VARIANT_BOOL | in | VARIANT_TRUE のとき範囲を先頭へ、VARIANT_FALSE のとき末尾へ折りたたむかを指定する真偽値である。 |
vtbl 16 HRESULT expand(LPWSTR Unit, VARIANT_BOOL* Success)
| Unit | LPWSTR | in | 範囲を拡張する単位("character", "word", "sentence", "textedit")を指定する文字列である。 |
| Success | VARIANT_BOOL* | out | 拡張が成功したかどうかを受け取る真偽値ポインタである。 |
| Unit | LPWSTR | in | 移動の単位("character", "word", "sentence", "textedit")を指定する文字列である。 |
| Count | INT | in | 移動する単位数を指定する。負値は逆方向への移動を表す。 |
| ActualCount | INT* | out | 実際に移動した単位数を受け取るポインタである。 |
| Unit | LPWSTR | in | 範囲開始位置を移動する単位を指定する文字列である。 |
| Count | INT | in | 開始位置を移動する単位数を指定する。負値は逆方向を表す。 |
| ActualCount | INT* | out | 実際に移動した単位数を受け取るポインタである。 |
| Unit | LPWSTR | in | 範囲終了位置を移動する単位を指定する文字列である。 |
| Count | INT | in | 終了位置を移動する単位数を指定する。負値は逆方向を表す。 |
| ActualCount | INT* | out | 実際に移動した単位数を受け取るポインタである。 |
vtbl 20 HRESULT select()
| html | LPWSTR | in | 範囲に貼り付ける HTML テキストを指定する文字列である。 |
vtbl 22 HRESULT moveToElementText(IHTMLElement* element)
| element | IHTMLElement* | in | 範囲をそのテキスト全体に合わせる対象要素を指定する IHTMLElement へのポインタである。 |
vtbl 23 HRESULT setEndPoint(LPWSTR how, IHTMLTxtRange* SourceRange)
| how | LPWSTR | in | 対象範囲のどの端点に揃えるか("StartToStart", "StartToEnd", "EndToStart", "EndToEnd")を指定する文字列である。 |
| SourceRange | IHTMLTxtRange* | in | 端点の基準となるソース範囲を指定する IHTMLTxtRange へのポインタである。 |
vtbl 24 HRESULT compareEndPoints(LPWSTR how, IHTMLTxtRange* SourceRange, INT* ret)
| how | LPWSTR | in | 比較する端点の組み合わせ("StartToStart" 等)を指定する文字列である。 |
| SourceRange | IHTMLTxtRange* | in | 比較対象のソース範囲を指定する IHTMLTxtRange へのポインタである。 |
| ret | INT* | out | 比較結果(負値, 0, 正値で前後関係を表す)を受け取るポインタである。 |
vtbl 25 HRESULT findText(LPWSTR String, INT count, INT Flags, VARIANT_BOOL* Success)
| String | LPWSTR | in | 検索する文字列を指定する。 |
| count | INT | in | 検索対象とする文字数(検索方向と範囲を表す)を指定する。 |
| Flags | INT | in | 大文字小文字や単語単位の一致など検索条件を表すフラグを指定する。 |
| Success | VARIANT_BOOL* | out | 文字列が見つかったかどうかを受け取る真偽値ポインタである。 |
| x | INT | in | 範囲を移動する先のクライアント座標 X を指定する。 |
| y | INT | in | 範囲を移動する先のクライアント座標 Y を指定する。 |
| Boolmark | LPWSTR* | out | 現在の範囲位置を表す不透明なブックマーク文字列を受け取るポインタである。 |
vtbl 28 HRESULT moveToBookmark(LPWSTR Bookmark, VARIANT_BOOL* Success)
| Bookmark | LPWSTR | in | getBookmark で取得したブックマーク文字列を指定する。 |
| Success | VARIANT_BOOL* | out | ブックマーク位置への移動が成功したかどうかを受け取る真偽値ポインタである。 |
vtbl 29 HRESULT queryCommandSupported(LPWSTR cmdID, VARIANT_BOOL* pfRet)
| cmdID | LPWSTR | in | 対応状況を問い合わせるコマンドの識別子を指定する文字列である。 |
| pfRet | VARIANT_BOOL* | out | そのコマンドがサポートされているかどうかを受け取る真偽値ポインタである。 |
vtbl 30 HRESULT queryCommandEnabled(LPWSTR cmdID, VARIANT_BOOL* pfRet)
| cmdID | LPWSTR | in | 有効状態を問い合わせるコマンドの識別子を指定する文字列である。 |
| pfRet | VARIANT_BOOL* | out | 現在のコンテキストでそのコマンドが実行可能かどうかを受け取る真偽値ポインタである。 |
vtbl 31 HRESULT queryCommandState(LPWSTR cmdID, VARIANT_BOOL* pfRet)
| cmdID | LPWSTR | in | 状態を問い合わせるコマンドの識別子を指定する文字列である。 |
| pfRet | VARIANT_BOOL* | out | コマンドの現在の状態(オン/オフ)を受け取る真偽値ポインタである。 |
vtbl 32 HRESULT queryCommandIndeterm(LPWSTR cmdID, VARIANT_BOOL* pfRet)
| cmdID | LPWSTR | in | 不定状態を問い合わせるコマンドの識別子を指定する文字列である。 |
| pfRet | VARIANT_BOOL* | out | コマンドの状態が不定かどうかを受け取る真偽値ポインタである。 |
| cmdID | LPWSTR | in | テキストを問い合わせるコマンドの識別子を指定する文字列である。 |
| pcmdText | LPWSTR* | out | コマンドに関連付けられたテキストを受け取る文字列ポインタである。 |
| cmdID | LPWSTR | in | 値を問い合わせるコマンドの識別子を指定する文字列である。 |
| pcmdValue | VARIANT* | out | コマンドの現在値を受け取るバリアントポインタである。 |
vtbl 35 HRESULT execCommand(LPWSTR cmdID, VARIANT_BOOL showUI, VARIANT value, VARIANT_BOOL* pfRet)
| cmdID | LPWSTR | in | 実行するコマンドの識別子を指定する文字列である。 |
| showUI | VARIANT_BOOL | in | コマンドの UI を表示するかどうかを指定する真偽値である。 |
| value | VARIANT | in | コマンドに渡す引数値を指定するバリアントである。値が不要な場合は空のバリアントを渡す。 |
| pfRet | VARIANT_BOOL* | out | コマンドが正常に実行されたかどうかを受け取る真偽値ポインタである。 |
vtbl 36 HRESULT execCommandShowHelp(LPWSTR cmdID, VARIANT_BOOL* pfRet)
| cmdID | LPWSTR | in | ヘルプを表示するコマンドの識別子を指定する文字列である。 |
| pfRet | VARIANT_BOOL* | out | ヘルプ表示が成功したかどうかを受け取る真偽値ポインタである。 |
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IHTMLTxtRange "{3050F220-98B5-11CF-BB82-00AA00BDCE0B}" #usecom global IHTMLTxtRange IID_IHTMLTxtRange "{}" #comfunc global IHTMLTxtRange_get_htmlText 7 var #comfunc global IHTMLTxtRange_put_text 8 wstr #comfunc global IHTMLTxtRange_get_text 9 var #comfunc global IHTMLTxtRange_parentElement 10 sptr #comfunc global IHTMLTxtRange_duplicate 11 sptr #comfunc global IHTMLTxtRange_inRange 12 sptr,var #comfunc global IHTMLTxtRange_isEqual 13 sptr,var #comfunc global IHTMLTxtRange_scrollIntoView 14 int #comfunc global IHTMLTxtRange_collapse 15 int #comfunc global IHTMLTxtRange_expand 16 wstr,var #comfunc global IHTMLTxtRange_move 17 wstr,int,var #comfunc global IHTMLTxtRange_moveStart 18 wstr,int,var #comfunc global IHTMLTxtRange_moveEnd 19 wstr,int,var #comfunc global IHTMLTxtRange_select 20 #comfunc global IHTMLTxtRange_pasteHTML 21 wstr #comfunc global IHTMLTxtRange_moveToElementText 22 sptr #comfunc global IHTMLTxtRange_setEndPoint 23 wstr,sptr #comfunc global IHTMLTxtRange_compareEndPoints 24 wstr,sptr,var #comfunc global IHTMLTxtRange_findText 25 wstr,int,int,var #comfunc global IHTMLTxtRange_moveToPoint 26 int,int #comfunc global IHTMLTxtRange_getBookmark 27 var #comfunc global IHTMLTxtRange_moveToBookmark 28 wstr,var #comfunc global IHTMLTxtRange_queryCommandSupported 29 wstr,var #comfunc global IHTMLTxtRange_queryCommandEnabled 30 wstr,var #comfunc global IHTMLTxtRange_queryCommandState 31 wstr,var #comfunc global IHTMLTxtRange_queryCommandIndeterm 32 wstr,var #comfunc global IHTMLTxtRange_queryCommandText 33 wstr,var #comfunc global IHTMLTxtRange_queryCommandValue 34 wstr,var #comfunc global IHTMLTxtRange_execCommand 35 wstr,int,int,var #comfunc global IHTMLTxtRange_execCommandShowHelp 36 wstr,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IHTMLTxtRange "{3050F220-98B5-11CF-BB82-00AA00BDCE0B}" #usecom global IHTMLTxtRange IID_IHTMLTxtRange "{}" #comfunc global IHTMLTxtRange_get_htmlText 7 sptr #comfunc global IHTMLTxtRange_put_text 8 wstr #comfunc global IHTMLTxtRange_get_text 9 sptr #comfunc global IHTMLTxtRange_parentElement 10 sptr #comfunc global IHTMLTxtRange_duplicate 11 sptr #comfunc global IHTMLTxtRange_inRange 12 sptr,sptr #comfunc global IHTMLTxtRange_isEqual 13 sptr,sptr #comfunc global IHTMLTxtRange_scrollIntoView 14 int #comfunc global IHTMLTxtRange_collapse 15 int #comfunc global IHTMLTxtRange_expand 16 wstr,sptr #comfunc global IHTMLTxtRange_move 17 wstr,int,sptr #comfunc global IHTMLTxtRange_moveStart 18 wstr,int,sptr #comfunc global IHTMLTxtRange_moveEnd 19 wstr,int,sptr #comfunc global IHTMLTxtRange_select 20 #comfunc global IHTMLTxtRange_pasteHTML 21 wstr #comfunc global IHTMLTxtRange_moveToElementText 22 sptr #comfunc global IHTMLTxtRange_setEndPoint 23 wstr,sptr #comfunc global IHTMLTxtRange_compareEndPoints 24 wstr,sptr,sptr #comfunc global IHTMLTxtRange_findText 25 wstr,int,int,sptr #comfunc global IHTMLTxtRange_moveToPoint 26 int,int #comfunc global IHTMLTxtRange_getBookmark 27 sptr #comfunc global IHTMLTxtRange_moveToBookmark 28 wstr,sptr #comfunc global IHTMLTxtRange_queryCommandSupported 29 wstr,sptr #comfunc global IHTMLTxtRange_queryCommandEnabled 30 wstr,sptr #comfunc global IHTMLTxtRange_queryCommandState 31 wstr,sptr #comfunc global IHTMLTxtRange_queryCommandIndeterm 32 wstr,sptr #comfunc global IHTMLTxtRange_queryCommandText 33 wstr,sptr #comfunc global IHTMLTxtRange_queryCommandValue 34 wstr,sptr #comfunc global IHTMLTxtRange_execCommand 35 wstr,int,int,sptr #comfunc global IHTMLTxtRange_execCommandShowHelp 36 wstr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。