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

  • Article

Définit le texte de cette plage sur celui de l’URL spécifiée.

Syntaxe

HRESULT SetURL(
  [in] BSTR bstr
);

Paramètres

[in] bstr

Type : BSTR

Texte à utiliser comme URL pour le nom convivial sélectionné.

Valeur retournée

Type : HRESULT

Si la méthode réussit, elle retourne S_OK. Si la méthode échoue, elle retourne l’un des codes d’erreur COM suivants. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.

Code de retour Description
E_INVALIDARG
 Argument non valide.
E_ACCESSDENIED
 L’accès en écriture est refusé.
E_OUTOFMEMORY
 Mémoire insuffisante.

Remarques

La chaîne d’URL n’est pas validée. Le texte qu’il contient doit être placé entre guillemets, éventuellement précédé du caractère sentinelle 0xFDDF. Par exemple : «http://www.msn.com" ; ou 0xFDDF »http://www.msn.com". La plage doit être non dégénérée.

Les actions suivantes sont possibles :

  • Si une partie du nom convivial d’un lien est sélectionnée, la partie URL est remplacée par bstr.
  • Si une partie d’une URL régulière est sélectionnée, elle devient le nom convivial du lien, avec bstr comme URL.
  • Si le texte non lié est sélectionné :
    • Si le texte suit immédiatement le nom convivial d’un lien et que bstr correspond à l’URL, le texte est ajouté au nom convivial.
    • Sinon, le texte devient le nom convivial d’un lien, avec bstr comme URL.
La plage de texte doit être ajustée à différentes positions de caractères après l’appel de SetURL.

Configuration requise

   
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête tom.h
DLL Msftedit.dll

Voir aussi

ITextRange2

ITextRange2::GetURL