As directivas de novas para a ferramenta Beautify estão disponíveis no Visual FoxPro 9

Microsoft Visual FoxPro inclui uma ferramenta denominada Beautify. A ferramenta Beautify permite-lhe facilitar a leitura, fornecendo opções para ajustar o avanço e caso o código. Pode definir globalmente estas opções na caixa de diálogo Opções Melhore . Estas opções são utilizadas sempre que executar a ferramenta Beautify num bloco de código. No entanto, poderá substituir algumas destas opções num regime programa pelo programa. Pode fazê-lo utilizando as directivas Beautify.

Melhore as directivas são especialmente formatados comentários colocados em blocos de código. Quando executa a ferramenta Beautify num bloco de código e a ferramenta Beautify encontra estas directivas Beautify, a ferramenta Beautify executa determinadas acções.

A ferramenta Beautify pode ajustar o caso de palavras-chave. Palavras-chave do Visual FoxPro são todas as palavras reservadas na linguagem de programação do Visual FoxPro. Por exemplo, uma palavra-chave é MODIFY . Pode facilitar um bloco de código ler e facilitar elementos num bloco de código identificar ajustando o caso de todas as palavras-chave no bloco de código. No entanto, este ajuste, por vezes, pode ter efeitos inesperados. Apesar do Visual FoxPro um idioma não sensível a maiúsculas e minúsculas, algumas das ferramentas que pode utilizar são sensíveis a maiúsculas e minúsculas. Por exemplo, funções na API do Windows devem ser declaradas e chamadas de um modo sensível a maiúsculas e minúsculas a partir do Visual FoxPro. Um problema relacionado com Beautify ocorre quando utiliza uma função da API do Windows que partilha o mesmo nome que uma palavra-chave do Visual FoxPro.

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

Nas versões do Visual FoxPro anteriores Visual FoxPro 9.0, não ocorreu nenhuma forma fácil de impedir que a ferramenta Beautify efectuem este ajuste caso. Visual FoxPro 9.0 introduz dois novas Beautify as directivas para ajudar a resolver este problema:

• * # Melhore keyword_nochange
• * Melhore #

Quando uma palavra-chave no código do Visual FoxPro é moldada nestas directivas, a ferramenta Beautify serão efectuadas sem alterações para a palavra-chave.

Nota Estas directivas tomar a forma de comentários. As directivas são precedidas por um carácter de asterisco (*). Um carácter de asterisco (*) é o carácter predefinido para comentários de linha completa no Visual FoxPro. Este formato de comentário é necessário para a directiva trabalhar. Uma vantagem deste formato comentário é que, apesar da directiva só é reconhecida pela ferramenta Beautify no Visual FoxPro 9.0 e versões posteriores, o código irá continuar a compilar em versões anteriores do Visual FoxPro 9.0 do Visual FoxPro.

O exemplo seguinte demonstra como utilizar estas directivas 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 Melhore é aberta.
   
   Nota Se Beautify estiver indisponível no menu Ferramentas , prima CTRL+F2 no teclado para abrir a janela de comandos e para dar o foco da janela de comandos. Em seguida, tente clicar novamente Beautify no menu Ferramentas .
3. Na área de maiúsculas , clique em maiúsculas na lista de palavras-chave .
4. Para fechar a caixa de diálogo Opções Melhore , clique em Executar .
5. Abra uma nova janela de edição executando a seguinte linha de código na janela de comandos.

   MODIFY COMMAND BeautifyTest

6. Copie as seguintes linhas de código e, em seguida, cole o código para a nova janela Editar.

   *------- <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 tal, clique em Beautify no menu Ferramentas e, em seguida, clique em Executar .

Este código de exemplo está dividido em dois blocos. Os blocos são os mesmos excepto que bloco 1 contém as directivas Beautify. No bloco de 1, o caso da palavra-chave ShowWindow não é alterado. Quando a ferramenta Beautify é executada, a ferramenta Beautify encontra o * # Melhore keyword_nochange directiva e deixa a palavra-chave ShowWindow individualmente.

Bloco 2 não contém as directivas Beautify. Por conseguinte, no bloco 2 ShowWindow palavra-chave é alterada para maiúsculas. Esta alteração facilita o bloco de código não é válido. Para verificar isto, guarde e, em seguida, execute o código. Quando executa o código, o seguinte erro irão ser iniciado na linha DECLARE bloco 2: Nota Estas directivas Beautify não estão na documentação que acompanha o Visual FoxPro 9.0.