Método Application.HyperlinkPart (Access)
El método HyperlinkPart devuelve información acerca de los datos almacenados como un tipo de datos hipervínculo.
Sintaxis
expresión. HyperlinkPart (Hyperlink, Part)
expresión Variable que representa un objeto Application.
Parámetros
Nombre | Obligatorio/opcional | Tipo de datos | Descripción |
---|---|---|---|
Hyperlink | Obligatorio | Variant | Datos almacenados en un campo Hipervínculo . |
Elemento | Opcional | AcHyperlinkPart | Constante AcHyperlinkPart que representa la información que desea que devuelva el método HyperlinkPart . |
Valor devuelto
Cadena
Comentarios
Use el método HyperlinkPart para devolver uno de los tres valores de un campo Hyperlink o el valor mostrado. 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). Los valores devueltos pueden ser una de las cuatro partes del campo Hipervínculo (displaytext, address, subaddress o screentip), la dirección completa, lasubdirección de dirección# o el valor que Microsoft Access muestra para el hipervínculo.
Nota:
Si usa el método HyperlinkPart en una consulta, el argumento part es obligatorio y no puede usar las constantes enumeradas anteriormente, sino que debe usar el valor real en su lugar.
Cuando se proporciona un valor en la parte displaytext de un campo Hyperlink , el valor mostrado por Microsoft Access será el mismo que el valor de displaytext . Cuando no hay ningún valor en la parte displaytext de un campo Hyperlink , el valor mostrado será la parte de dirección o subdirección del campo Hipervínculo , dependiendo del valor que esté presente por primera vez en el campo.
En la tabla siguiente se muestran los valores devueltos por el método HyperlinkPart para los datos almacenados en un campo Hyperlink .
Datos del campo Hipervínculo | Valores devueltos por el método 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 |
Clientes#https://www.microsoft.com#Form Clientes | acDisplayedValue: Customers acDisplayText: Customers acAddress: https://www.microsoft.com acSubAddress: Form Customers acScreenTip: acFullAddress: https://www.microsoft.com#Form Customer |
##Formulario Cliente#Escribir información | acDisplayedValue: Form Customers acDisplayText: acAddress: acSubAddress: Form Customers acScreenTip: Enter Information acFullAddress: #FormCustomer |
Al agregar una parte de dirección a un campo Hipervínculo mediante el cuadro de diálogo Insertar hipervínculo (disponible seleccionando Hipervínculo en el menú Insertar ) o escribiendo una parte de dirección directamente en un campo Hipervínculo , Access agrega los dos símbolos # que delimitan partes de los datos de hipervínculo.
Para agregar o editar la parte displaytext de un campo de hipervínculo, haga clic con el botón derecho en un hipervínculo de una tabla, formulario o informe, apunte a Hipervínculo en el menú contextual y escriba el texto para mostrar en el cuadro Texto que se va a mostrar .
Al agregar datos a un campo Hipervínculo directamente, debe incluir los dos símbolos # para delimitar las partes de los datos de hipervínculo.
Ejemplo:
En el ejemplo siguiente se usan las cuatro constantes del argumento part para mostrar la información devuelta por el método HyperlinkPart para cada registro de una tabla que contiene un campo Hyperlink . Para probar este ejemplo, pegue el procedimiento MostrarPartesDeHipervínculo en la sección Declaraciones de un módulo. Puede llamar al procedimiento MostrarPartesDeHipervínculo desde la ventana de depuración, pasando al mismo el nombre de una tabla que contenga hipervínculos y el nombre del campo que contiene datos de hipervínculo. Por ejemplo:
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
Cuando utiliza el método HyperlinkPart en una consulta, el argumento de part es obligatorio. Por ejemplo, la siguiente instrucción SQL usa el método HyperlinkPart para devolver información sobre los datos almacenados como un tipo de datos Hyperlink en el campo URL de la tabla 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
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.