METHOD SET COMMENTS

4D v20.1

METHOD SET COMMENTS


METHOD SET COMMENTS ( rota ; Comentarios {; *} )

Parâmetro	Tipo	Descrição
rota	Texto, Array texto	Texto ou array texto contendo uma ou mais rotas de método
Comentarios	Texto, Array texto	Comentários dos métodos designados
*	Operador	Se passado = o comando aplica ao banco de dados local quando é executado de um componente (parâmetro ignorado fora deste contexto)

Descrição

O comando METHOD SET COMMENTS substitui os comentários dos métodos designados pelo parâmtero rota pelos definidos no parâmetro comentarios.

A documentação modificada por este comando é mostrada no explorador de 4D (não deve ser confundida com linhas de comentários no código). Contém:

texto markdown em bancos de dados projeto,
texto com estilo em bancos de dados binários.

Esta documentação pode ser gerada para métodos de tipo triggers, métodos de projeto, métodos de formulário ou métodos de banco de dados.

Nota: os formulários e os métodos formulário compartem a mesma documentação.

Pode usar dois tipos de sintaxe, baseadas em arrays texto ou variáveis texto:

 C_TEXT(tVpath) // variáveis texto </p> <p>C_TEXT(tVcomments)</p> <p>METHOD SET COMMENTS(tVpath;tVcomments) // documentação de um só método

 ARRAY TEXT(arrPaths;0) // arrays texto</p> <p>ARRAY TEXT(arrComments;0)</p> <p>METHOD SET COMMENTS(arrPaths;arrComments) // documentação para vários métodos

Não é possível combinar as duas sintaxes.

Se passar um nome de rota não válido, é gerado um erro.

Pode executar o comando de uma componente, mas neste caso você deve passar o parâmetro * porque o acesso ao código do componente é somente leitura. Se omitir o parâmetro * neste contexto, o erro -9763 é gerado.

Exemplo

Adicione uma data de modificação para um comentário de trigger existente:

 METHOD GET COMMENTS("[trigger]/Table1";$comments)

 $comments:="Modif:"+String(Current date)+"\r"+$comments

 METHOD SET COMMENTS("[trigger]/Table1";$comments)

Ver também

METHOD GET COMMENTS