Como localizar e usar a documentação de modelo de objeto do Office

Este artigo descreve os recursos e documentações disponíveis para você para automatizar aplicativos do Microsoft Office. Essas informações podem ser aplicadas independentemente da definição da linguagem de programação que você escolher para automatizar um aplicativo do Office. Este artigo também ilustra como você pode começar escrever código de automação através da execução passo você a documentação para encontrar as informações que você precisa realizar uma tarefa específica por meio de automação.

Onde posso encontrar a documentação do modelo de objeto?

Os modelos de objeto para os aplicativos do Office estão documentados em uma referência de linguagem para ambas as versões do Office: Microsoft Office 97 Visual Basic for Applications Language Reference
ISBN 1-57231-339-0

Microsoft Office 2000 Visual Basic for Applications Language Reference
ISBN 1-57231-955-0.
A referências de idioma estão disponíveis no MSDN e na Ajuda online fornecida com o Microsoft Office. Eles também podem ser adquiridos em formato impresso. Para pedir informações, visite: A tabela a seguir lista os arquivos de Ajuda para cada aplicativo do Office.



Os arquivos de Ajuda que acompanham o Microsoft Office 97 são instalados por padrão em: Se você não conseguir localizar o arquivo de Ajuda do Office 97 VBA que necessário, ele provavelmente não foi instalado quando você inicialmente executou a instalação do Office 97. Para instalar o arquivo de Ajuda, execute a instalação do Office para adicionar o arquivo de ajuda VBA. Observe que o arquivo de ajuda VBA do Outlook 97 não é instalado pela instalação do Office. Para informações sobre como instalar o arquivo de ajuda VBA do Outlook 97, consulte o seguinte artigo na Base de dados de Conhecimento da Microsoft: Os arquivos de Ajuda que acompanham o Microsoft Office 2000 são instalados por padrão em: Os arquivos de Ajuda que acompanham o Microsoft Office são instalados por padrão em: Observação : programas do Microsoft Office 2000, Microsoft Office XP e instalação do Microsoft Office 2003 instalar os arquivos ajuda VBA "no primeiro uso." Portanto, você não pode consulte o arquivo de ajuda nesse diretório se você não anteriormente tentou acessar a Ajuda do VBA no aplicativo do Office.

Como é possível usar a documentação do modelo de objeto?

Há vários métodos que você pode usar para encontrar a documentação para uma classe específica, método ou propriedade:

• Pesquise o arquivo de ajuda VBA:
  
  No Visual Basic Editor do aplicativo do Office, clique em conteúdo e índice no menu Ajuda . Na guia conteúdo , selecione a referência de idioma desejado e clique em Exibir . A Ajuda do VBA para a referência da linguagem escolhida aparece. Neste ponto, você pode usar tanto o índice ou na guia Localizar para localizar informações sobre uma classe específica, método ou propriedade.
• Use ajuda contextual em um módulo ou no Painel imediato:
  
  No Visual Basic Editor do aplicativo do Office, digite a classe, método ou propriedade na janela de código de um módulo ou na Janela imediata , realce o texto e pressione a tecla F1. O tópico da Ajuda para o item é exibido.
• Use o Pesquisador de objetos:
  
  Pressione a tecla F2 no Editor do Visual Basic aplicativo do Office exibir o Pesquisador de objetos . O Pesquisador de objetos lista todas as classes que expõe o aplicativo e os métodos ou propriedades associadas a cada classe. Para exibir a Ajuda em uma classe específica ou um membro da classe, selecione-o no Pesquisador de objetos e pressione a tecla F1.

Como posso saber quais classes, métodos e propriedades para usar?

Se você já não estiver familiarizado com o modelo de objeto do aplicativo que você pretende automatizar, você pode usar o gravador de macro do aplicativo para ter uma idéia. Para ilustrar, suponha que você deseja automatizar o Microsoft Word para adicionar algum texto para um novo documento e, em seguida, salvar o documento, mas você não souber quais métodos e propriedades para usar; você pode iniciar com o gravador de macro:

1. Inicie o Microsoft Word.
2. Clique em macro no menu Ferramentas e clique em Gravar nova macro . Anote o nome da nova macro e clique em OK para iniciar a gravação.
3. Inicie um novo documento.
4. Digite um e pressione a tecla ENTER.
5. Digite dois e pressione a tecla ENTER.
6. Digite três .
7. Clique em Salvar no menu arquivo e salve o documento como "C:\doc1.doc."
8. Clique no botão Parar gravação (ou clique em macro no menu Ferramentas e selecione Parar gravação ).
9. Para exibir o código VBA que gerou o gravador de macro de suas ações, clique em macro no menu Ferramentas e selecione macros . Selecione o nome da nova macro na lista e clique em Editar . O Editor do Visual Basic aparece com a macro gravada:

    Documents.Add
    Selection.TypeText Text:="one"
    Selection.TypeParagraph
    Selection.TypeText Text:="two"
    Selection.TypeParagraph
    Selection.TypeText Text:="three"
    ActiveDocument.SaveAs FileName:="Doc1.doc", FileFormat:=wdFormatDocument,_
      LockComments:=False, Password:="", AddToRecentFiles:=True, _ 
      WritePassword:="", ReadOnlyRecommended:=False, _
      EmbedTrueTypeFonts:=False, SaveNativePictureFormat:=False, _
      SaveFormsData:=False, SaveAsAOCELetter:= False
   					

