ID do artigo: 209227 - Última revisão: quarta-feira, 11 de outubro de 2006 - Revisão: 3.2

WD2000: Como armazenar e recuperar variáveis em documentos

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que está a utilizar. Foi desactivado o conteúdo do artigo, que pode não ser relevante para si.

Nesta página

Expandir tudo | Recolher tudo

Sumário

Este artigo descreve como definir e recuperar variáveis de documento usando o Microsoft Word.

Mais Informações

Microsoft fornece exemplos de programação apenas para ilustração, sem garantia expressa ou implícita. Isso inclui, mas não está limitado a, garantias implícitas de comercialização ou adequação para uma finalidade específica. Este artigo presume que você está familiarizados com a linguagem de programação que está sendo demonstrada e com as ferramentas que são usadas para criar e depurar procedimentos. Engenheiros de suporte podem ajudar a explicar a funcionalidade de um determinado procedimento, mas eles não modificarão esses exemplos para fornecer funcionalidades adicionais ou construir procedimentos para atender às suas necessidades.
Para obter mais informações sobre como usar o código de exemplo neste artigo, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft:
212536  (http://support.microsoft.com/kb/212536/EN-US/ ) OFF2000: Como executar o código de exemplo de artigos da Knowledge Base
Você pode usar o Microsoft Visual Basic for Applications variáveis coleção para definir e recuperar o conteúdo de uma variável de seqüência de caracteres em um documento do Word ou o modelo.

Além disso, você pode usar o campo DocVariable para recuperar o valor de uma variável de documento após ele ter sido definido.

Para definir e recuperar o valor de uma variável de documento

A macro de exemplo a seguir usa a propriedade variáveis para armazenar e, em seguida, recuperar o valor de uma variável de seqüência de caracteres chamada "FullName" com o documento atual.

Sub GetSetDocVars()

   Dim fName As String
   fName = "Jeff Smith"
   ' Set contents of variable "fName" in a document using a document
   ' variable called "FullName".
   ActiveDocument.Variables.Add Name:="FullName", Value:=fName
   ' Retrieve the contents of the document variable.
   MsgBox ActiveDocument.Variables("FullName").Value

End Sub
				

Para excluir uma variável de documento

A macro de exemplo a seguir usa a propriedade de variáveis para o primeiro conjunto e recuperar o valor de uma variável de documento e exclua a variável do documento ativo.

Sub GetSetDeleteDocVars()

   Dim fName As String
   fName = "Jeff Smith"
   ' Set contents of variable "fName" in a document using a document
   ' variable called "FullName."
   ActiveDocument.Variables.Add Name:="FullName", Value:=fName
   ' Retrieve the contents of the document variable.
   MsgBox ActiveDocument.Variables("FullName").Value
   ' Delete the variable.
   ActiveDocument.Variables("FullName").Delete

End Sub
				

Para recuperar o valor de uma variável de documento usando o campo DocVariable

A macro de exemplo a seguir usa a propriedade variáveis para definir uma variável de documento. A macro de exemplo a seguir é as etapas para usar o campo DocVariable para recuperar o valor para o conteúdo do mesmo documento.

Sub GetSetDocVars()

   Dim fName As String
   fName = "Jeff Smith"
   ' Set contents of variable "fName" in a document using a document
   ' variable called "FullName."
   ActiveDocument.Variables.Add Name:="FullName", Value:=fName

End Sub
				
Para usar o campo DocVariable, faça o seguinte:

  1. No menu Inserir , clique em campo .
  2. Na lista categorias , clique em Documento automação .
  3. Na lista de Nomes de campos , clique em DocVariable .
  4. Clique na caixa de códigos de campo para que o ponto de inserção é um espaço após a palavra DocVariable .
  5. Entre aspas, digite o nome da variável de documento.

    Exemplo: "FullName"
  6. Clique em OK .
Se você precisar preservar um valor entre as sessões de uma macro, você pode armazenar valores usando qualquer um dos seguintes métodos:

  • Use a propriedade PrivateProfileString para armazenar valores em um arquivo de configurações particular.

    Para obter mais informações sobre a propriedade PrivateProfileString, no Editor do Visual Basic, clique em Ajuda do Microsoft Visual Basic no menu Ajuda , digite Propriedade PrivateProfileString no Assistente do Office ou no Assistente de resposta e, em seguida, clique em Pesquisar para exibir o tópico.
  • Use a propriedade variáveis para armazenar valores em um documento.

    Para obter mais informações sobre a propriedade de variáveis, no Editor do Visual Basic, clique em Ajuda do Microsoft Visual Basic no menu Ajuda , digite propriedade variáveis no Assistente do Office ou no Assistente de resposta e, em seguida, clique em Pesquisar para exibir o tópico.
  • Use o Visual Basic for Applications Entrada/saída instruções para gravar um arquivo de texto (por exemplo, gravar ou Imprimir instruções).

    Para obter mais informações sobre grava dados em arquivos, no Editor do Visual Basic, clique em Ajuda do Microsoft Visual Basic no menu Ajuda , digite Gravar dados para arquivos no Assistente do Office ou no Assistente de resposta e, em seguida, clique em Pesquisar para exibir o tópico.
  • Use o objeto AutoTextEntry para armazenar valores em uma entrada de AutoTexto. Para obter mais informações sobre o objeto AutoTextEntry, no Editor do Visual Basic, clique em Ajuda do Microsoft Visual Basic no menu Ajuda , digite objeto AutoTextEntry no Assistente do Office ou no Assistente de resposta e, em seguida, clique em Pesquisar para exibir o tópico.

Referências

Para obter informações adicionais sobre como obter ajuda com o Visual Basic for Applications, clique nos números abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft:
212623  (http://support.microsoft.com/kb/212623/EN-US/ ) WD2000: Recursos de programação de macro
226118  (http://support.microsoft.com/kb/226118/EN-US/ ) OFF2000: Programação recursos para o Visual Basic for Applications

A informação contida neste artigo aplica-se a:
  • Microsoft Word 2000 Standard Edition
Palavras-chave: 
kbmt kbdtacode kbhowto kbprogramming KB209227 KbMtpt
Tradução automáticaTradução automática
IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine Translation ou MT), não tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em português a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradução automática não é sempre perfeita, podendo conter erros de vocabulário, sintaxe ou gramática. A Microsoft não é responsável por incoerências, erros ou prejuízos ocorridos em decorrência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualizações freqüentes ao software de tradução automática (MT). Obrigado.
Clique aqui para ver a versão em Inglês deste artigo: 209227  (http://support.microsoft.com/kb/209227/en-us/ )