Adicionar uma expressão de inspeção de variáveis

Uma expressão de inspeção de variáveis é uma expressão que você define para ser monitorada na janela Inspeção de variáveis. Quando seu aplicativo entra em modo interromper, as expressões de inspeção de variáveis selecionadas aparecem na janela Inspeção de variáveis onde você pode observar seus valores.

Para adicionar uma expressão de inspeção de variáveis

1.	No menu Depurar, clique em Adicionar inspeção de variáveis.

A caixa de diálogo Adicionar inspeção de variáveis é exibida.

2.	Se uma expressão já estiver selecionada na janela Código, ela é automaticamente exibida na caixa Expressão. Se nenhuma expressão for exibida, insira a expressão que você deseja avaliar. A expressão pode ser uma variável, uma propriedade, uma chamada de função ou qualquer outra expressão válida.

3.	Selecione um contexto de módulo ou de procedimento no grupo Contexto para selecionar o intervalo para o qual a expressão será avaliada.

Observação   Selecione o escopo mais restrito que atenda às suas necessidades. Selecionar todos ou procedimentos ou todos os módulos pode tornar vagarosa consideravelmente a execução do módulo, visto que a expressão é avaliada depois da execução de cada instrução. Se você selecionar um procedimento específico para um contexto, a execução só será afetada enquanto o procedimento estiver na lista de chamadas de procedimento ativo. Escolha Pilha de chamadas no menu Exibir para exibir a lista de procedimentos ativos.

4.	Selecione uma opção no grupo Tipo de inspeção de variáveis para definir como o sistema reage à expressão de inspeção de variáveis.

•	Para exibir o valor da expressão de inspeção de variáveis, clique em Expressão de inspeção de variáveis.

•	Para interromper a execução, se a expressão for avaliada como True, clique em Interromper quando o valor for True.

•	Para interromper a execução quando o valor da expressão for alterado, clique em Interromper quando o valor for alterado.

5.	Clique em OK.


Excluir uma expressão de inspeção de variáveis

Para excluir uma expressão de inspeção de variáveis na janela Inspeção de variáveis, use um dos seguintes procedimentos:

•	Selecione a expressão de inspeção de variáveis e pressione DELETE.

•	Selecione a expressão e escolha Limpar no menu Editar.

•	Selecione a expressão, escolha Editar inspeção de variáveis no menu Depurar e, em seguida, pressione DELETE.

•	Clique com o botão direito do mouse na expressão e escolha Excluir inspeção de variáveis no menu de contexto.


Editar uma expressão de inspeção de variáveis

Para editar uma expressão de inspeção de variáveis

1.	Clique duas vezes na expressão de inspeção de variáveis na janela Inspeção de variáveis.

-ou-

Selecione a expressão e escolha Editar inspeção de variáveis no menu Depurar.

-ou-

Clique com o botão direito do mouse na expressão e escolha Editar inspeção de variáveis no menu de contexto.

2.	Faça qualquer alteração na expressão, no contexto e no tipo de inspeção de variáveis.

3.	Clique em OK.


Usar Inspeção de variáveis rápida

No modo interromper, você pode querer verificar o valor atual de uma variável ou expressão para as quais você não tenha definido uma expressão de inspeção de variáveis. Faça isto usando o comando Inspeção de variáveis rápida.

Para exibir uma Inspeção de variáveis rápida

1.	Selecione uma expressão no módulo onde ela reside.

2.	No menu Depurar, escolha Inspeção de variáveis rápida (SHIFT+F9).

A caixa de diálogo Inspeção de variáveis rápida exibe o valor atual da expressão que você selecionou.

-ou-

Clique com o botão direito do mouse e escolha Informação rápida no menu de contexto. O tipo de dados da expressão é exibido.

3.	Para adicionar uma expressão de inspeção de variáveis baseada na expressão na caixa de diálogo Inspeção de variáveis rápida, escolha Adicionar.


Verificar ou adicionar uma referência de biblioteca de objetos

Se você usa os objetos em outros aplicativos como parte do seu aplicativo Visual Basic, poderá estabelecer uma referência às bibliotecas de objetos destes aplicativos. Para fazer isto, você deve primeiro certificar-se de que o aplicativo forneça uma biblioteca de objetos.

Para saber se um aplicativo fornece uma biblioteca de objetos

1.	No menu Ferramentas, escolha Referências para exibir a caixa de diálogo Referências.

