Application.HyperlinkPart-Methode (Access)

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

Syntax

Ausdruck verwendet werden. HyperlinkPart (Hyperlink, Teil)

expression Eine Variable, die ein Application-Objekt darstellt.

Parameter

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

Rückgabewert

Zeichenfolge

Hinweise

Sie verwenden die HyperlinkPart-Methode , um einen von drei Werten aus einem Hyperlink-Feld oder den 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 Hyperlink-Felds (displaytext, address, subaddress oder QuickInfo), die vollständige Adresse, dieAdressunteradresse# oder der Wert sein, den Microsoft Access für den Hyperlink anzeigt.

Hinweis

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

Wenn ein Wert im displaytext-Teil eines Hyperlink-Felds angegeben wird, entspricht der von Microsoft Access angezeigte Wert der displaytext-Einstellung . Wenn im displaytext-Teil eines Hyperlink-Felds kein Wert vorhanden ist, wird der Wert angezeigt, je nachdem, welcher Wert zuerst im Feld vorhanden ist, der Adress- oder Unteradressenteil des Hyperlink-Felds .

Die folgende Tabelle zeigt die Werte, die von der HyperlinkPart-Methode für Daten zurückgegeben werden, die in einem Hyperlink-Feld 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 über das Dialogfeld "Link einfügen" (verfügbar durch Auswahl von "Link" im Menü "Einfügen") oder durch direkte Eingabe eines Adressteils in ein Hyperlinkfeld hinzufügen, 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 "Link " zeigen und dann den Anzeigetext in das Feld "Anzuzeigender Text" eingeben.

Wenn Sie Daten direkt zu einem Hyperlinkfeld hinzufügen, müssen Sie die beiden #-Symbole einbeziehen, um die Teile der Hyperlinkdaten zu trennen.

Beispiel

Im folgenden Beispiel werden alle vier Argumentkonstanten des Teils verwendet, um von der HyperlinkPart-Methode zurückgegebene Informationen für jeden Datensatz in einer Tabelle anzuzeigen, die ein Hyperlink-Feld 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 z. B. die HyperlinkPart-Methode , um Informationen zu Daten zurückzugeben , die als Hyperlink-Datentyp im URL-Feld der Link-Tabelle 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.