Código VS: Ir para Definição & Assinatura Ajuda

4D v19 R6 trouxe o suporte de editores de código fonte externos (por exemplo, Visual Studio Code), permitindo-lhes manusear o código 4D e fornecer-lhes funcionalidades padrão tais como o realce de sintaxe usando a extensão Visual Studio Code.

4Dv19 R7 traz duas novas capacidades: Ir para Definição e Assinatura de Ajuda.

E o melhor de tudo – não tem de fazer nada em VS Code; tudo é automático. Basta seguir as actualizações 4D-Analyzer quando solicitado pela extensão.

Lembrete

Como estas duas capacidades precisam de referenciar ficheiros de projecto, só funcionam bem se o ficheiro 4DM aberto for colocado na arquitectura da pasta do projecto.

Ir para Definição

Como a maioria dos programadores, quando se está a ler ou a editar código, é frequentemente necessário verificar a definição de um elemento de código; com VS Code, pode fazê-lo clicando com o botão direito do rato no elemento de código. Isto abre um menu contextual contendo um item de menu “Ir para definição”. Seleccione este item de menu; o seu cursor será colocado onde o elemento de código está definido. E se o elemento de código estiver definido noutro ficheiro 4dm, o VS Code abrirá automaticamente o ficheiro correspondente antes de colocar o cursor no local certo.
Os elementos de código disponíveis para esta funcionalidade são:

• variáveis de processo
• variáveis locais
• parâmetros
• parâmetros nomeados
• métodos de projecto
• classes de utilizadores
• funções das classes de utilizadores

No exemplo abaixo, fizemos um clique com o botão direito do rato sobre uma função de classe de utilizador e seleccionámos a opção Ir para um item do menu de definição do popup:

O Código VS abriu o ficheiro de classe de utilizador correspondente e colocou o cursor no início da função:

Ajuda de Assinatura

Outra capacidade incluída em 4D v19 R7 é a Ajuda de Assinatura dos elementos de código.
Quando se coloca o cursor do rato sobre um elemento de código, o VS Code exibirá uma dica de ferramenta contendo informação sobre o mesmo, dependendo do seu tipo:

• a gramática e uma breve descrição dos comandos 4D
• a gramática e a primeira linha de comentários de marcação para métodos de projecto
• a gramática e uma breve descrição das funções das classes nativas 4D
• a gramática para funções de classes de utilizadores (do projecto ou componente anfitrião)
• a gramática e o comentário colocado na linha de declaração para todas as variáveis

A captura de ecrã abaixo foi tirada quando o rato paira sobre uma função de classe de utilizador. O código VS mostra então uma dica de ferramenta com a gramática da função:

Muito melhor, o VS Code também exibe uma dica de ferramenta ao digitar estes elementos de código (excepto para variáveis), para que o ajude ao codificar!
E a cereja no bolo, o parâmetro editado, é realçada na dica de ferramenta quando se digita um parâmetro!

A captura de ecrã abaixo foi tirada quando se digita o segundo parâmetro de uma função de classe de utilizador. O Código VS mostra então uma dica de ferramenta com a gramática da função e destaca o parâmetro adequado:

Se ainda precisar de mais informações, deixe-nos um comentário sobre os Fóruns 4D.