2.	A caixa de diálogo Referências exibe todas as bibliotecas de objetos registradas com o sistema operacional. Role pela lista do aplicativo a cuja biblioteca de objetos você deseja fazer referência. Se o aplicativo não estiver listado, você pode usar o botão Procurar para procurar por bibliotecas de objetos (*.olb e *.tlb) ou arquivos executáveis (*.exe e *.dll no Windows). As referências cujas caixas de seleção estão marcadas são usadas pelo seu projeto; as que não estão marcadas não são usadas, mas podem ser adicionadas.

Para adicionar uma referência de biblioteca de objetos ao seu projeto

•	Selecione a referência de biblioteca de objetos da caixa Referências disponíveis na caixa de diálogo Referências e clique em OK.

Seu projeto do Visual Basic agora tem uma referência à biblioteca de objetos do aplicativo. Se você abrir o Pesquisador de objeto (pressione F2) e selecionar a biblioteca do aplicativo, ele exibirá os objetos fornecidos pela biblioteca de objetos selecionada, bem como os métodos e propriedades de cada objeto. No Pesquisador de objeto, você pode selecionar uma classe na caixa Classes e selecionar um método ou propriedade na caixa Membros. Use copiar e colar para adicionar a sintaxe ao seu código.


Continuar execução de código

Quando você executa seu código, a execução pode ser parada se:

•	Ocorrer um erro em tempo de execução não interceptado.

•	Ocorrer um erro em tempo de execução interceptado e Interromper em todos os erros for selecionada na guia Geral da caixa de diálogo Opções (menu Ferramentas).

•	For encontrado um ponto de interrupção previamente definido.

•	Uma instrução Stop for encontrada no seu código, alternando o modo para o modo de interrupção.

•	Uma instrução End for encontrada no seu código, alternando o modo para tempo de criação.

•	Você interromper a execução manualmente em um determinado ponto.

•	Uma expressão de inspeção de variáveis, que você define para interromper quando o valor for alterado ou interromper quando o valor for verdadeiro, for encontrada.

Para interromper a execução manualmente

1.	Para alternar para o modo de interrupção, selecione Interromper (CTRL+BREAK) no menu Executar ou use o atalho da barra de ferramentas: .

2.	Para alternar para tempo de criação, selecione Redefinir <projectname> no menu Executar use o atalho da barra de ferramentas: .

Para continuar a execução quando seu aplicativo tiver sido interrompido

•	No menu Executar, clique em Continuar (F5) ou use o atalho da barra de ferramentas:

– Ou –

•	No menu Depurar, clique em Depuração total (F8), Depuração parcial (SHIFT+F8), Depuração circular (CTRL+SHIFT+F8) ou Executar até o cursor (CTRL+F8).

Para continuar a execução quando seu aplicativo for interrompido por causa de um erro manipulado

•	Pressione ALT+F8 para ignorar o manipulador de erros.

– Ou –

•	Pressione ALT+F5 para recomeçar a execução com o manipulador de erros.


Copiar código de exemplo da Ajuda

Às vezes convém copiar um exemplo útil de Ajuda do Visual Basic. Embora vários exemplos precisem de mais código para funcionar corretamente, alguns são úteis para ver como se comporta um determinado procedimento ou técnica de fluxo de controle.

Para copiar o código de exemplo da Ajuda para o seu aplicativo

1.	Use a Ajuda para exibir o tópico do elemento de linguagem cujo exemplo você deseja usar.

2.	Clique no vínculo Exemplo fora da região de rolagem próxima à parte superior da página. O exemplo de código é exibido.

3.	Clique com o botão direito do mouse e selecione a parte do código que você deseja copiar para o seu aplicativo. No Macintosh, escolha Copy no menu Edit; aparece uma janela na qual você pode selecionar o código a ser copiado.

4.	Escolha Copiar no menu de atalho.  No Macintosh, pressione o botão Copy.

5.	Mova o foco de volta para a janela Code e posicione o ponteiro do mouse onde você deseja que o exemplo de código seja inserido.

6.	Clique novamente com o botão direito do mouse e escolha Colar para inserir o exemplo de código na janela Code.

Dica   Você também pode pressionar CTRL+C para copiar um exemplo selecionado em uma janela Ajuda. Pressione CTRL+V para colar o exemplo na janela Code.


Criar um procedimento

