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

  • Artigo

Define o texto nesse intervalo como o da URL especificada.

Sintaxe

HRESULT SetURL(
  [in] BSTR bstr
);

Parâmetros

[in] bstr

Tipo: BSTR

O texto a ser usado como UMA URL para o nome amigável selecionado.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Se o método falhar, ele retornará um dos seguintes códigos de erro COM. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno Descrição
E_INVALIDARG
 Argumento inválido.
E_ACCESSDENIED
 Acesso de gravação negado.
E_OUTOFMEMORY
 Memória insuficiente.

Comentários

A cadeia de caracteres de URL não é validada. O texto que ele contém deve ser colocado entre aspas, opcionalmente precedido pelo caractere sentinela 0xFDDF. Por exemplo: "http://www.msn.com" ou 0xFDDF"http://www.msn.com". O intervalo deve ser não descrigênto.

As seguintes ações são possíveis:

  • Se parte do nome amigável de um link estiver selecionada, a parte da URL será substituída por bstr.
  • Se parte de uma URL regular for selecionada, ela se tornará o nome amigável do link, com bstr como a URL.
  • Se o texto não vinculado estiver selecionado:
    • Se o texto seguir imediatamente o nome amigável de um link e bstr corresponder à URL, o texto será acrescentado ao nome amigável.
    • Caso contrário, o texto se tornará o nome amigável de um link, com bstr como a URL.
O intervalo de texto será ajustado para posições de caracteres diferentes depois de chamar SetURL.

Requisitos

   
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho tom.h
DLL Msftedit.dll

Confira também

ITextRange2

ITextRange2::GetURL