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