O código dentro de um módulo é organizado em procedimentos. Um procedimento informa ao aplicativo como ele deve executar uma tarefa específica. Use procedimentos para dividir tarefas de código complexas em unidades mais gerenciáveis.

Para criar um procedimento escrevendo código

1.	Abra o módulo para o qual você deseja escrever o procedimento.

2.	Você pode criar um procedimento Sub, Function ou Property.

3.	Digite Sub, Function ou Property.

Pressione F1 para obter Ajuda sobre sintaxe, se necessário.

4.	Digite o código para o procedimento.

O Visual Basic conclui o procedimento com a instrução End Sub, End Function ou End Property apropriada.

Para criar um procedimento usando a caixa de diálogo Inserir procedimento

1.	Abra o módulo para o qual você deseja escrever o procedimento.

2.	No menu Inserir, clique em Procedimento.

3.	Digite o nome do procedimento na caixa Nome da caixa de diálogo Inserir procedimento.

4.	Selecione o tipo de procedimento que você deseja criar: Sub, Function ou Property.

5.	Defina o escopo do para Public, Private ou Friend.

6.	Você pode selecionar Todas variáveis locais como estáticas para adicionar a palavra-chave Static à definição do procedimento.

7.	Clique em OK.


Inserir uma declaração no código

Declarações são instruções de código não executáveis que nomeiam procedimentos, constantes ou variáveis externos e definem seus atributos (como tipo de dados). Você pode escrever declarações para módulos de formulário, padrão ou classe. Para inserir declarações em nível de módulo, vá para a seção Declarações de um módulo. Para inserir declarações globais, vá para a seção Declarações de um módulo e use a instrução Public para constantes e variáveis. Você também pode usar as palavras-chave Dim, Static e Private para fazer declarações.

Você também pode inserir declarações em nível de procedimento. Para qualquer nível de código e técnica que você use para declarar uma variável ou constante, podem ser aplicadas regras de escopo específicas.

Para abrir a seção Declarações de um módulo

1.	Na janela Projeto, selecione o módulo de formulário, padrão ou classe que você deseja abrir e clique no botão Exibir código.

– Ou –

Clique com o botão direito do mouse  e escolha Exibir código no menu de contexto.

2.	Na caixa Objeto, selecione (Geral).

A caixa Procedimento automaticamente exibe (Declarações).

3.	Insira uma ou mais declarações.


Executar uma instrução específica

Quando a execução de seu código for interrompida, você pode controlar a seqüência de execução de instruções em um procedimento. Você pode recomeçar a execução em uma instrução escolhida sem executar nenhum outro código intermediário.

Para definir a próxima instrução a ser executada

1.	Na janela Code, posicione o ponto de inserção em qualquer ponto dentro da instrução.

2.	No menu Depurar, clique em Definir próxima instrução (CTRL+F9).

– ou no Windows –

Posicione o ponteiro do mouse no indicador de margem próximo ao ponto de execução automático.

3.	Arraste a seta amarela no indicador de margem para a instrução que você deseja executar em seguida.

Observação   Você somente pode ignorar instruções dentro do mesmo procedimento.

Em conjunto com Depuração total, executar instruções específicas com o comando Definir próxima instrução permite que você passe pelos procedimentos com uma instrução de cada vez e examine detalhadamente seu código. Isto também é útil para corrigir e evitar condições de erro em tempo de execução.


Localizar um procedimento

Para localizar um procedimento na janela Code

•	Para exibir um procedimento geral existente, selecione (Geral) na caixa Objeto na janela Code e, em seguida, selecione o procedimento na caixa Procedimento.

•	Para exibir um procedimento de evento, selecione o objeto apropriado na caixa Objeto na janela Code e, em seguida, selecione o evento na caixa Procedimento.

Observação   Para separar visualmente os procedimentos, na janela Code, você pode marcar a caixa de seleção Separador de procedimento na guia Editor da caixa de diálogo Opções (menu Ferramentas). Você pode alternar entre os modos Procedimento e Módulo completo usando os botões no canto inferior esquerdo da janela Code.

Para localizar um procedimento em outro módulo

1.	No menu Exibir, clique em Pesquisador de objeto ou pressione F2.

2.	Selecione o projeto na caixa Projeto/Biblioteca.

3.	Selecione o módulo na lista Classes.

4.	Clique duas vezes no nome de procedimento na lista Membros de.

O procedimento selecionado é exibido na janela Code.

