共用方式為


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 的一部分,它會變成連結的易記名稱,並將 bstr 作為 URL。
  • 如果已選取非連結文字:
    • 如果文字緊接在連結的易記名稱後面,且 bstr 符合 URL,則會將文字附加至易記名稱。
    • 否則,文字會變成連結的易記名稱,並使用 bstr 作為 URL。
呼叫 SetURL之後,文字範圍會調整為不同的字元位置。

需求

   
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 tom.h
Dll Msftedit.dll

另請參閱

ITextRange2

ITextRange2::GetURL