Comment trouver et utiliser la documentation du modèle objet Office

Cet article décrit les ressources et la documentation à votre disposition pour l'automatisation des applications Microsoft Office. Ces informations peuvent être appliquées quel que soit le langage de programmation que vous choisissez pour automatiser une application Office. Cet article explique également comment vous pouvez commencer à écrire le code automation en vous guidant tout au long de la documentation pour obtenir les informations que nécessaires pour accomplir une tâche spécifique grâce à l'automatisation.

Où puis-je trouver la documentation du modèle objet ?

Les modèles d'objet pour les applications Office sont documentées dans référence du langage pour les deux versions de Microsoft Office : Microsoft Office 97 Visual Basic pour Applications de référence du langage
ISBN 1-57231-339-0

Microsoft Office 2000 Visual Basic pour Applications de référence du langage
ISBN 1-57231-955-0.
Les références des langages sont disponibles sur MSDN et dans l'aide en ligne fournie avec Microsoft Office. Ils peuvent également être achetés sous forme imprimée. Pour effectuer une commande, visitez le site : Le tableau suivant répertorie les fichiers d'aide pour chaque application Office.



Les fichiers d'aide fournis avec Microsoft Office 97 sont installés par défaut à : Si vous ne trouvez pas le fichier d'aide de VBA de Office 97 dont vous avez besoin, il n'a probablement pas été installé lorsque vous avez exécuté le programme d'installation de Office 97. Pour installer le fichier d'aide, exécutez le programme d'installation de Office pour ajouter le fichier d'aide de VBA. Notez que le fichier d'aide de VBA Outlook 97 n'est pas installé par le programme d'installation Office. Pour plus d'informations sur l'installation du fichier d'aide de VBA Outlook 97, consultez l'article suivant dans la Base de connaissances Microsoft :Les fichiers d'aide fournis avec Microsoft Office 2000 sont installés par défaut à : Les fichiers d'aide fournis avec Microsoft Office XP sont installés par défaut à :Remarque: le Microsoft Office 2000, Microsoft Office XP, Microsoft Office 2003 programmes d'installation et installent les fichiers d'aide de VBA « sur la première utilisation." Par conséquent, vous ne voyez ne peut-être pas le fichier d'aide dans ce répertoire si vous n'avez pas déjà tenté d'accéder à l'aide de VBA dans l'application Office.

Comment puis-je utiliser la documentation du modèle objet ?

Il existe plusieurs méthodes que vous pouvez utiliser pour trouver la documentation pour une classe spécifique, une méthode ou une propriété :

• Rechercher le fichier d'aide VBA :
  
  Dans Visual Basic Editor pour l'application Office, cliquez sur Sommaire et Index dans le menu aide . Sous l'onglet Sommaire , sélectionnez la référence du langage et cliquez sur affichage. L'aide de VBA pour la référence de langage que vous avez sélectionné s'affiche. À ce stade, vous pouvez utiliser l' Index ou l'onglet Rechercher pour trouver des informations sur une classe spécifique, une méthode ou une propriété.
• Utiliser l'aide contextuelle dans un Module ou dans le volet exécution :
  
  Dans Visual Basic Editor pour l'application Office, tapez la classe, méthode ou propriété dans la fenêtre de code d'un module ou dans la Fenêtre exécution, mettez en surbrillance le texte et appuyez sur la touche F1. La rubrique d'aide de l'élément s'affiche.
• Utilisez l'Explorateur d'objets :
  
  Appuyez sur la touche F2 dans Visual Basic Editor pour l'application Office afficher l' Explorateur d'objets. L' Explorateur d'objets répertorie toutes les classes de que l'application expose des méthodes et les propriétés associées à chaque classe. Pour afficher l'aide sur une classe spécifique ou un membre de classe, sélectionnez dans l'Explorateur d'objets, puis appuyez sur la touche F1.

Comment savoir quelles classes, méthodes et des propriétés à utiliser ?

Si vous n'êtes pas déjà familiarisé avec le modèle objet de l'application que vous souhaitez automatiser, vous pouvez utiliser l'enregistreur de macros de l'application pour avoir une idée. Pour illustrer, supposons que vous souhaitez automatiser Microsoft Word pour ajouter du texte dans un nouveau document, puis enregistrez le document mais vous ne connaissez pas les méthodes et propriétés à utiliser ; Vous pouvez démarrer avec l'enregistreur de Macro :

1. Démarrez Microsoft Word.
2. Cliquez sur Macro dans le menu Outils , puis sélectionnez Nouvelle Macro. Prenez note du nom de la nouvelle macro et cliquez sur OK pour démarrer l'enregistrement.
3. Démarrez un nouveau document.
4. Type un et appuyez sur la touche ENTRÉE.
5. Type deux et appuyez sur la touche ENTRÉE.
6. Type trois.
7. Cliquez sur Enregistrer dans le menu fichier et enregistrez le document en tant que « C:\doc1.doc. »
8. Cliquez sur le bouton Arrêter l'enregistrement (ou cliquez sur Macro dans le menu Outils et sélectionnez Arrêter l'enregistrement).
9. Pour afficher le code VBA généré par l'enregistreur de macros à partir de vos actions, cliquez sur Macro dans le menu Outils , sélectionnez Macros. Sélectionnez le nom de la nouvelle macro dans la liste et cliquez sur Modifier. L'éditeur Visual Basic s'affiche avec la macro enregistrée :

    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
   					

Vous pouvez bénéficier grandement de comprendre comment chaque classe tienne dans le modèle d'objet et l'apprentissage de la description et le type de tous les paramètres pour les méthodes et propriétés que vous utilisez.

Commencez par examiner la première ligne de la macro enregistrée : Documents.Add. Mettez en surbrillance des Documents sur le module de code de la macro enregistré et appuyez sur la touche F1. La rubrique d'aide vous fournit les informations importantes suivantes :

• La propriété « Documents » renvoie une collection de Documents qui représente tous les documents ouverts.
• La propriété « Documents » s'applique à l'objet Application.

Revenir à la macro enregistrée, sélectionnez Ajouter dans le module de code et appuyez sur la touche F1. Une rubrique d'aide expliquant que de nombreux objets différents ont une méthode Add. Cliquez sur Documents pour afficher l'aide de la méthode Add de la collection Documents. La rubrique d'aide vous fournit les informations importantes suivantes :

• « Méthode Ajouter » ajoute un nouveau document vide à la collection de documents ouverts.
• La « méthode ajouter » peut prendre deux arguments, qui sont tous deux facultatifs.

Maintenant examiner la ligne suivante dans la macro enregistrée : Selection.TypeText Text: = « un ». Mettez en surbrillance de sélection sur le module de code et appuyez sur la touche F1 :

• La propriété « Selection » renvoie l'objet Selection qui représente une plage sélectionnée ou le point d'insertion.
• La propriété « sélection » s'applique à l'objet Application.

Revenir à la macro enregistrée, mettez en surbrillance TypeText sur le module de code et appuyez sur la touche F1 :

• La « méthode TypeText » insère le texte spécifié.
• La « méthode TypeText » possède un argument obligatoire de type chaîne.
• La « méthode TypeText » s'applique à l'objet Selection.

Ensuite, consultez la rubrique d'aide pour TypeParagraph:

• « TypeParagraph, méthode » insère un nouveau paragraphe vide.
• « TypeParagraph, méthode » s'applique à l'objet Selection et n'a aucun argument.

Examinez les rubriques d'aide pour la propriété ActiveDocument et la méthode SaveAs :

• La « propriété ActiveDocument » renvoie un objet Document représentant le document ayant le focus. « ActiveDocument » s'applique à l'objet Application.
• La « méthode SaveAs » enregistre un document. Selon la version de Word, cette méthode a à partir de 11 à 16 arguments, seulement un d'eux est requis. « Enregistrer sous » s'applique à un objet Document.

Vous avez peut-être remarqué que la propriété Documents , la propriété de sélection et la propriété ActiveDocument sont toutes des propriétés qui s'appliquent à l'objet Application , mais encore non qualifiées par « Application » dans la macro enregistrée. L'objet Application est l'objet par défaut pour toutes les propriétés et peut donc être omis lorsque vous écrivez du code dans une macro VBA. Ce n'est pas le cas lorsque vous écrivez le code d'automation ; toutes les propriétés et méthodes doivent être complets dans votre code automation.

Après l'examen de la macro enregistrée, vous constatez que la méthode SaveAs a un argument pour lequel il passe la constante intégrée wdFormatDocument. Selon le langage de programmation que vous choisissez pour votre contrôleur automation, vous devrez passer la valeur numérique pour les constantes intégrées. La rubrique d'aide de la méthode SaveAs ne donne pas ces informations, mais vous pouvez le trouver dans l' Explorateur d'objets. Appuyez sur la touche F2 pour afficher l' Explorateur d'objets. Type :

wdFormatDocument

dans la fenêtre de recherche et appuyez sur l'entrée de clé. Dans le volet inférieur de l' Explorateur d'objets, vous voyez l'équivalent numérique de wdFormatDocument(=0) , ainsi que d'autres informations sur la constante.

Où puis-je trouver d'automatisation en exemples de code ?

Les informations présentées jusqu'à présent vous donnent un bon point de départ pour écrire du code d'automation. La Base de connaissances Microsoft est une excellente ressource pour rechercher des exemples de code automation écrits en Visual Basic, Visual C++ et MFC. Voici quelques-unes :

Pour les développeurs Visual Basic

Pour plus d'informations, cliquez sur les numéros ci-dessous pour afficher les articles correspondants de la Base de connaissances Microsoft.

Développeurs Visual C++ (à l'aide de MFC)

Pour plus d'informations, cliquez sur les numéros ci-dessous pour afficher les articles correspondants de la Base de connaissances Microsoft.

Développeurs C/C++ (sans MFC)

Pour plus d'informations, cliquez sur les numéros ci-dessous pour afficher les articles correspondants de la Base de connaissances Microsoft.

Développeurs Visual J ++

Pour plus d'informations, cliquez sur les numéros ci-dessous pour afficher les articles correspondants de la Base de connaissances Microsoft.

Développeurs Visual FoxPro

Pour plus d'informations, cliquez sur les numéros ci-dessous pour afficher les articles correspondants de la Base de connaissances Microsoft.Pour plus d'informations, y compris des exemples de code et de ressources pour l'automatisation de Microsoft Office, visitez le site Web de Microsoft à l'adresse suivante :