Application.HyperlinkPart, méthode (Access)

La méthode HyperlinkPart renvoie des informations sur les données stockées sous la forme d'un type de données lien hypertexte.

Syntaxe

expression. HyperlinkPart (Hyperlink, Part)

expressionUne variable qui représente un objetApplication.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
Hyperlink	Obligatoire	Variant	Données stockées dans un champ Lien hypertexte .
Argument	Facultatif	AcHyperlinkPart	Constante AcHyperlinkPart représentant les informations que vous souhaitez retourner par la méthode HyperlinkPart .

Valeur renvoyée

String

Remarques

La méthode HyperlinkPart permet de renvoyer l’une des trois valeurs d’un champ Lien hypertexte ou de la valeur affichée. The value returned depends on the setting of the part argument.

The part argument is optional. If it's not used, the function returns the value Microsoft Access displays for the hyperlink (which corresponds to the acDisplayedValue setting for the part argument). Les valeurs renvoyées peuvent être l’une des quatre parties du champ Lien hypertexte (texte affiché, adresse, sous-adresse ou info-bulle), l’adresse complète, lasous-adressed’adresse# ou la valeur affichée par Microsoft Access pour le lien hypertexte.

Remarque

Si vous utilisez la méthode HyperlinkPart dans une requête, l’argument part est obligatoire et vous ne pouvez pas utiliser les constantes répertoriées ci-dessus, mais devez utiliser la valeur réelle à la place.

Lorsqu’une valeur est fournie dans la partie texte affichée d’un champ Lien hypertexte , la valeur affichée par Microsoft Access est identique au paramètre texte affiché . Lorsqu’il n’y a aucune valeur dans la partie texte affichée d’un champ Lien hypertexte , la valeur affichée correspond à la partie adresse ou sous-adresse du champ Lien hypertexte , selon la valeur qui est présente en premier dans le champ.

Le tableau suivant indique les valeurs renvoyées par la méthode HyperlinkPart pour les données stockées dans un champ Lien hypertexte .

Données de champ Lien hypertexte	Valeurs renvoyées par la méthode HyperlinkPart
#https://www.microsoft.com#	acDisplayedValue : https://www.microsoft.com acDisplayText : acAddress : https://www.microsoft.com acSubAddress : acScreenTip : acFullAddress : https://www.microsoft.com
Microsoft#https://www.microsoft.com#	acDisplayedValue : Microsoft acDisplayText : Microsoft acAddress : https://www.microsoft.com acSubAddress : acScreenTip : acFullAddress : https://www.microsoft.com
Customers#https://www.microsoft.com#Form Customers	acDisplayedValue : Customers acDisplayText : Customers acAddress : https://www.microsoft.com acSubAddress : Form Customers acScreenTip : acFullAddress : https://www.microsoft.com#Form Customer
##Form Customers#Enter Information	acDisplayedValue : Form Customers acDisplayText : acAddress : acSubAddress : Form Customers acScreenTip : Enter Information acFullAddress : #FormCustomer

Lorsque vous ajoutez une partie d’adresse à un champ Lien hypertexte à l’aide de la boîte de dialogue Insérer un lien hypertexte (accessible en choisissant Lien hypertexte dans le menu Insertion ) ou en tapant une partie Adresse directement dans un champ Lien hypertexte , Access ajoute les deux symboles # qui délimitent des parties des données de lien hypertexte.

Vous pouvez ajouter ou modifier la partie de texte affichée d’un champ de lien hypertexte en cliquant avec le bouton droit sur un lien hypertexte dans une table, un formulaire ou un état, en pointant sur Lien hypertexte dans le menu contextuel, puis en tapant le texte affiché dans la zone Texte à afficher .

Lorsque vous ajoutez directement des données dans un champ Lien hypertexte , vous devez inclure les deux symboles # pour délimiter les parties des données du lien hypertexte.

Exemple

L’exemple suivant utilise les quatre constantes d’argument de partie pour afficher les informations renvoyées par la méthode HyperlinkPart pour chaque enregistrement d’une table contenant un champ Lien hypertexte . Pour essayer cet exemple, collez la procédure DisplayHyperlinkParts dans la section Déclarations d'un module. Vous pouvez appeler la procédure DisplayHyperlinkParts à partir de la fenêtre Débogage, en lui transmettant le nom d'une table contenant des liens hypertexte et le nom du champ contenant les données de lien hypertexte. Par exemple :

DisplayHyperlinkParts "MyHyperlinkTableName", "MyHyperlinkFieldName" 
 
Public Sub DisplayHyperlinkParts(ByVal strTable As String, _ 
 ByVal strField As String) 
 
 Dim rst As New ADODB.Recordset 
 Dim strMsg As String 
 
 
 rst.Open strTable, CurrentProject.Connection, _ 
 adOpenForwardOnly, adLockReadOnly 
 
 ' For each record in table. 
 Do Until rst.EOF 
 strMsg = "DisplayValue = " _ 
 & HyperlinkPart(rst(strField), acDisplayedValue) _ 
 & vbCrLf & "DisplayText = " _ 
 & HyperlinkPart(rst(strField), acDisplayText) _ 
 & vbCrLf & "Address = " _ 
 & HyperlinkPart(rst(strField), acAddress) _ 
 & vbCrLf & "SubAddress = " _ 
 & HyperlinkPart(rst(strField), acSubAddress) _ 
 & vbCrLf & "ScreenTip = " _ 
 & HyperlinkPart(rst(strField), acScreenTip) _ 
 & vbCrLf & "Full Address = " _ 
 & HyperlinkPart(rst(strField), acFullAddress) 
 
 ' Show parts returned by HyperlinkPart function. 
 MsgBox strMsg 
 rst.MoveNext 
 Loop 
 
End Sub

Lorsque vous utilisez la méthode HyperlinkPart dans une requête, l'argument part est requis. Par exemple, l’instruction SQL suivante utilise la méthode HyperlinkPart pour renvoyer des informations sur les données stockées en tant que type de données Lien hypertexte dans le champ URL de la table Liens :

SELECT Links.URL, HyperlinkPart([URL],0) 
 AS Display, HyperlinkPart([URL],1) 
 AS Name, HyperlinkPart([URL],2) 
 AS Addr, HyperlinkPart([URL],3) 
 AS SubAddr, HyperlinkPart([URL],4) 
 AS ScreenTip 
 FROM Links

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.