Você pode usar os seguintes atalhos de teclado:

Pressione	Para
CTRL+SETA ABAIXO	Exibir o próximo procedimento.
CTRL+SETA ACIMA	Exibir o procedimento anterior.
PAGE DOWN	Descer uma página nos procedimentos do seu código.
PAGE UP	Subir uma página nos procedimentos do seu código.
F2	Exibir o Pesquisador de objeto.


Localizar uma definição de variável

Para exibir a definição de uma variável

1.	Na janela Code, selecione a variável cuja definição você deseja ver.

2.	No menu Exibir, selecione Definição (SHIFT+F2).

Para retornar o ponteiro do mouse para sua posição anterior

•	No menu Exibir, clique em Última posição (CTRL+SHIFT+F2).


Importar um arquivo de texto para o código

Você pode importar um arquivo de texto contendo código no módulo atual e usá-lo em seu código.

Para importar um arquivo de texto para um módulo

1.	Abra o módulo em que você deseja inserir texto e posicione o ponto de entrada no local onde deseja que o texto seja inserido.

2.	No menu Inserir, clique em Arquivo.

3.	A caixa de diálogo Inserir arquivo é exibida.

4.	Use a caixa de diálogo Inserir arquivo para selecionar o arquivo a ser importado.

5.	Clique em OK.


Substituir texto no código
Substituir texto em código

Para substituir texto em um módulo

1.	No menu Editar, clique em Substituir.

A caixa de diálogo Substituir é exibida.

2.	Na caixa Localizar, digite o texto que você deseja procurar.

3.	Na caixa Substituir por, digite o texto a ser substituído.

4.	Selecione uma opção Pesquisar para especificar onde procurar pelo texto.

5.	Selecione uma direção na lista Direção para definir a direção da pesquisa.

6.	Para definir os limites da pesquisa, selecione:

•	Somente palavra inteira para procurar pela palavra inteira sozinha e não como parte de outra palavra.

•	Diferenciar maiúsc. de minúsc. para uma correspondência exata.

•	Coincidir padrão de caractere para usar caracteres curinga.

7.	Escolha Localizar próxima se desejar confirmar a alteração antes de substituir o texto; escolha Substituir para substituir a ocorrência realçada do texto encontrado e executar automaticamente um comando Localizar próxima, ou escolha Substituir tudo para alterar todas as ocorrências do texto de pesquisa automaticamente.


Reiniciar execução

Você pode reiniciar a execução a partir de modo de interrupção. Reiniciar retorna o código para um estado recém inicializado, reiniciando todas as variáveis e removendo qualquer procedimentos suspenso da memória.

Para reiniciar a execução

1.	No menu Executar, clique em Reiniciar <projectname> ou use o atalho da barra de ferramentas: .

2.	No menu Executar, clique em Executar Sub/UserForm (F5) ou use o atalho da barra de ferramentas:


Procurar por texto no código
Procurar o texto no código

Para procurar por texto específico em um módulo

1.	No menu Editar, clique em Localizar.

A caixa de diálogo Localizar é exibida.

2.	Na caixa Localizar, digite o texto que você deseja procurar (se você não selecionou o texto antes de exibir a caixa de diálogo).

3.	Selecione uma opção Pesquisar para especificar onde procurar pelo texto.

4.	Selecione uma direção da lista Direção para especificar a direção da pesquisa.

5.	Para definir os limites da pesquisa, selecione:

•	Somente palavra inteira para procurar pela palavra inteira sozinha e não como parte de outra palavra.

•	Diferenciar maiúsc. de minúsc. para localizar a correspondência exata.

•	Coincidir padrão de caractere para usar caracteres curinga ou intervalos.

6.	Selecione Localizar próxima.


Definir uma referência a uma biblioteca de tipos

A automação (antes conhecida como Automação OLE) permite que você use objetos de outros aplicativos no código do Visual Basic. Um aplicativo que fornece seus objetos para serem usados por outros aplicativos também fornece informações sobre estes objetos em uma biblioteca de tipos. Para alcançar o melhor desempenho possível ao usar os objetos de outro aplicativo, você deve definir uma referência para a biblioteca de tipos desse aplicativo.

Para definir uma referência a uma biblioteca de tipos de um aplicativo

1.	Clique em Referências no menu Ferramentas.

2.	Marque as caixas de seleção para aplicativos com bibliotecas de tipos às quais você quer fazer referência.

