Novas diretivas para a ferramenta Beautify estão disponíveis no Visual FoxPro 9

Microsoft Visual FoxPro inclui uma ferramenta que é denominada Beautify. A ferramenta Beautify permite que você facilitar a leitura fornecendo opções para ajustar o recuo e caso seu código. Você pode definir globalmente essas opções na caixa de diálogo Opções Beautify . Essas opções são usadas sempre que você executa a ferramenta Beautify em um bloco de código. No entanto, talvez queira substituir algumas dessas opções em uma base por programa. Você pode fazer isso usando Beautify diretivas.

Beautify diretivas são especialmente formatados comentários colocados em blocos de código. Quando você executa a ferramenta Beautify em um bloco de código e a ferramenta Beautify encontra essas diretivas Beautify, a ferramenta Beautify executa certas ações.

A ferramenta Beautify pode ajustar o caso de palavras-chave. Palavras-chave no Visual FoxPro são todas as palavras reservadas na linguagem de programação Visual FoxPro. Por exemplo, uma palavra-chave é MODIFY . Você pode fazer um bloco de código mais fácil de ler e facilitar elementos em um bloco de código identificar, ajustando o caso de todas as palavras-chave no bloco de código. No entanto, esse ajuste, às vezes, pode ter efeitos colaterais inesperados. Embora o Visual FoxPro seja um idioma não diferencia maiúsculas de minúsculas, alguns das ferramentas que pode ser usadas são diferencia maiúsculas de minúsculas. Por exemplo, funções na API do Windows devem ser declaradas e chamadas de maneira sensível a maiúsculas e minúsculas do Visual FoxPro. Um problema relacionado ao Beautify ocorre quando você usa uma função da API do Windows que compartilha o mesmo nome de uma palavra-chave do Visual FoxPro.

Um exemplo específico de uma palavra-chave FoxPro que compartilha o mesmo nome de uma função da API do Windows é a propriedade ShowWindow do Visual FoxPro. Quando a ferramenta Beautify encontra esta palavra-chave Visual FoxPro, a ferramenta Beautify ajusta o caso dessa palavra-chave com base nas configurações na caixa de diálogo Opções Beautify . Para chamar a função de Windows API ShowWindow com êxito, o código do Visual FoxPro deve ser formatado especificamente no caso de Pascal. Referências à propriedade FoxPro ShowWindow podem ser formatadas em qualquer caso que você deseja, porque Visual FoxPro é não diferencia maiúsculas de minúsculas. A ferramenta Beautify não é possível saber se uma ocorrência da ShowWindow palavra-chave em um bloco de código é uma referência para a propriedade do Visual FoxPro ou para a função da API do Windows. Se a referência é para a função da API do Windows e se a ferramenta Beautify altera o caso do código, a chamada para a função falhará quando o código do Visual FoxPro é executado.

Não em versões anteriores do Visual FoxPro 9.0 do Visual FoxPro, havia fácil para impedir que a ferramenta Beautify façam esse ajuste da ocorrência. Visual FoxPro 9.0 apresenta duas diretivas Beautify novas para ajudar a resolver esse problema:

• * # beautify keyword_nochange
• * # beautify

Quando uma palavra-chave no código do Visual FoxPro é encapsulada nessas diretivas, a ferramenta Beautify não fará nenhuma alteração a palavra-chave.

Observação Essas diretivas assumem a forma de comentários. As diretivas são precedidas por um caractere de asterisco. Um caractere de asterisco é o caractere padrão para comentários de linha de total no Visual FoxPro. Esse formato de comentário é necessário para a diretiva para trabalho. Um benefício desse formato de comentário é que, mesmo que a diretiva for reconhecida somente pela ferramenta Beautify no Visual FoxPro 9.0 e versões posteriores, o código continuará a compilar em versões do Visual FoxPro anteriores ao Visual FoxPro 9.0.

O exemplo a seguir demonstra como usar essas diretivas Beautify no Visual FoxPro 9.0 e versões posteriores:

1. Inicie o Visual FoxPro 9.0.
2. No menu Ferramentas , clique em Beautify . A caixa de diálogo Opções Beautify é aberta.
   
   Observação Se Beautify estiver indisponível no menu Ferramentas , pressione CTRL + F2 no teclado para abrir a janela de comando e para dar o foco de janela de comando. Em seguida, tente clique novamente em Beautify no menu Ferramentas .
3. Na área de capitalização , clique em maiúsculas na lista de palavras-chave .
4. Para fechar a caixa de diálogo Beautify opções , clique em Executar .
5. Abra uma nova janela de edição, executando a linha de código a seguir na janela de comando.

   MODIFY COMMAND BeautifyTest

6. Copie as linhas de código a seguir e, em seguida, cole o código a nova janela de edição.

   *------- <BLOCK 1>
   *
   *#beautify keyword_nochange
   #DEFINE SW_MINIMIZE	6
   DECLARE INTEGER ShowWindow IN WIN32API ;
   	INTEGER nHWND, ;
   	INTEGER nCmdShow
   
   ShowWindow(_VFP.HWND, SW_MINIMIZE)
   *#beautify
   *
   *------- </BLOCK 1>
   
   
   *------- <BLOCK 2>
   *
   #DEFINE SW_MINIMIZE	6
   DECLARE INTEGER ShowWindow IN WIN32API ;
   	INTEGER nHWND, ;
   	INTEGER nCmdShow
   
   ShowWindow(_VFP.HWND, SW_MINIMIZE)
   *
   *------- </BLOCK 2>
   

7. Execute a ferramenta Beautify no código. Para fazer isso, clique em Beautify no menu Ferramentas e, em seguida, clique em Executar .

Este código de exemplo é separado em dois blocos. Os blocos são os mesmos, exceto que bloquear 1 contém as diretivas Beautify. No bloco 1, o caso da palavra-chave ShowWindow não é alterado. Quando a ferramenta Beautify é executada, a ferramenta Beautify encontra o * # beautify keyword_nochange diretiva e deixa a palavra-chave ShowWindow sozinho.

Block 2 não contém as diretivas Beautify. Portanto, no bloco 2 ShowWindow palavra-chave é alterado para maiúsculas. Essa alteração torna o bloco de código não é válido. Para verificar isso, salve e em seguida, execute o código. Quando você executa o código, o seguinte erro será lançado na linha da Block 2 DECLARE : Observação Essas diretivas Beautify não estão na documentação que acompanha o Visual FoxPro 9.0.