Você pode se beneficiar bastante dos Noções básicas sobre como cada classe ajusta o modelo de objeto e aprender a descrição e o tipo de todos os parâmetros para os métodos e propriedades que você usar.

Iniciar com examinando a primeira linha da macro gravada: Documents.Add. Realce documentos no módulo de código para a macro gravado e pressione a tecla F1. O tópico da Ajuda fornece importantes informações a seguir:

• "Propriedade de documentos" retorna uma coleção documentos representando todos os documentos abertos.
• O "propriedade de documentos" se aplica ao objeto Application.

Retornar para a macro gravada, realce Adicionar no módulo de código e pressione a tecla F1. Um tópico da Ajuda será exibida explicando que muitos objetos diferentes têm um método Add. Clique em documentos para ver a Ajuda para o método Add da coleção Documents. O tópico da Ajuda fornece importantes informações a seguir:

• "Adicionar método" adiciona um novo documento vazio à coleção de documentos abertos.
• "Adicionar método" pode levar dois argumentos, dos quais são opcionais.

Agora examine a próxima linha na macro gravada: Selection.TypeText Text: = "um". Realce a seleção no módulo de código e pressione a tecla F1:

• "Propriedade de seleção" retorna o objeto Selection que representa um intervalo selecionado ou o ponto de inserção.
• O "propriedade de seleção" se aplica ao objeto Application.

Retornar para a macro gravada, realce TypeText no módulo de código e pressione a tecla F1:

• O "Método TypeText" insere o texto especificado.
• O "Método TypeText" tem um argumento necessário do tipo String.
• O "Método TypeText" se aplica ao objeto Selection.

Em seguida, consulte o tópico de Ajuda para TypeParagraph :

• O "Método TypeParagraph" insere um novo parágrafo em branco.
• O "Método TypeParagraph" se aplica ao objeto Selection e não possui argumentos.

Examine os tópicos da Ajuda para a propriedade ActiveDocument e o método SaveAs :

• "Propriedade ActiveDocument" retorna um objeto Document que representa o documento com o foco. "ActiveDocument" se aplica ao objeto Application.
• O "método SaveAs" salva um documento. Dependendo da versão do Word, esse método tem de 11 a 16 argumentos, somente uma delas é necessária. "Salvar como" se aplica a um objeto de documento.

Talvez você tenha notado que a propriedade Documents , a propriedade Selection e a propriedade ActiveDocument são todas as propriedades aplicadas ao objeto Application , mas ainda não são qualificadas com "Aplicativo" na macro gravada. O objeto Application é o objeto padrão para todas as propriedades e, portanto, pode ser omitido ao escrever código em uma macro VBA. Isso não é o caso, ao escrever código de automação; todas as propriedades e métodos devem ser totalmente qualificados no seu código de automação.

Ao exame da macro gravada, você verá que o método SaveAs tem um argumento para o qual ele passa a constante interna wdFormatDocument . Dependendo da linguagem de programação que você escolher para seu controlador de automação, talvez seja necessário passar o valor numérico para constantes internas. O tópico da Ajuda para o método SaveAs não fornece essas informações e você pode localizá-lo no Pesquisador de objetos . Pressione a tecla F2 para exibir o Pesquisador de objetos . Tipo:

wdFormatDocument

Na janela de pesquisa e pressione ENTER a chave. No painel inferior do Pesquisador de objetos , você vê o equivalente numérico do wdFormatDocument(=0) , bem como outras informações sobre a constante.

Onde posso encontrar alguns automação amostras de código?

As informações apresentadas até agora oferece boa base para escrever código de automação. Base de dados de Conhecimento é um excelente recurso para localizar automação amostras de código escritas em Visual Basic, Visual C++ e MFC. Aqui estão apenas alguns:

Para desenvolvedores de Visual Basic

Para obter mais informações, clique nos números abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft:

Desenvolvedores em Visual C++ (usando o MFC)

Para obter mais informações, clique nos números abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft:

Desenvolvedores de C/C ++ (sem MFC)

Para obter mais informações, clique nos números abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft:

Desenvolvedores de Visual J ++

Para obter mais informações, clique nos números abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft:

Visual FoxPro desenvolvedores

Para obter mais informações, clique nos números abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft: Para obter informações adicionais, incluindo código de exemplo e recursos para automatizar o Microsoft Office, visite o seguinte site: