DocumentBase.FollowHyperlink(Object, Object, Object, Object, Object, Object, Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Résout un lien hypertexte ou affiche un document mis en cache si le document a déjà été téléchargé.
public void FollowHyperlink (ref object address, ref object subAddress, ref object newWindow, ref object addHistory, ref object extraInfo, ref object method, ref object headerInfo);
Paramètres
- address
- Object
Adresse du document cible.
- subAddress
- Object
Emplacement dans le document cible. La valeur par défaut est une chaîne vide.
- newWindow
- Object
true pour afficher l'emplacement cible dans une nouvelle fenêtre. La valeur par défaut est false.
- addHistory
- Object
true pour ajouter le lien au dossier historique du jour en cours.
- extraInfo
- Object
Chaîne ou tableau d'octets spécifiant des informations supplémentaires pour HTTP qui permettent de résoudre le lien hypertexte. Par exemple, vous pouvez utiliser ExtraInfo pour spécifier les coordonnées d’une image interactive, le contenu d’un formulaire ou un nom de fichier FAT. La chaîne est soit publiée soit ajoutée, selon la valeur de Method. Utilisez la propriété ExtraInfoRequired pour déterminer si des informations supplémentaires sont requises.
- method
- Object
Spécifie la manière dont les informations supplémentaires pour HTTP sont gérées. MsoExtraInfoMethod.
- headerInfo
- Object
Chaîne qui spécifie des informations d'en-tête pour la requête HTTP. La valeur par défaut est une chaîne vide. En Visual Basic, vous pouvez combiner plusieurs lignes d’en-tête en une seule chaîne à l’aide de la syntaxe suivante : "chaîne1 " & vbCr & "chaîne2". La chaîne spécifiée est automatiquement convertie en caractères ANSI. Notez que l’argument HeaderInfo peut remplacer les champs d’en-tête HTTP par défaut.
Exemples
L’exemple de code suivant utilise la FollowHyperlink méthode pour afficher une page Web dans une nouvelle fenêtre. Pour utiliser cet exemple, exécutez-le à partir de la ThisDocument classe dans un projet au niveau du document.
private void DocumentFollowHyperlink()
{
object address = "http://www.adatum.com/";
object newWindow = true;
object addHistory = false;
this.FollowHyperlink(ref address, ref missing, ref newWindow,
ref addHistory, ref missing, ref missing, ref missing);
}
Private Sub DocumentFollowHyperlink()
Me.FollowHyperlink(Address:="http://www.adatum.com", _
NewWindow:=True, AddHistory:=False)
End Sub
Remarques
Cette méthode affiche le document mis en cache situé dans le Address paramètre, s’il a déjà été téléchargé. Sinon, cette méthode résout le lien hypertexte, télécharge le document cible et affiche le document dans l'application appropriée. Si le lien hypertexte utilise le protocole file, cette méthode ouvre le document au lieu de le télécharger.
Paramètres facultatifs
Pour plus d’informations sur les paramètres facultatifs, consultez paramètres facultatifs dans les solutions Office.