Artigo: 209227 - Última revisão: quarta-feira, 11 de Outubro de 2006 - Revisão: 3.2

WD2000: Como guardar e obter 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 | Reduzir tudo

Sumário

Este artigo descreve como definir e obter variáveis de documento utilizando o Microsoft Word.

Mais Informação

A Microsoft fornece exemplos de programação apenas, para fins sem garantia expressa ou implícita. Isto inclui, mas não está limitado a, as garantias implícitas de comercialização ou adequação a um fim específico. Este artigo pressupõe que está familiarizado com a linguagem de programação apresentada e as ferramentas que são utilizadas para criar e depurar procedimentos. Os técnicos de suporte da Microsoft podem ajudar a explicar a funcionalidade de um determinado procedimento, mas não modificarão estes exemplos para proporcionarem funcionalidades adicionais nem criarão procedimentos adaptados às necessidades específicas do utilizador.
Para mais informações sobre como utilizar o código de exemplo neste artigo, clique no número de artigo existente abaixo para visualizar o artigo na base de dados de conhecimento da Microsoft:
212536  (http://support.microsoft.com/kb/212536/EN-US/ ) OFF2000: Como executar códigos de exemplo a partir de artigos da base de dados de conhecimento da Microsoft
Pode utilizar o Microsoft Visual Basic for Applications variáveis colecção para definir e obter o conteúdo de uma cadeia variável num documento ou modelo.

Além disso, pode utilizar o campo DocVariable para obter o valor de uma variável de documento depois tiver sido definido.

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

A macro de exemplo seguinte utiliza a propriedade variáveis para armazenar e, em seguida, obter o valor de uma variável de cadeia denominado "FullName" com o documento actual.

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 eliminar uma variável de documento

A macro de exemplo seguinte utiliza a propriedade variáveis para o primeiro conjunto e obter o valor de uma variável de documento e elimine a variável do documento activo.

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 obter o valor de uma variável de documento utilizando o campo DocVariable

A macro de exemplo seguinte utiliza a propriedade variáveis para definir uma variável de documento. A macro de exemplo a seguir é passos para utilizar o campo DocVariable para obter o valor no 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 utilizar o campo DocVariable, efectue o seguinte:

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

    Exemplo: "FullName"
  6. Clique em OK .
Se necessitar de manter um valor entre sessões de uma macro, pode armazenar valores utilizando qualquer um dos seguintes métodos:

  • Utilize a propriedade PrivateProfileString para armazenar valores para um ficheiro de definições privada.

    Para obter mais informações sobre a propriedade PrivateProfileString, no Editor do Visual Basic, clique em Ajuda do Microsoft Visual Basic no menu Ajuda , escreva Propriedade PrivateProfileString na Assistente do Office ou no Assistente de respostas e, em seguida, clique em Procurar para visualizar o tópico.
  • Utilize a propriedade variáveis para armazenar valores de um documento.

    Para mais informações sobre a propriedade de variáveis, no Editor do Visual Basic, clique em Ajuda do Microsoft Visual Basic no menu Ajuda , escreva variáveis de propriedade na Assistente do Office ou no Assistente de respostas e, em seguida, clique em Procurar para visualizar o tópico.
  • Utilizar o Visual Basic para aplicações de Entrada/saída instruções para escrever um ficheiro de texto (por exemplo, escrever ou Imprimir declarações).

    Para mais informações sobre como escrever dados para ficheiros, no Editor do Visual Basic, clique em Ajuda do Microsoft Visual Basic no menu Ajuda , escreva a escrever dados para ficheiros na Assistente do Office ou no Assistente de respostas e, em seguida, clique em Procurar para visualizar o tópico.
  • Utilize o objecto de entrada de texto automático para armazenar valores no movimento de texto automático. Para obter mais informações sobre o objecto de entrada de texto automático, no Editor do Visual Basic, clique em Ajuda do Microsoft Visual Basic no menu Ajuda , escreva o objecto de entrada de texto automático na Assistente do Office ou no Assistente de respostas e, em seguida, clique em Procurar para visualizar o tópico.

Referências

Para obter informações adicionais sobre como obter ajuda com o Visual Basic for Applications, clique os números de artigo existente abaixo para visualizar 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: Recursos de programação do 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 revisto ou traduzido por humanos. A Microsoft tem artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais. O objectivo é simples: oferecer em Português a totalidade dos artigos existentes na base de dados do suporte. Sabemos no entanto que a tradução automática não é sempre perfeita. Esta pode conter erros de vocabulário, sintaxe ou gramática? erros semelhantes aos que um estrangeiro realiza ao falar em Português. A Microsoft não é responsável por incoerências, erros ou estragos realizados na sequência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza actualizações frequentes 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/ )