Metodo ITextRange2::SetURL (tom.h)

  • Articolo

Imposta il testo in questo intervallo su quello dell'URL specificato.

Sintassi

HRESULT SetURL(
  [in] BSTR bstr
);

Parametri

[in] bstr

Tipo: BSTR

Testo da usare come URL per il nome descrittivo selezionato.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, restituisce S_OK. Se il metodo ha esito negativo, restituisce uno dei codici di errore COM seguenti. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.

Codice restituito Descrizione
E_INVALIDARG
 Argomento non valido.
E_ACCESSDENIED
 L'accesso in scrittura viene negato.
E_OUTOFMEMORY
 Memoria insufficiente.

Commenti

La stringa URL non viene convalidata. Il testo che contiene deve essere racchiuso tra virgolette, preceduto facoltativamente dal carattere sentinel 0xFDDF. Ad esempio: "http://www.msn.com" o 0xFDDF"http://www.msn.com". L'intervallo deve essere non generato.

Sono possibili le azioni seguenti:

  • Se è selezionata una parte del nome descrittivo di un collegamento, la parte URL viene sostituita con bstr.
  • Se viene selezionata una parte di un URL normale, diventa il nome descrittivo del collegamento, con bstr come URL.
  • Se è selezionato testo non collegato:
    • Se il testo segue immediatamente il nome descrittivo di un collegamento e bstr corrisponde all'URL, il testo viene aggiunto al nome descrittivo.
    • In caso contrario, il testo diventa il nome descrittivo di un collegamento, con bstr come URL.
L'intervallo di testo deve essere regolato in posizioni di caratteri diverse dopo aver chiamato SetURL.

Requisiti

   
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione tom.h
DLL Msftedit.dll

Vedi anche

ITextRange2

ITextRange2::GetURL