Se você estiver escrevendo código que manipule objetos em outro aplicativo, deverá definir uma referência para a biblioteca de tipos deste aplicativo para obter o melhor acesso possível a estes objetos. Você não precisa definir uma referência para usar objetos de outros aplicativos, mas fazer isto oferece várias vantagens ao seu aplicativo.

Seu código será executado mais rapidamente se você definir uma referência à biblioteca de tipos de outro aplicativo antes de trabalhar com os seus objetos. Se você definir uma referência, pode declarar uma variável de objeto representando um objeto no outro aplicativo como o tipo mais específico. Por exemplo, se você estiver escrevendo código para trabalhar com objetos Microsoft Excel, deve declarar uma variável de objeto do tipo Excel.Application, se você criou uma referência para a biblioteca de tipos Microsoft Excel. O código a seguir é a forma mais rápida de criar uma variável para representar o objeto Application do Microsoft Excel.

Dim appXL As Excel.Application

Se você não definiu uma referência para a biblioteca de tipo Microsoft Excel, deve declarar a variável como uma variável genérica do tipo Object. O código a seguir é executado mais lentamente.

Dim appXL As Object

Se você definir uma referência para uma biblioteca de tipos de aplicativo, todos os seus objetos e seus métodos e propriedades serão listados no Pesquisador de objeto. Isto facilita determinar quais propriedades e métodos estão disponíveis para cada objeto.

Para aplicativos da Microsoft que também podem servir como servidores de automação, você pode definir referências para suas bibliotecas de tipos a partir de outro aplicativo e controlar seus objetos a partir deste aplicativo.


Definir e limpar um ponto de interrupção

Você pode definir um ponto de interrupção para suspender a execução em uma instrução específica em um procedimento; por exemplo, onde você suspeite que possa haver problemas. Você limpa pontos de interrupção onde eles não precisam mais parar a execução.

Para definir um ponto de interrupção

1.	Posicione o ponto de inserção em qualquer lugar em uma linha do procedimento onde você deseja que a execução seja interrompida.

2.	No menu Depurar, clique em Ativar/Desativar pontos de interrupção (F9), clique ao lado da instrução em Barra indicadora de margem (se visível) ou use o atalho da barra de ferramentas: .

O ponto de interrupção é adicionado e a linha é definida com a cor do ponto de interrupção definido na guia Formato do editor na caixa de diálogo Opções.

Se você definir um ponto de interrupção em uma linha que contém várias instruções separadas por sinais de dois-pontos (:), a interrupção sempre ocorrerá na primeira instrução da linha.

Para limpar um ponto de interrupção

1.	Posicione o ponto de inserção em qualquer lugar em uma linha do procedimento contendo o ponto de interrupção.

2.	No menu Depurar, selecione Ativar/Desativar pontos de interrupção (F9) ou clique ao lado da instrução na Barra indicadora de margem (se visível).

3.	O ponto de interrupção é limpo e o realce é removido.

Para limpar todos os pontos de interrupção no aplicativo

•	No menu Depurar, selecione Limpar todos os pontos de interrupção (CTRL+SHIFT+F9).

Observação   Pontos de interrupção definidos em código não são salvos quando você salva seu código.


Definir propriedades do projeto

Para definir propriedades do projeto

1.	No menu Ferramentas, selecione <projectname> Propriedades

2.	Use a guia Geral na caixa de diálogo <projectname> Propriedades para especificar o seguinte:

•	Nome do seu projeto.

•	Descrição do seu projeto.

•	Nome do arquivo da Ajuda associado ao seu projeto

•	Código do contexto para o tópico da Ajuda específico a ser chamado quando o usuário clica no botão Ajuda enquanto a biblioteca de objetos do aplicativo está selecionada no Pesquisador de objeto.

3.	Use a guia Proteção na caixa de diálogo <projectname> Propriedades para impedir que o projeto seja exibido por outros, e especifique uma senha para acessar as propriedades do projeto. Depois de definir a proteção, você deve salvar e fechar o seu projeto para que a proteção seja efetivada.


Definir opções de ambiente do Visual Basic

Você pode definir o comportamento e aparência do ambiente de desenvolvimento do Visual Basic por meio da caixa de diálogo Opções. Use a:

•	Guia Editor para especificar as configurações da janela Code e janela Projeto.

•	Guia Formato do editor para especificar a aparência de seu código.

