ITextRange2::SetURL メソッド (tom.h)

この範囲のテキストを、指定した URL のテキストに設定します。

構文

HRESULT SetURL(
  [in] BSTR bstr
);

[in] bstr

種類: BSTR

選択したフレンドリ名の URL として使用するテキスト。

型: HRESULT

メソッドが成功すると、 S_OKが返されます。メソッドが失敗した場合は、次のいずれかの COM エラーコードを返します。 COM エラーコードの詳細については、「COM でのエラー処理」を参照してください。

URL 文字列は検証されません。含まれるテキストは引用符で囲む必要があります。必要に応じて、sentinel 文字0xFDDFの前に置く必要があります。例: "http://www.msn.com"または 0xFDDF"http://www.msn.com"。範囲は非生成である必要があります。

次のアクションが可能です。

リンクのフレンドリ名の一部が選択されている場合、URL 部分は bstr に置き換えられます。
通常の URL の一部が選択されている場合は、リンクのフレンドリ名になり、 URL は bstr になります。
リンクされていないテキストが選択されている場合:
- テキストがリンクのフレンドリ名の直後にあり、 bstr が URL と一致する場合は、テキストがフレンドリ名に追加されます。
- それ以外の場合、テキストはリンクのフレンドリ名になり、 url は bstr になります。

テキスト範囲は、 SetURL を呼び出した後、異なる文字位置に調整されます。