Como localizar e utilizar a documentação sobre o modelo de objecto do Office

Este artigo descreve os recursos e documentação disponível para automatizar a aplicações do Microsoft Office. Estas informações podem ser aplicadas independentemente da linguagem de programação que escolher para automatizar uma aplicação do Office. Este artigo também ilustra como pode começar a escrever código de automatização, percorrendo a documentação para localizar as informações que necessita de realizar uma tarefa específica através de automatização.

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

Os modelos de objecto para aplicações do Office estão documentados na 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.
As referências de idioma estão disponíveis na MSDN e na ajuda online fornecida com o Microsoft Office. Estes também podem ser adquiridas num formato impresso. Para ordenar informações, visite: A tabela seguinte lista os ficheiros de ajuda para cada aplicação do Office.



Os ficheiros de ajuda fornecidos com o Microsoft Office 97 são instalados por predefinição em: Se não conseguir localizar o ficheiro de ajuda do VBA do Office 97 que necessário, provavelmente não foi instalado quando executou o programa de configuração Office 97 inicialmente. Para instalar o ficheiro de ajuda, execute a configuração do Office para adicionar o ficheiro de ajuda do VBA. Tenha em atenção que o ficheiro de ajuda de VBA do Outlook 97 não é instalado pelo programa de configuração do Office. Para obter informações sobre como instalar o ficheiro de ajuda de VBA do Outlook 97, consulte o seguinte artigo na base de dados de conhecimento da Microsoft: Os ficheiros de ajuda fornecidos com o Microsoft Office 2000 são instalados por predefinição em: Os ficheiros de ajuda fornecidos com o Microsoft Office XP são instalados por predefinição em: Nota : programas O Microsoft Office 2000, Microsoft Office XP e o programa de configuração do Microsoft Office 2003 instalam os ficheiros para ajuda do VBA "no primeira utilização." Por conseguinte, poderá não ver o ficheiro de ajuda existentes neste directório se ter não anteriormente tentou aceder ajuda do VBA na aplicação do Office.

Como posso utilizar a documentação do modelo de objecto?

Existem vários métodos que pode utilizar para localizar documentação para uma classe específica, método ou propriedade:

• Procure o ficheiro de ajuda do VBA:
  
  No Visual Basic Editor da aplicação do Office, clique em índices no menu Ajuda . No separador conteúdo , seleccione a referência de idioma pretendido e clique em Mostrar . É apresentada a ajuda do VBA para a referência de linguagem que seleccionou. Neste ponto, é possível utilizar o índice remissivo ou no separador Localizar para localizar informações sobre uma classe específica, método ou propriedade.
• Utilize ajuda sensível ao contexto de um módulo ou no painel de imediato:
  
  No Visual Basic Editor da aplicação do Office, escreva a classe, método ou propriedade na janela de código de um módulo ou na Janela Immediate , realce o texto e prima a tecla F1. Aparece o tópico de ajuda para o produto.
• Utilize o Object Browser:
  
  Prima a tecla F2 no Editor do Visual Basic da aplicação do Office apresentar o Localizador de objectos . O Object Browser lista todas as classes que expõe a aplicação, métodos e propriedades associadas a cada classe. Para visualizar ajuda numa classe específica ou membro de classe, seleccione-a no localizador de objectos e prima a tecla F1.

Como posso saber que classes, métodos e propriedades para utilizar?

Se não estiver familiarizado com o modelo de objectos da aplicação que pretende automatizar, pode utilizar o gravador de macros da aplicação para ter uma ideia. Para ilustrar, suponha que pretende automatizar o Microsoft Word para adicionar texto a um novo documento e guarde o documento mas não souber os métodos e propriedades para utilizar, pode começar com o gravador de macros:

1. Inicie o Microsoft Word.
2. Clique em ' macro ' no menu Ferramentas e seleccione Gravar nova macro . Tome nota do nome da nova macro e clique em OK para iniciar a gravação.
3. Inicie um novo documento.
4. Escreva um e prima a tecla ENTER.
5. Escreva dois e prima a tecla ENTER.
6. Escreva três .
7. Clique em Guardar no menu ficheiro e guarde o documento como "C:\doc1.doc."
8. Clique no botão Parar Gravação (ou clique em ' macro ' no menu Ferramentas e seleccione Terminar gravação ).
9. Para ver o código VBA que gerou o gravador de macros de suas acções, clique em ' macro ' no menu Ferramentas e seleccione macros . Seleccione o nome da nova macro na lista e clique em Editar . O Editor do Visual Basic é apresentado 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
   					

