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

Résumé

Cet article décrit les ressources et la documentation à votre disposition pour automatiser les 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 d’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.

Plus d'informations

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

Les modèles d’objet pour les applications Office sont documentés dans une référence de 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 :

http://mspress.microsoft.com

Le tableau suivant répertorie les fichiers d’aide pour chaque application Office.

Application97 (ou version 8.0)Version 2000 (ou 9.0)Version 2002 (ou 10)Version 2003 (ou 11)
OfficeVbaoff8.hlpVbaoff9.chmVbaof10.chmVbaof11.chm
AccèsAcvba80.hlpAcmain9.chmAcmain10.chm, Vbaac10.chmACMAIN11.chm,VBAAC10.chm
ExcelVbaXl8.hlpVbaxl9.chmVbaxl10.chmVBAXL10.chm
MapPointN/AMappoint.chm (ver.2001)Mappoint.chmMAPPOINT.chmn (version 2004)
OutlookVbaoutl.hlpVbaoutl9.chmVbaol10.chmVBAOL11.chm
PowerPointVbappt.hlpVbappt9.chmVbapp10.chmVBAPP10.chm
WordVbawrd8.hlpVbawrd9.chmVbawd10.chmVBAWD10.chm
GraphiqueVbagrp8.hlpVbagrp9.chmVbagr10.chmVBAGR10.chm
FrontPageN/AVbafp4.chm, Vbafpom4.chmVbafpd10.chm, vbafpw10.chmVBAFPD10.chm, VBAFPW10.chm
ClasseurVbabdr8.hlpVbabdr8.hlpAbandonné


Les fichiers d’aide fournis avec Microsoft Office 97 sont installés par défaut à :
C:\Program Files\Microsoft Office\Office
Si vous ne trouvez pas le fichier d’aide de VBA de Office 97 dont vous avez besoin, il probablement ne était pas installé lorsque vous avez initialement 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 :
166738 OL97 : comment faire pour installer l’aide de Visual Basic

Les fichiers d’aide fournis avec Microsoft Office 2000 sont installés par défaut à :
C:\Program Files\Microsoft Office\Office\1033
Les fichiers d’aide fournis avec Microsoft Office XP sont installés par défaut à :

C:\Program Files\Microsoft Office\Office10\1033
C:\Program Files\Microsoft Office\Office11\1033
REMARQUE: les programmes d’installation de Microsoft Office 2003, Microsoft Office XP et 2000 de Microsoft Office l’installent les fichiers d’aide de VBA « à la première utilisation. » Par conséquent, vous ne voyiez 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 des informations 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 de la langue souhaitée, puis sur affichage. L’aide de VBA pour la référence de langue 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 la fenêtre exécution :

    Dans Visual Basic Editor pour l’application Office, tapez la classe, une méthode ou une 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 pour l’élément s’affiche.
  • Utilisez l’Explorateur d’objets :

    Appuyez sur la touche F2 pour l’application Office afficher l' Explorateur d’objetsdans l’éditeur de Visual Basic. L' Explorateur d’objets répertorie toutes les classes de que l’application expose les méthodes ou les propriétés associées à chaque classe. Pour afficher l’aide sur une classe spécifique ou un membre de classe, sélectionnez-la dans l’Explorateur d’objets, puis appuyez sur la touche F1.

Comment connaître les classes, les méthodes et les 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 vous faire une idée. Pour illustrer, supposons que vous souhaitez automatiser Microsoft Word pour ajouter du texte dans un nouveau document et enregistrez le document, mais vous ne connaissez pas les méthodes et les 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, puis cliquez sur OK pour commencer l’enregistrement.
  3. Démarrer un nouveau document.
  4. Tapez un et appuyez sur la touche ENTRÉE.
  5. Tapez deux et appuyez sur la touche ENTRÉE.
  6. Tapez 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 et sélectionnez Macros. Sélectionnez le nom de la nouvelle macro dans la liste et cliquez sur Modifier. L’éditeur de 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 considérablement comprendre comment chaque catégorie s’adapte au sein du modèle d’objet et l’apprentissage de la description et le type de tous les paramètres pour les méthodes et les propriétés que vous utilisez.