•	Guia Geral para especificar configurações de formulário, manipulação de erros e compilação para seu projeto.

•	Guia Encaixe para especificar se uma janela é anexada ou "encaixada" a uma borda de outras janelas encaixáveis ou de aplicativo.

Para definir opções de Ambiente

•	No menu Ferramentas do editor do Visual Basic, clique em Opções. Cada opção é descrita nas seguintes tabelas.

Editor

Opção	Descrição
Verificação automática de sintaxe	O Visual Basic verifica automaticamente a sintaxe correta depois que você insere uma linha de código.
Solicitar declaração de variável	Declarações explícitas de variáveis são obrigatórias nos módulos.
Auto recuar	Depois de inserir uma marca de tabulação na primeira linha de código, todas as linhas subseqüentes se iniciam nessa posição de tabulação.
Largura da tabulação	A largura da tabulação, que pode variar de 1 a 32 espaços. (O padrão é de 4 espaços.)
Padrão para exibir módulo completo	Procedimentos para novos módulos são exibidos na janela Code com uma lista única rolável ou um procedimento de cada vez.
Separador de procedimento	Exibe barras separadoras no fim de cada procedimento na janela Code.
Auto listar membros	No ponto de inserção, o Visual Basic exibe as informações que completam logicamente uma instrução.
Informação automática rápida	Informações sobre funções e seus argumentos são exibidas à medida que você digita.
Dicas automáticas de dados	Exibe automaticamente o valor de qualquer variável em que você posicionar o ponteiro do mouse. Disponível apenas no modo de interrupção.
Recurso de edição arrastar-e-soltar	Elementos de código podem ser arrastados da janela Code para as janelas Imediata ou Inspeção de variáveis.
Formato do editor

Opção	Descrição
Primeiro plano, Segundo plano e Indicador	A cor de categorias diferentes de texto listadas na lista Cores de código.
Fonte	A fonte usada para exibir código.
Tamanho	O tamanho da fonte usada para o código.
Barra indicadora de margem	Exibe a Barra indicadora de margem.
Geral

Opção	Descrição
Mostrar grade	Exibe uma grade em um formulário.
Unidades da grade	Lista a unidade de medida para as unidades da grade.
Largura	A largura das células da grade em um formulário.
Altura	A altura das células da grade em um formulário.
Alinhar controles à grade	Posiciona automaticamente na extremidade externa dos controles nas linhas de grade mais próximas.
Mostrar dicas de ferramentas	Exibe dicas de ferramentas para os botões da barra de ferramentas.
Ocultar janelas ao retrair projeto	Fecha automaticamente as janelas do projeto, UserForm, objeto ou módulo quando um projeto está retraído no Project Explorer.
Notificar antes da perda de estado	Exibe uma mensagem de que uma ação solicitada fará com que todas as variáveis em nível de módulo sejam redefinidas para um projeto em execução.
Interromper em todos os erros	Qualquer erro faz com que o projeto entre no modo de interrupção, independentemente de o manipulador de erros estar ativo e de o código estar em um módulo de classe.
Interromper em módulo de classe	Um erro não tratado produzido em um módulo de classe faz com que o projeto entre no modo de interrupção na linha de código que produz o erro.
Interromper em erros não tratados	Qualquer outro erro não tratado faz o projeto entrar no modo de interrupção.
Compilar ao ser solicitado	Um projeto é totalmente compilado antes de começar ou o código é compilado à medida que se torna necessário.
Compilar em segundo plano	Usa o tempo ocioso durante o tempo de execução para terminar de compilar o projeto em segundo plano. (Disponível somente se Compilar ao ser solicitado estiver ativada.)
Encaixe

Opção	Descrição
A caixa de seleção da janela apropriada	A janela pode ser encaixada em uma janela adjacente encaixável ou a uma janela do Editor do Visual Basic.


Dividir a janela Code

Você pode dividir a janela Code horizontalmente em dois painéis para exibir diferentes segmentos do código de um módulo ao mesmo tempo. Cada painel se movimenta separadamente, na horizontal e na vertical. As opções da caixa Procedimento e Objeto referem-se ao painel que está com o foco. As alterações de código são imediatamente refletidas nos dois painéis.

Para dividir a janela Code em painéis

•	Arraste a barra de divisão na parte superior da barra de rolagem vertical para baixo a partir do canto superior direito da janela Code.

