Visio.Hyperlink class
Representa el hipervínculo.
- Extends
Comentarios
Propiedades
address | Obtiene la dirección del objeto de hipervínculo. |
context | Contexto de solicitud asociado al objeto . Esto conecta el proceso del complemento al proceso de la aplicación host de Office. |
description | Obtiene la descripción de un hipervínculo. |
extra |
Obtiene la información de solicitud de dirección URL adicional que se usa para resolver la dirección URL del hipervínculo. |
sub |
Obtiene la subdirección del objeto de hipervínculo. |
Métodos
load(options) | Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a |
load(property |
Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a |
load(property |
Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a |
toJSON() | Invalida el método JavaScript |
Detalles de las propiedades
address
Obtiene la dirección del objeto de hipervínculo.
readonly address: string;
Valor de propiedad
string
Comentarios
context
Contexto de solicitud asociado al objeto . Esto conecta el proceso del complemento al proceso de la aplicación host de Office.
context: RequestContext;
Valor de propiedad
description
Obtiene la descripción de un hipervínculo.
readonly description: string;
Valor de propiedad
string
Comentarios
extraInfo
Obtiene la información de solicitud de dirección URL adicional que se usa para resolver la dirección URL del hipervínculo.
readonly extraInfo: string;
Valor de propiedad
string
Comentarios
subAddress
Obtiene la subdirección del objeto de hipervínculo.
readonly subAddress: string;
Valor de propiedad
string
Comentarios
Detalles del método
load(options)
Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync()
antes de leer las propiedades.
load(options?: Visio.Interfaces.HyperlinkLoadOptions): Visio.Hyperlink;
Parámetros
Proporciona opciones para las propiedades del objeto que se van a cargar.
Devoluciones
Ejemplos
Visio.run(session, function (ctx) {
const activePage = ctx.document.getActivePage();
const shape = activePage.shapes.getItem(0);
const hyperlink = shape.hyperlinks.getItem(0);
hyperlink.load();
return ctx.sync().then(function() {
console.log(hyperlink.description);
console.log(hyperlink.address);
console.log(hyperlink.subAddress);
console.log(hyperlink.extraInfo);
});
}).catch(function(error) {
console.log("Error: " + error);
if (error instanceof OfficeExtension.Error) {
console.log("Debug info: " + JSON.stringify(error.debugInfo));
}
});
load(propertyNames)
Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync()
antes de leer las propiedades.
load(propertyNames?: string | string[]): Visio.Hyperlink;
Parámetros
- propertyNames
-
string | string[]
Una cadena delimitada por comas o una matriz de cadenas que especifican las propiedades que se van a cargar.
Devoluciones
load(propertyNamesAndPaths)
Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync()
antes de leer las propiedades.
load(propertyNamesAndPaths?: {
select?: string;
expand?: string;
}): Visio.Hyperlink;
Parámetros
- propertyNamesAndPaths
-
{ select?: string; expand?: string; }
propertyNamesAndPaths.select
es una cadena delimitada por comas que especifica las propiedades que se van a cargar y propertyNamesAndPaths.expand
es una cadena delimitada por comas que especifica las propiedades de navegación que se van a cargar.
Devoluciones
toJSON()
Invalida el método JavaScript toJSON()
para proporcionar una salida más útil cuando se pasa un objeto de API a JSON.stringify()
. (JSON.stringify
a su vez, llama al toJSON
método del objeto que se le pasa). Mientras que el objeto Visio.Hyperlink original es un objeto de API, el toJSON
método devuelve un objeto JavaScript sin formato (escrito como Visio.Interfaces.HyperlinkData
) que contiene copias superficiales de las propiedades secundarias cargadas del objeto original.
toJSON(): Visio.Interfaces.HyperlinkData;