Méthode Application.HyperlinkPart (Access)

Article
04/07/2023

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

Chaîne

Remarques

Vous utilisez la méthode HyperlinkPart pour renvoyer l’une des trois valeurs d’un champ Hyperlink 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 retournées peuvent être l’une des quatre parties du champ Lien hypertexte (texte d’affichage, adresse, sous-adresse ou info-bulle), l’adresse complète, lasous-adresse# ou la valeur que Microsoft Access affiche 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 vous devez utiliser la valeur réelle à la place.

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

Le tableau suivant présente les valeurs retournées par la méthode HyperlinkPart pour les données stockées dans un champ Hyperlink .

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 (disponible en choisissant Lien hypertexte dans le menu Insertion ) ou en tapant une partie d’adresse directement dans un champ Lien hypertexte , Access ajoute les deux symboles # qui délimitent les parties des données de lien hypertexte.

Vous pouvez ajouter ou modifier la partie displaytext d’un champ de lien hypertexte en cliquant avec le bouton droit sur un lien hypertexte dans un tableau, 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 à un champ Lien hypertexte , vous devez inclure les deux symboles # pour délimiter les parties des données de lien hypertexte.

Exemple

L’exemple suivant utilise les quatre constantes d’argument de composant pour afficher les informations retournées par la méthode HyperlinkPart pour chaque enregistrement d’une table contenant un champ Hyperlink . 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 retourner des informations sur les données stockées en tant que type de données Hyperlink dans le champ URL de la table Links :

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.

Share via