Pode beneficiar significativamente de compreender como cada classe se ajusta dentro do modelo de objectos e aprender a descrição e tipo de todos os parâmetros para os métodos e propriedades que utiliza.

Iniciar com a primeira linha da macro gravada a examinar: Documents.Add. Realce os documentos no módulo de código para a macro gravado e prima a tecla F1. O tópico de ajuda fornece-lhe as seguintes informações importantes:

• "Propriedades de documentos" devolve um conjunto de documentos que representa todos os documentos abertos.
• "Propriedades de documentos" aplicada ao objecto Application.

Volte a macro gravada, realce Adicionar no módulo de código e prima a tecla F1. Aparece um tópico de ajuda explicando que muitos objectos diferentes têm um método Add. Clique em documentos para ver a ajuda para o método Add da colecção de documentos. O tópico de ajuda fornece-lhe as seguintes informações importantes:

• "Adicionar método" Adiciona um novo documento vazio à colecção de documentos abertos.
• "Adicionar método" pode demorar dois argumentos, sendo que ambos são opcionais.

Agora, examine a linha seguinte na macro gravada: Selection.TypeText Text: = "um". Realce de selecção no módulo de código e prima a tecla F1:

• "Selecção de propriedades" devolve o objecto de selecção que representa um intervalo seleccionado ou o ponto de inserção.
• "Selecção de propriedades" aplicada ao objecto Application.

Volte a macro gravada, realce TypeText no módulo de código e prima a tecla F1:

• O "método TypeText" insere o texto especificado.
• O "método TypeText" tem um argumento obrigatório do tipo cadeia.
• O "método TypeText" aplica-se o objecto da selecção.

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" aplica-se para a selecção e tem sem argumentos.

Examine os tópicos de ajuda para a propriedade ActiveDocument e o método ' Guardar como ' :

• A "propriedade ActiveDocument" devolve um objecto de documento que representa o documento com o foco. "ActiveDocument" aplica-se ao objeto Application.
• O "método de ' Guardar como'" guarda um documento. Dependendo da versão do Word, este método tem de 11 a 16 argumentos, é necessário apenas um deles. "Guardar como" aplica-se a um objecto de documento.

Pode ter reparado que a propriedade de documentos , propriedade Selection e ActiveDocument propriedade estão todas as propriedades que aplicam ao objecto de aplicação mas ainda não são qualificadas com "Aplicações" na macro gravada. O objecto de aplicação é o objecto predefinido para todas as propriedades e, por isso, pode ser omitido ao escrever código numa macro VBA. Isto não é o caso, quando escrever o código de automatização; todas as propriedades e métodos devem ser totalmente qualificados do código de automatização.

Após o exame da macro gravada, verá que o método ' Guardar como ' tem um argumento para o qual transmitir a constante wdFormatDocument incorporado. Dependendo do idioma programação que escolher para o controlador de automatização, poderá ter de passar o valor numérico para as constantes incorporados. O tópico de ajuda para o método ' Guardar como ' não fornecer estas informações mas não pode localizar no Localizador de objectos . Prima a tecla F2 para apresentar o Localizador de objectos . Tipo:

wdFormatDocument

na janela de procura e prima a ENTER chave. No painel inferior do Object Browser , verá o equivalente numérico de wdFormatDocument(=0) , bem como outras informações sobre a constante.

Onde posso encontrar alguns automatização Exemplos de código?

As informações apresentadas até ao momento dá-lhe estabelecer boa base para escrever o código de automatização. A base de dados de conhecimento da Microsoft é um excelente recurso para localizar automatização Exemplos de código escritos no Visual Basic, Visual C++ e o MFC. Seguem-se apenas alguns:

Para programadores do Visual Basic

Para obter mais informações, clique números de artigo que se seguem para visualizar os artigos na base de dados de conhecimento da Microsoft:

Programadores de C++ Visual (utilizando MFC)

Para obter mais informações, clique números de artigo que se seguem para visualizar os artigos na base de dados de conhecimento da Microsoft:

Programadores de C/C ++ (sem MFC)

Para obter mais informações, clique números de artigo que se seguem para visualizar os artigos na base de dados de conhecimento da Microsoft:

Programadores de Visual J ++

Para obter mais informações, clique números de artigo que se seguem para visualizar os artigos na base de dados de conhecimento da Microsoft:

Visual FoxPro programadores

Para obter mais informações, clique números de artigo que se seguem para visualizar os artigos na base de dados de conhecimento da Microsoft: Para obter informações adicionais, incluindo o código de exemplo e recursos para automatizar o Microsoft Office, visite o seguinte Web site da Microsoft: