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 的一部分，它會變成連結的易記名稱，並將 bstr 作為 URL。
如果已選取非連結文字：
- 如果文字緊接在連結的易記名稱後面，且 bstr 符合 URL，則會將文字附加至易記名稱。
- 否則，文字會變成連結的易記名稱，並使用 bstr 作為 URL。

呼叫 SetURL之後，文字範圍會調整為不同的字元位置。