> For the complete documentation index, see [llms.txt](https://docs.geodin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geodin.com/geodin-desktop/pt/visualizacao-layouts-e-relatorios/creating-custom-layouts/text-macros-and-variable-text.md).

# Macros de Texto e Texto variável

O **Texto Elemento** posiciona Texto estático ou Fixado em qualquer lugar sobre (em) um layout. O **Texto variável elemento** coloca texto dinâmico que resolve valores do banco de dados em tempo de renderização - usado para cabeçalhos, rodapés, títulos e qualquer campo rotulado que muda por objeto. Ambos os elementos são colocados dentro ou ao lado de uma moldura de objeto no editor de layout.

Para a referência da sintaxe de macros (delimitadores, concatenação, separadores condicionais, diálogo Construir, modos de Codificação/Texto padrão/Utilizador, tradução), consulte [Macros de Texto incluido Relatório](/geodin-desktop/pt/visualizacao-layouts-e-relatorios/report-templates/text-macros-in-reports.md).

## Adicionando um Elemento de Texto variável

Adicionar um **Texto variável elemento** ao/à O layout (para etapas gerais sobre (em) adicionar elementos, ver [Noções básicas do Editor de layout](/geodin-desktop/pt/visualizacao-layouts-e-relatorios/creating-custom-layouts/layout-editor-basics.md) E [Criando Layouts Personalizado](/geodin-desktop/pt/visualizacao-layouts-e-relatorios/creating-custom-layouts.md)).

Assim que o Elemento for colocado, Configurar:

1. Clique no **Construir** Botão nas Propriedades dos elementos para Abrir o editor de macros.
2. Selecionar macros das Categorias Disponível - **Parâmetro Geral**, **Amostras**, **Dados de camadas**E outros. Usa o **Procurar a Barra** ao encontrar uma macro específica pelo nome.
3. Defina as Propriedades de visualização: **mostrar Profundidade**, **mostrar Dados de camadas**, **Orientação**.

Macros comuns usadas nos elementos de Texto variável: Denominação longa (nome completo da localização), Nome do projeto, sondador, Furo, Código EPSG, coordenada X, coordenada Y.

## Configurações gerais opcionais

* **Codificação / Texto padrão / modo de Utilizador** - controla qual fonte do Descritor alimenta a macro. Para Tipo de objetos G1, estes são na sua maioria equivalentes; o **Utilizador** opção permite Texto simples arbitrário misturado com macros.
* **Campos de Texto estático** - o texto simples **Texto Elemento** coloca o texto do Rótulo Fixado em qualquer lugar em um Selecionar layout; ele não resolve Valores do Banco de dados.

***

## Trabalhando com macros de texto

Os campos de texto dinâmicos resolvem os Parâmetro GeoDin Para o Tempo de renderização. Uma macro colocada dentro de uma Moldura de objeto referencia o objeto atualmente vinculado ao/à essa Moldura - por exemplo, `$Localização_Nome$` obtém dinamicamente o Nome do furo atual.

Macros podem referenciar Parâmetro de qualquer Tabela Arbitrário - Dados gerais, Tabela Exemplo, Tabelas de medição, Perfilagem no furo, sondagens (sequência de dados). Vários Parâmetro podem ser concatenados numa única string, por exemplo ao Construir uma legenda dinâmica como "Exemplo `$Exemplo_reference$` penetração de `$Profundidade_from$` ao/à `$Profundidade_ao/à$` metros".

Colchetes `[ ]` dentro de uma macro, atuam como separadores condicionais: o conteúdo entre colchetes só é renderizado se a macro interna tiver um valor, evitando vírgulas soltas quando os campos estão vazios.

O **Construir** O botão abre o editor de macros, que também suporta Parâmetros calculados - por exemplo, espessura da camada derivada do topo e das profundidades da base.

**Suporte à tradução:** um único layout pode conter várias traduções. Ao alternar a língua do ficheiro sob **Ficheiro > Língua** imprime o mesmo modelo incluido em diferentes Línguas sem modificação.

***

## Referência: Texto elemento

O **Texto Elemento** exibe Conteúdo estático - o mesmo Texto sobre (em) cada saída. Ele pode ser colocado em qualquer lugar em um Selecionar layout, incluindo fora de molduras de objeto. Para Propriedades dos elementos compartilhadas (Nome do elemento, Plano de desenho., z-order, Típo de letra, Linha, e Propriedades de Preenchimento), consulte [Propriedades dos elementos](/geodin-desktop/pt/visualizacao-layouts-e-relatorios/creating-custom-layouts/element-properties.md).

## Referência: Texto variável Elemento

O **Texto variável elemento** exibe conteúdo dinâmico resolvido do Banco de dados GeoDin no tempo de renderização. Normalmente é usado para cabeçalhos, rodapés e campos rotulados que mudam por objeto.

| Propriedade                                 | Denominação                                                                                                                                                   |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Botão Construir**                         | Abre o editor de macros. Categorias Disponível: Parâmetro Geral, Amostras, Dados de camadas e mais. Usa a Barra de Procurar a ao/à encontrar macros por Nome. |
| **mostrar Profundidade**                    | Inclui o Valor de Profundidade da Linha referenciada incluido no Texto renderizado.                                                                           |
| **mostrar Dados de camadas**                | Inclui Atributos da camada juntamente com o Valor da macro.                                                                                                   |
| **Orientação**                              | Define a orientação do Texto sobre (em) o layout.                                                                                                             |
| **Codificação / Texto padrão / Utilizador** | Controla a Fonte do Descritor. **Utilizador** permite texto simples personalizado combinado com macros.                                                       |

Sintaxe de macro - delimitadores (`$...$`), concatenação, Traço da separação condicional (`[...]`), e a Lista cheia de Disponível Parâmetro - está documentado incluido [Macros de Texto incluido Relatório](/geodin-desktop/pt/visualizacao-layouts-e-relatorios/report-templates/text-macros-in-reports.md).

## Referência: Cores de preenchimento e Transparência

### Cor / Transparência

Controla as Cores de preenchimento e Transparência para Preenchimento Usado no(a) elementos de layout.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.geodin.com/geodin-desktop/pt/visualizacao-layouts-e-relatorios/creating-custom-layouts/text-macros-and-variable-text.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.