Adiciona um bloco marcador na função. No código gerado é adicionado um comentário com um TODO contendo o conteúdo do bloco e o autor correspondente, essas mesmas informações também são inseridas na aba Problemas da área de informações da IDE. E na barra de status é exibido um ícone de informações com a quantidade de marcadores presentes no projeto.

Esse recurso pode ser utilizado para adicionar um bloco de comentário em uma função, a fim de facilitar a localização das partes que estão pendentes para finalizar.

Figura 1 - Bloco Marcador

Compatibilidade

• Bloco servidor: cronapi.organizers.Operations.marker()

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" entre as aspas, basta clicar sobre o ícone de engrenagem do bloco (destaque 1 da Figura 2). Em seguida, a janela Editor de Texto será aberta permitindo a 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).

Figura 2 - Alterando o conteúdo do bloco

Para modificar a cor do bloco, clique no ícone de paleta de cores (destaque 1 da Figura 2.1) ou no retângulo ao lado. Em seguida, todas as cores disponíveis para o bloco serão exibidas. No exemplo abaixo, selecionamos a tonalidade de cinza mais clara.

Figura 2.1 - Modificando a cor do bloco

Exemplo

No exemplo abaixo temos uma função que ainda não foi completamente finalizada. Para indicar essa condição, inserimos um bloco Marcador dentro do bloco de repetição e alteramos o seu conteúdo para "Finalizar função do loop". Ao salvar o novo conteúdo, o bloco exibirá automaticamente a marcação @author seguida do nome do autor que o adicionou (Figura 3).

Figura 3 - Exemplo de uso do bloco Marcador

Sempre que adicionamos um bloco Marcador em uma função, um comentário com um TODO é inserido no código, contendo o conteúdo do bloco e o autor correspondente (destaque 1 da Figura 3.1). Para visualizá-lo, é necessário ativar o modo avançado, em seguida, no blockly, clique na aba Código (destaque 2) para exibi-lo.

Figura 3.1 - Visualização do código de forma high-code

Além de adicionar um comentário no código gerado, o uso do bloco Marcador também adiciona um ícone de informações na barra de status da IDE com a quantidade de blocos que estão sendo utilizados no projeto (destaque 2 da Figura 3.2).

Além disso, na aba Problemas da área de informações da IDE, é possível visualizar um TODO com as mesmas informações presentes no código gerado (destaque 1), ao clicar sobre essa informação o usuário é direcionado para o blockly que contém o bloco Marcador correspondente.

Figura 3.2 - Visualização do conteúdo na barra de status