Método ITextRange2::SetURL (tom.h)

  • Artículo

Establece el texto de este intervalo en el de la dirección URL especificada.

Sintaxis

HRESULT SetURL(
  [in] BSTR bstr
);

Parámetros

[in] bstr

Tipo: BSTR

Texto que se va a usar como dirección URL para el nombre descriptivo seleccionado.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error en el método, devuelve uno de los siguientes códigos de error COM. Para obtener más información sobre los códigos de error COM, vea Control de errores en COM.

Código devuelto Descripción
E_INVALIDARG
 Argumento no válido.
E_ACCESSDENIED
 Se deniega el acceso de escritura.
E_OUTOFMEMORY
 Memoria insuficiente.

Comentarios

La cadena de dirección URL no se valida. El texto que contiene debe ir entre comillas, precedido opcionalmente por el carácter centinela 0xFDDF. Por ejemplo: "http://www.msn.com" o 0xFDDF"http://www.msn.com". El intervalo debe ser no degenerado.

Se pueden realizar las siguientes acciones:

  • Si se selecciona parte del nombre descriptivo de un vínculo, la parte de dirección URL se reemplaza por bstr.
  • Si se selecciona parte de una dirección URL normal, se convierte en el nombre descriptivo del vínculo, con bstr como dirección URL.
  • Si se selecciona texto no vinculado:
    • Si el texto sigue inmediatamente el nombre descriptivo de un vínculo y bstr coincide con la dirección URL, el texto se anexa al nombre descriptivo.
    • De lo contrario, el texto se convierte en el nombre descriptivo de un vínculo, con bstr como la dirección URL.
El intervalo de texto se ajusta a diferentes posiciones de caracteres después de llamar a SetURL.

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado tom.h
Archivo DLL Msftedit.dll

Consulte también

ITextRange2

ITextRange2::GetURL