Cria um hyperlink na célula de uma planilha Excel.

Open

Compatibilidade

• Bloco servidor: cronapi.excel.Excel.createHyperlink()

Retorno

O bloco não possui retorno.

Parâmetros

Número da linha

Recebe o número da linha na planilha, começando sempre com o valor zero, ao invés de 1, como é no Excel padrão.

• Posição: 1

• Inglês: Number of line

• Tipo: Texto / String

• Exemplo: "0"

Número da coluna

Recebe o número da coluna na planilha. Os valores inseridos neste campo são numéricos, começando sempre com 0, ao invés de "A", como é no Excel padrão. 

• Posição: 2

• Inglês: Number of the column

• Tipo: Texto / String

• Exemplo: "0"

Planilha Excel

Recebe a variável correspondente à planilha Excel. Deve-se utilizar o retorno do bloco Criar Planilha Excel.

• Posição: 3

• Inglês: Sheet

• Tipo: Objeto / Object

• Exemplo: uso do retorno do bloco Criar Planilha Excel

Aba

Objeto que representa a aba do arquivo Excel. Deve-se utilizar o retorno do bloco Criar Aba.

• Posição: 4

• Inglês: Sheet

• Tipo: Objeto / Object

• Exemplo: uso do retorno do bloco Criar Aba

Address

Recebe o endereço de destino do Hyperlink.

• Posição: 5

• Inglês: Address

• Tipo: Texto / String

• Exemplo: "https://www.cronapp.io/"

Texto da Célula do Hyperlink

Recebe o texto que conterá o Hyperlink.

• Posição: 6

• Inglês: Text of Cell for Hyperlink

• Tipo: Texto / String

• Exemplo: "Site do Cronapp"

Tipo do Hyperlink

Define qual o tipo do Hyperlink

• Posição: 7

• Inglês: Hyperlink Type

• Tipo: Objeto / Object

• Exemplo: "URL"

• Opções:

  • Documento: representa um link para outro documento, como um link interno entre partes de um mesmo arquivo ou entre documentos em um sistema. Exemplo: referência a outra planilha no Excel.

  • Email: representa um link de e-mail. Quando clicado, abre o cliente de e-mail para enviar uma mensagem para o endereço especificado.

  • Arquivo: representa um link para um arquivo físico no sistema de arquivos. Pode ser um link para abrir, anexar ou referenciar um arquivo. Exemplo: abrir um PDF salvo localmente.

  • URL:  representa um link da web que usa protocolos como http ou https.

  • Indefinido: indica a ausência de hyperlink. Em outras palavras, o objeto não está associado a nenhum tipo de link.

Exemplo

Na função abaixo, o objeto da planilha é criado na variável “planilha” com o bloco Criar Planilha Excel. Em seguida, a aba (worksheet) “Aba1“ é inserida no objeto da planilha utilizando o bloco Criar Aba.

Configuramos os parâmetros do bloco Criar Hyperlink da seguinte forma: Número da linha e Número da coluna, incluímos o valor "0" (equivalente a célula A1 no Excel); Planilha Excel recebe a variável "planilha", que contém a referência da planilha; o parâmetro Aba recebe a variável "aba", com a referência da aba "Aba1"; em Address, informamos a URL desejada; Texto da Célula do Hyperlink, informamos o texto contido na célula e no último parâmetro, Tipo de Hyperlink, definimos o formato do hyperlink.

Ao final, utilizamos o bloco Salvar Planilha Excel, passando o objeto criado,  o nome do arquivo da planilha e o endereço onde será salvo.

Open

O resultado da execução da figura 2 pode ser conferido abaixo.

Open

Nesta página