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 后，文本范围调整为不同的字符位置。