Adiciona um marcador na função e no código gerado, criando um TODO com um conteúdo personalizável e o autor que o adicionou. Pode ser utilizado para adicionar um comentário específico em uma função, a fim de facilitar a localização das partes implementadas ou que estão pendentes para finalizar.
![](/download/attachments/234674033/blocoMarcador.png?version=1&modificationDate=1688148170000&api=v2)
Figura 1 - Bloco Marcador
Compatibilidade
- Bloco cliente: cronapi.crystal.CrystalOperations.generateReport()
Retorno
Bloco sem retorno.
Parâmetros
Bloco não possui parâmetros.
Características do bloco
O bloco Marcador, assim como os blocos de Grupo e Comentário, permite alterar o conteúdo e a cor do bloco tornando mais simples visualizar o marcador adicionado.
Para alterar o conteúdo, ou seja, o texto "Marcador" que fica entre as aspas, clique diretamente sobre o ícone de engrenagem do bloco (destaque 1 da Figura 2). Em seguida a janela Editor de Texto será exibida para edição do conteúdo do bloco. Após salvar a função, além do novo conteúdo também será exibido uma marcação @author
com o nome do autor que adicionou o bloco (Figura 3).
![](/download/attachments/234674033/blocoMarcadorConfig1.png?version=1&modificationDate=1688391743000&api=v2)
Figura 2 - Alterando o conteúdo do bloco
Para alterar a cor do bloco, clique sobre o ícone de aquarela (destaque 1 da Figura 2.1) ou no retângulo ao lado. Em seguida será exibida todas as cores disponíveis para o bloco, no exemplo abaixo escolhemos a cor cinza mais clara.
![](/download/attachments/234674033/blocoMarcadorConfig2.png?version=3&modificationDate=1688396839000&api=v2)
Figura 2.1 - Modificando a cor do bloco
Exemplo
O exemplo abaixo mostra uma função que ainda não foi totalmente finalizada, por isso adicionamos um bloco Marcador dentro do bloco de repetição e alteramos o seu conteúdo para "Finalizar função do loop". Assim que salvamos o novo conteúdo, automaticamente é possível visualizar no bloco a marcação @author
seguida do nome do autor que o adicionou (Figura 3).
![](/download/attachments/234674033/blocoMarcadorExemplo.png?version=2&modificationDate=1688402827000&api=v2)
Figura 3 - Exemplo de uso do bloco Marcador
Sempre que adicionamos um bloco Marcador em uma função, é adicionado no código um TODO com o conteúdo inserido no bloco e o autor (destaque 1 da Figura 3.1). Para visualizá-lo o modo avançado precisa estar ativado, em seguida no blockly
clique na aba Código (destaque 2) e o código será exibido.
![](/download/attachments/234674033/blocoMarcadorCodigo.png?version=3&modificationDate=1688404468000&api=v2)
Figura 3.1 - Visualização do código de forma high-code