Application.HyperlinkPart-Methode (Access)

Artikel
09/03/2024

Die HyperlinkPart-Methode gibt Informationen zu Daten zurück, die als Hyperlink-Datentyp gespeichert sind.

Syntax

Ausdruck. HyperlinkPart (Hyperlink, Part)

expression Eine Variable, die ein Application-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
Hyperlink	Erforderlich	Variant	Die in einem Hyperlinkfeld gespeicherten Daten.
Komponente	Optional	AcHyperlinkPart	Eine AcHyperlinkPart-Konstante , die die Informationen darstellt, die von der HyperlinkPart-Methode zurückgegeben werden sollen.

Rückgabewert

String

Hinweise

Sie verwenden die HyperlinkPart-Methode , um einen von drei Werten aus einem Hyperlink-Feld oder dem angezeigten Wert zurückzugeben. 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). Die zurückgegebenen Werte können einer der vier Teile des Hyperlinkfelds (Anzeigetext, Adresse, Unteradresse oder QuickInfo), die vollständige Adresse, dieUnteradresse der Adresse# oder der Wert sein, den Microsoft Access für den Link anzeigt.

Hinweis

Wenn Sie die HyperlinkPart-Methode in einer Abfrage verwenden, ist das Part-Argument erforderlich, und Sie können die oben aufgeführten Konstanten nicht verwenden, sondern müssen stattdessen den tatsächlichen Wert verwenden.

Wenn im displaytext-Teil eines Hyperlinkfelds ein Wert angegeben wird, entspricht der von Microsoft Access angezeigte Wert der Displaytexteinstellung . Wenn der displaytext-Teil eines Hyperlink-Felds keinen Wert enthält, ist der angezeigte Wert der Adress- oder Unteradressenteil des Hyperlink-Felds, je nachdem, welcher Wert zuerst im Feld vorhanden ist.

Die folgende Tabelle zeigt die Werte, die von der HyperlinkPart-Methode für daten zurückgegeben werden, die in einem Hyperlinkfeld gespeichert sind.

Daten im Hyperlink-Feld	Von der HyperlinkPart-Methode zurückgegebene Werte
#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`
Kunden#https://www.microsoft.com#Form Kunden	acDisplayedValue: `Customers` acDisplayText: `Customers` acAddress: `https://www.microsoft.com` acSubAddress: `Form Customers` acScreenTip: acFullAddress: `https://www.microsoft.com#Form Customer`
##Formular Kunden#Informationen eingeben	acDisplayedValue: `Form Customers` acDisplayText: acAddress: acSubAddress: `Form Customers` acScreenTip: `Enter Information` acFullAddress: `#FormCustomer`

Wenn Sie einem Hyperlinkfeld ein Adressteil hinzufügen, indem Sie das Dialogfeld Link einfügen (verfügbar durch Auswählen von Hyperlink im Menü Einfügen) oder indem Sie einen Adressteil direkt in ein Hyperlinkfeld eingeben, fügt Access die beiden #-Symbole hinzu, die Teile der Hyperlinkdaten trennen.

Sie können den Displaytext-Teil eines Hyperlinkfelds hinzufügen oder bearbeiten, indem Sie mit der rechten Maustaste auf einen Link in einer Tabelle, einem Formular oder einem Bericht klicken, im Kontextmenü auf Hyperlink zeigen und dann den Anzeigetext im Feld Anzuzeigender Text eingeben.

Wenn Sie einem Hyperlinkfeld Daten direkt hinzufügen, müssen Sie die beiden #-Symbole einschließen, um die Teile der Hyperlinkdaten zu begrenzen.

Beispiel

Im folgenden Beispiel werden alle vier Partargumentkonstanten verwendet, um informationen anzuzeigen, die von der HyperlinkPart-Methode für jeden Datensatz in einer Tabelle zurückgegeben werden, die ein Hyperlinkfeld enthält. Testen Sie dieses Beispiel, indem Sie die DisplayHyperlinkParts-Prozedur in den Deklarationsbereich eines Moduls einfügen. Sie können die DisplayHyperlinkParts-Prozedur vom Testfenster aus aufrufen und ihr den Namen einer Tabelle übergeben, die Hyperlinks enthält, sowie den Namen des Felds, das die Hyperlinkdaten enthält. Zum Beispiel:

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

Wenn Sie die HyperlinkPart-Methode in einer Abfrage verwenden, ist das part-Argument notwendig. Die folgende SQL-Anweisung verwendet beispielsweise die HyperlinkPart-Methode , um Informationen zu Daten zurückzugeben, die als Hyperlink-Datentyp im Url-Feld der Tabelle Links gespeichert sind:

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

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.

Freigeben über