Para remover uma divisão da janela Code

•	Clique duas vezes na barra de divisão ou arraste-a para a parte superior ou inferior da janela Code.


Iniciar execução de código

Uma forma de testar o seu código é executá-lo e trabalhar com ele como um usuário faria.

Para iniciar a execução do código

•	Selecione Executar Sub/UserForm (F5) no menu Executar.

Se seu aplicativo não puder ser executado, a causa pode ser:

•	Um erro de sintaxe ou algum outro erro existente no seu código.

•	Um erro lógico no seu código, que pode resultar em um erro em tempo de execução.

Para obter ajuda, clique no botão Ajuda ou pressione F1 quando a mensagem de erro for exibida. Considere as sugestões fornecidas para corrigir o erro antes de executar seu código novamente.


Parar execução de código
Parar execução do código

Enquanto estiver executando seu código, ele pode parar de ser executado por uma das razões a seguir:

•	Ocorre um erro em tempo de execução não interceptado.

•	Ocorre um erro em tempo de execução interceptado e Interromper em todos os erros está selecionada na guia Geral da caixa de diálogo Opções.

•	É encontrado um ponto de interrupção.

•	É encontrada uma instrução Stop no seu código, alternando para o modo de interrupção.

•	É encontrada uma instrução End no seu código, alternando o modo para tempo de criação.

•	Você interrompe a execução manualmente em um determinado ponto.

•	É encontrada uma expressão de inspeção de variáveis que você define para ser interrompida caso seu valor seja alterado ou se torne verdadeiro.

Para interromper a execução manualmente

•	Para alternar para o modo de interrupção, no menu Executar selecione Interromper (CTRL+BREAK) ou use o atalho da barra de ferramentas: .

•	Para alternar para o tempo de criação, no menu Executar selecione Redefinir <projectname> ou use o atalho da barra de ferramentas: .

Para continuar a execução quando seu aplicativo tiver sido interrompido

•	No menu Depurar, clique em Depuração total (F8), Depuração parcial (SHIFT+F8), Depuração circular (CTRL+SHIFT+F8) ou Executar até o cursor (CTRL+F8).


Rastrear execução de código

Você rastreia a execução de código porque pode não ser sempre óbvio que instrução é executada primeiro. Use estas técnicas para rastrear a execução do código:

•	Depuração total: Rastreia a cada linha de código e depura totalmente os procedimentos. Permite que você visualize o efeito de cada instrução em variáveis.

•	Depuração parcial: Executa cada procedimento como se fosse uma única instrução. Utilize-a em vez de Depuração total para percorrer em etapas as chamadas de procedimento e não o procedimento chamado.

•	Depuração circular: Executa todo o código restante em um procedimento como se fosse uma única instrução e sai para a próxima instrução no procedimento que causou o procedimento a ser chamado inicialmente.

•	Executar até o cursor: Permite que você selecione uma instrução no seu código onde deseja que a execução pare. Isto permite que você faça "depuração parcial" de seções de código, por exemplo, grandes loops.

Para rastrear a execução da instrução atual

•	No menu Depurar, clique em Depuração total (F8), Depuração parcial (SHIFT+F8), Depuração circular (CTRL+SHIFT+F8) ou Executar até o cursor (CTRL+F8).

Para rastrear a execução do começo do programa

•	No menu Depurar, clique em Depuração total (F8), Depuração parcial (SHIFT+F8), Depuração circular (CTRL+SHIFT+F8) ou Executar até o cursor (CTRL+F8).


Ativar ou desativar verificação de sintaxe

O Visual Basic oferece um recurso de verificação de sintaxe que:

•	Verifica cada instrução quando você a insere quanto a erros de sintaxe, como uma palavra-chave com erro de grafia ou com um separador faltando e alerta você em caso de erros.

•	Traduz o código para um formulário interno se a sintaxe estiver correta, o que acelera a transição do tempo de execução.

Este recurso é ativado quando você inicia, mas você pode desativá-lo se preferir escrever código sem ser alertado quando os erros ocorrerem.

Para ativar a verificação de sintaxe

1.	No menu Ferramentas, clique em Opções.

2.	Selecione a guia Editor.

3.	Marque a caixa de seleção Verificação automática de sintaxe.

4.	Clique em OK.

Para desativar a verificação de sintaxe

1.	Clique em Opções no menu Ferramentas.

2.	Selecione a guia Editor.