Commencent par l’analyse de la première ligne de la macro enregistrée : Documents.Add. Mettez en surbrillance les Documents sur le module de code de la macro enregistré et appuyez sur la touche F1. La rubrique d’aide vous fournit les informations suivantes :

  • La propriété « Documents » renvoie une collection 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 voir l’aide de la méthode Add de la collection Documents. La rubrique d’aide vous fournit les informations suivantes :


  • La « 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 la 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:

  • La « méthode TypeParagraph » insère un nouveau paragraphe vide.
  • La « méthode TypeParagraph » s’applique à l’objet Selection et n’a aucun argument.
Examinez les rubriques d’aide de la propriété ActiveDocument et la méthode SaveAs :
  • La propriété ActiveDocument « » renvoie un objet Document représentant le document qui a le focus. « ActiveDocument » s’applique à l’objet Application.
  • La « méthode SaveAs » enregistre un document. Selon la version de Word, cette méthode est de 11 à 16 arguments, seulement un d’eux est requis. « Enregistrer sous » s’applique à un objet Document.
Vous avez peut-être remarqué que les Documents , propriété, propriété Selection et propriété ActiveDocument sont toutes les propriétés qui s’appliquent à l’objet Application , mais encore ne sont pas 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 par conséquent être omis lors de l’écriture de code dans une macro VBA. Ce n’est pas le cas lors de l’écriture du code d’automation ; toutes les propriétés et les méthodes doivent être complets dans votre code automation.

Après l’examen de la macro enregistrée, vous voyez 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 de l’une des constantes intégrées. La rubrique d’aide de la méthode SaveAs ne donne pas cette information, mais vous pouvez le trouver dans l' Explorateur d’objets. Appuyez sur la touche F2 pour afficher l' Explorateur d’objets. Tapez

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 relatives à la constante.

Références

Où puis-je trouver certains automation en exemples de code ?


Les informations présentées jusqu'à présent vous donnent un bon point de départ pour l’écriture de code d’automation. La Base de connaissances Microsoft est une excellente ressource pour trouver les exemples de code automation écrits en Visual Basic, Visual C++ et MFC. Voici quelques :

Pour les développeurs de Visual Basic

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

220595 comment automatiser Outlook à l’aide de Visual Basic

219151 comment faire pour automatiser Microsoft Excel à partir de Visual Basic

147650 comment naviguer dans les objets Excel à partir de Visual Basic

142387 comment créer l’automatisation d’Excel graphique w/OLE à partir de Visual Basic

184974 comment utiliser l’automation (OLE) avec Word

220607 comment faire pour automatiser Microsoft Word pour effectuer une fusion et publipostage à partir de Visual Basic

222929 comment automatiser PowerPoint à l’aide de Visual Basic dans Office 2003, Office XP Developer et dans Office 2000 Developer

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

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

178749 comment faire pour créer un projet automation à l’aide de MFC et une bibliothèque de types

179706 comment utiliser MFC pour automatiser Excel et créer et formater un nouveau classeur

186120 comment utiliser MFC pour automatiser Excel et remplir une plage avec un tableau

186122 comment faire pour utiliser MFC pour automatiser Excel 2000 et Excel 2002 et obtenir une matrice à partir d’une plage dans Excel 2000 et Excel 2002

220911 comment automatiser Microsoft Word pour effectuer un publipostage à l’aide de Visual C++ et MFC

222960 comment automatiser PowerPoint à l’aide de Visual C++ 5.0 ou Visual C++ 6.0 avec le Microsoft Foundation Classes

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

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

216686 comment automatiser Excel à partir de C++ sans utiliser MFC ou #import

181473 comment utiliser OLE Automation à partir d’une application C plutôt que de C++

Développeurs Visual J ++

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

219430 comment créer/mettre en forme un classeur Excel à l’aide d’automation Visual J ++

215484 comment automatiser PowerPoint à l’aide de Visual J ++ 6.0


Développeurs Visual FoxPro

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

142193 comment utiliser OLE Automation pour ajouter des données à une feuille de calcul Excel

180901 la création d’une table par catégorie dans Word 97 ou Office Word 2003 à partir de Visual FoxPro pour Windows 5.0 et versions ultérieures

181926 comment automatiser la fusion et le publipostage dans Word à l’aide de OLE et ODBC

194306 comment faire impression en duplex par l’utilisation de OLE automation à partir de Visual FoxPro

230154 comment automatiser PowerPoint à l’aide de Visual FoxPro

241942 comment éviter l’erreur d’impression Word avec BackgroundPrintingStatus, propriété

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 :

Propriétés

ID d'article : 222101 - Dernière mise à jour : 9 janv. 2017 - Révision : 1

Commentaires