Поделиться через

Метод 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
Header tom.h
DLL Msftedit.dll

См. также раздел

ITextRange2

ITextRange2::GetURL