次の方法で共有


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

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

構文

HRESULT SetURL(
  [in] BSTR bstr
);

パラメーター

[in] bstr

種類: BSTR

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

戻り値

型: HRESULT

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

リターン コード 説明
E_INVALIDARG
引数が無効です。
E_ACCESSDENIED
書き込みアクセスが拒否されました。
E_OUTOFMEMORY
メモリ不足です。

解説

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

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

  • リンクのフレンドリ名の一部が選択されている場合、URL 部分は bstr に置き換えられます。
  • 通常の URL の一部が選択されている場合は、リンクのフレンドリ名になり、 URL は bstr になります。
  • リンクされていないテキストが選択されている場合:
    • テキストがリンクのフレンドリ名の直後にあり、 bstr が URL と一致する場合は、テキストがフレンドリ名に追加されます。
    • それ以外の場合、テキストはリンクのフレンドリ名になり、 url は bstr になります。
テキスト範囲は、 SetURL を呼び出した後、異なる文字位置に調整されます。

要件

   
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー tom.h
[DLL] Msftedit.dll

関連項目

ITextRange2

ITextRange2::GetURL