Win32 API 日本語リファレンス
ホームWeb.MsHtml › IHTMLTxtRange

IHTMLTxtRange

COMIDispatch (デュアル)
IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID3050f220-98b5-11cf-bb82-00aa00bdce0b継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 30

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_htmlText(LPWSTR* p)
pLPWSTR*out範囲内のテキストを HTML タグ付きで受け取る文字列ポインタである。
vtbl 8 HRESULT put_text(LPWSTR v)
vLPWSTRin範囲のプレーンテキスト内容を設定する文字列である。
vtbl 9 HRESULT get_text(LPWSTR* p)
pLPWSTR*out範囲のプレーンテキスト内容を受け取る文字列ポインタである。
vtbl 10 HRESULT parentElement(IHTMLElement** parent)
parentIHTMLElement**out範囲全体を含む親要素を受け取る IHTMLElement インターフェイスへのポインタである。
vtbl 11 HRESULT duplicate(IHTMLTxtRange** Duplicate)
DuplicateIHTMLTxtRange**out現在の範囲を複製した新しいテキスト範囲を受け取る IHTMLTxtRange インターフェイスへのポインタである。
vtbl 12 HRESULT inRange(IHTMLTxtRange* Range, VARIANT_BOOL* InRange)
RangeIHTMLTxtRange*in包含関係を判定する対象のテキスト範囲を指定する IHTMLTxtRange へのポインタである。
InRangeVARIANT_BOOL*out指定範囲が現在の範囲に含まれるかどうかを受け取る真偽値ポインタである。
vtbl 13 HRESULT isEqual(IHTMLTxtRange* Range, VARIANT_BOOL* IsEqual)
RangeIHTMLTxtRange*in等価性を判定する対象のテキスト範囲を指定する IHTMLTxtRange へのポインタである。
IsEqualVARIANT_BOOL*out両範囲が同一かどうかを受け取る真偽値ポインタである。
vtbl 14 HRESULT scrollIntoView(VARIANT_BOOL fStart)
fStartVARIANT_BOOLinVARIANT_TRUE のとき範囲の先頭が、VARIANT_FALSE のとき末尾が表示されるようにスクロールするかを指定する真偽値である。
vtbl 15 HRESULT collapse(VARIANT_BOOL Start)
StartVARIANT_BOOLinVARIANT_TRUE のとき範囲を先頭へ、VARIANT_FALSE のとき末尾へ折りたたむかを指定する真偽値である。
vtbl 16 HRESULT expand(LPWSTR Unit, VARIANT_BOOL* Success)
UnitLPWSTRin範囲を拡張する単位("character", "word", "sentence", "textedit")を指定する文字列である。
SuccessVARIANT_BOOL*out拡張が成功したかどうかを受け取る真偽値ポインタである。
vtbl 17 HRESULT move(LPWSTR Unit, INT Count, INT* ActualCount)
UnitLPWSTRin移動の単位("character", "word", "sentence", "textedit")を指定する文字列である。
CountINTin移動する単位数を指定する。負値は逆方向への移動を表す。
ActualCountINT*out実際に移動した単位数を受け取るポインタである。
vtbl 18 HRESULT moveStart(LPWSTR Unit, INT Count, INT* ActualCount)
UnitLPWSTRin範囲開始位置を移動する単位を指定する文字列である。
CountINTin開始位置を移動する単位数を指定する。負値は逆方向を表す。
ActualCountINT*out実際に移動した単位数を受け取るポインタである。
vtbl 19 HRESULT moveEnd(LPWSTR Unit, INT Count, INT* ActualCount)
UnitLPWSTRin範囲終了位置を移動する単位を指定する文字列である。
CountINTin終了位置を移動する単位数を指定する。負値は逆方向を表す。
ActualCountINT*out実際に移動した単位数を受け取るポインタである。
vtbl 20 HRESULT select()
vtbl 21 HRESULT pasteHTML(LPWSTR html)
htmlLPWSTRin範囲に貼り付ける HTML テキストを指定する文字列である。
vtbl 22 HRESULT moveToElementText(IHTMLElement* element)
elementIHTMLElement*in範囲をそのテキスト全体に合わせる対象要素を指定する IHTMLElement へのポインタである。
vtbl 23 HRESULT setEndPoint(LPWSTR how, IHTMLTxtRange* SourceRange)
howLPWSTRin対象範囲のどの端点に揃えるか("StartToStart", "StartToEnd", "EndToStart", "EndToEnd")を指定する文字列である。
SourceRangeIHTMLTxtRange*in端点の基準となるソース範囲を指定する IHTMLTxtRange へのポインタである。
vtbl 24 HRESULT compareEndPoints(LPWSTR how, IHTMLTxtRange* SourceRange, INT* ret)
howLPWSTRin比較する端点の組み合わせ("StartToStart" 等)を指定する文字列である。
SourceRangeIHTMLTxtRange*in比較対象のソース範囲を指定する IHTMLTxtRange へのポインタである。
retINT*out比較結果(負値, 0, 正値で前後関係を表す)を受け取るポインタである。
vtbl 25 HRESULT findText(LPWSTR String, INT count, INT Flags, VARIANT_BOOL* Success)
StringLPWSTRin検索する文字列を指定する。
countINTin検索対象とする文字数(検索方向と範囲を表す)を指定する。
FlagsINTin大文字小文字や単語単位の一致など検索条件を表すフラグを指定する。
SuccessVARIANT_BOOL*out文字列が見つかったかどうかを受け取る真偽値ポインタである。
vtbl 26 HRESULT moveToPoint(INT x, INT y)
xINTin範囲を移動する先のクライアント座標 X を指定する。
yINTin範囲を移動する先のクライアント座標 Y を指定する。
vtbl 27 HRESULT getBookmark(LPWSTR* Boolmark)
BoolmarkLPWSTR*out現在の範囲位置を表す不透明なブックマーク文字列を受け取るポインタである。
vtbl 28 HRESULT moveToBookmark(LPWSTR Bookmark, VARIANT_BOOL* Success)
BookmarkLPWSTRingetBookmark で取得したブックマーク文字列を指定する。
SuccessVARIANT_BOOL*outブックマーク位置への移動が成功したかどうかを受け取る真偽値ポインタである。
vtbl 29 HRESULT queryCommandSupported(LPWSTR cmdID, VARIANT_BOOL* pfRet)
cmdIDLPWSTRin対応状況を問い合わせるコマンドの識別子を指定する文字列である。
pfRetVARIANT_BOOL*outそのコマンドがサポートされているかどうかを受け取る真偽値ポインタである。
vtbl 30 HRESULT queryCommandEnabled(LPWSTR cmdID, VARIANT_BOOL* pfRet)
cmdIDLPWSTRin有効状態を問い合わせるコマンドの識別子を指定する文字列である。
pfRetVARIANT_BOOL*out現在のコンテキストでそのコマンドが実行可能かどうかを受け取る真偽値ポインタである。
vtbl 31 HRESULT queryCommandState(LPWSTR cmdID, VARIANT_BOOL* pfRet)
cmdIDLPWSTRin状態を問い合わせるコマンドの識別子を指定する文字列である。
pfRetVARIANT_BOOL*outコマンドの現在の状態(オン/オフ)を受け取る真偽値ポインタである。
vtbl 32 HRESULT queryCommandIndeterm(LPWSTR cmdID, VARIANT_BOOL* pfRet)
cmdIDLPWSTRin不定状態を問い合わせるコマンドの識別子を指定する文字列である。
pfRetVARIANT_BOOL*outコマンドの状態が不定かどうかを受け取る真偽値ポインタである。
vtbl 33 HRESULT queryCommandText(LPWSTR cmdID, LPWSTR* pcmdText)
cmdIDLPWSTRinテキストを問い合わせるコマンドの識別子を指定する文字列である。
pcmdTextLPWSTR*outコマンドに関連付けられたテキストを受け取る文字列ポインタである。
vtbl 34 HRESULT queryCommandValue(LPWSTR cmdID, VARIANT* pcmdValue)
cmdIDLPWSTRin値を問い合わせるコマンドの識別子を指定する文字列である。
pcmdValueVARIANT*outコマンドの現在値を受け取るバリアントポインタである。
vtbl 35 HRESULT execCommand(LPWSTR cmdID, VARIANT_BOOL showUI, VARIANT value, VARIANT_BOOL* pfRet)
cmdIDLPWSTRin実行するコマンドの識別子を指定する文字列である。
showUIVARIANT_BOOLinコマンドの UI を表示するかどうかを指定する真偽値である。
valueVARIANTinコマンドに渡す引数値を指定するバリアントである。値が不要な場合は空のバリアントを渡す。
pfRetVARIANT_BOOL*outコマンドが正常に実行されたかどうかを受け取る真偽値ポインタである。
vtbl 36 HRESULT execCommandShowHelp(LPWSTR cmdID, VARIANT_BOOL* pfRet)
cmdIDLPWSTRinヘルプを表示するコマンドの識別子を指定する文字列である。
pfRetVARIANT_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 不要)。