3.	Desmarque a caixa de seleção Verificação automática de sintaxe.

4.	Clique em OK.


Usar a janela Verificação imediata

A janela Verificação imediata exibe informações resultando de instruções de depuração no seu código ou de comandos digitados diretamente na janela.

Para exibir a janela Verificação imediata

•	No menu Exibir, selecione a janela Verificação imediata (CTRL+G)

Para executar código na janela Verificação imediata

1.	Digite uma linha de código na janela Verificação imediata.

2.	Pressione ENTER para executar a instrução.

Use a janela Verificação imediata para:

•	Testar código escrito recentemente ou problemático.

•	Consultar ou alterar o valor de uma variável ao executar uma aplicativo. Quando a execução for interrompida, atribua um novo valor à variável como você faria no código.

•	Consultar ou alterar um valor de propriedade enquanto executa um aplicativo.

•	Chamar procedimentos como você faria no código.

•	Visualizar saída de depuração enquanto o programa está sendo executado.

Observação   As instruções da janela Verificação imediata são executadas em um contexto, ou seja, como se fossem inseridas em um módulo específico.

Se você precisar de ajuda na sintaxe para funções, instruções, propriedades ou métodos enquanto trabalha na janela Verificação imediata, selecione a palavra-chave, o nome propriedade ou o nome método e pressione F1.


Usar o Pesquisador de objeto

O Pesquisador de objeto permite que você procure todos os objetos disponíveis no seu projeto e veja suas propriedades, métodos e eventos. Além disso, você pode ver os procedimentos e constantes que estão disponíveis em bibliotecas de objetos no seu projeto. Você pode facilmente exibir a Ajuda on-line enquanto procura. Você pode usar o Pesquisador de objeto para localizar e usar objetos que você cria e objetos de outros aplicativos.

Você pode obter ajuda sobre o Pesquisador de objeto pesquisando por Pesquisador de objeto na Ajuda.

Para navegar pelo Pesquisador de objeto

1.	Ative um módulo.

2.	No menu Exibir, selecione Pesquisador de objeto (F2) ou use o atalho da barra de ferramentas: .

3.	Selecione o nome do projeto ou biblioteca que você deseja visualizar na lista Projeto/Biblioteca.

4.	Use a lista Classes para selecionar a classe; use a lista Membros para selecionar membros específicos da sua classe ou projeto.

5.	Visualize informações sobre a classe ou membro que você selecionou na seção Detalhes na parte inferior da janela.

6.	Use o botão Ajuda para exibir o tópico Ajuda para a classe ou membro que você selecionar.


Usar o Project Explorer

O Project Explorer exibe uma lista hierárquica dos projetos e de todos os itens contidos e com referência feita em cada projeto.

Para navegar pelo Project Explorer

1.	No menu Exibir, selecione Project Explorer (F2) ou use o atalho da barra de ferramentas: .

2.	Selecione um item de uma árvore recolhível que inclua todos os projetos e seus componentes.

3.	Clique no botão Exibir código para abrir a janela Code para começar a inserir código.

– ou –

Clique no botão Exibir objeto para abrir uma janela contendo o objeto especificado.

– ou –

Clique no botão Alternar pastas para alternar entre a vista da pasta e a vista do conteúdo da pasta.


Usar a janela Propriedades

A janela Propriedades lista as propriedades de tempo de criação para objetos selecionados e suas configurações atuais. Você pode alterar estas propriedades no tempo de criação. Quando você seleciona múltiplos controles, a janela Propriedades contém uma lista das propriedades comuns a todos os controles selecionados.

Para navegar pela janela Propriedades

1.	No menu Exibir do Editor do Visual Basic, selecione a janela Propriedades (F4).

2.	Selecione o objeto cujas propriedades você deseja exibir. Você pode usar o mouse para selecionar o objeto ou usar o Project Explorer para escolher de uma lista.

3.	Clique na guia Alfabética para exibir propriedades na ordem alfabética ou clique na guia Categorizado para exibir propriedades do objeto por categoria.

Para alterar um valor de propriedade

1.	Selecione a propriedade na coluna à esquerda.

2.	Altere o valor da propriedade na coluna à direita.

Observação   Você pode inserir um valor de propriedade na coluna à direita. Para estas propriedades para as quais você predefiniu um conjunto de valores, clique no valor e, em seguida, selecione um dos valores exibidos na caixa de listagem.