Méthode Documents.AddEx (Visio)
Ajoute un nouveau gabarit ou dessin à la collection Documents, tout en autorisant la transmission d'informations supplémentaires à un argument.
Syntaxe
expression. AddEx( _FileName_ , _MeasurementSystem_ , _Flags_ , _LangID_ )
Expression Variable qui représente un objet Documents .
Paramètres
| Nom | Requis/Facultatif | Type de données | Description |
|---|---|---|---|
| FileName | Obligatoire | String | Type ou nom de fichier du document à ajouter ; Si vous n’incluez pas de chemin d’accès, Microsoft Visio recherche le ou les dossiers désignés dans la propriété TemplatePaths de l’objet Application et tous les modèles publiés, y compris les modèles tiers publiés. |
| Système de mesure | Facultatif | VisMeasurementSystem | Unités de mesure à utiliser dans le nouveau document. Reportez-vous aux notes pour les valeurs possibles. |
| Flags | Facultatif | Long | Indicateurs indiquant comment ouvrir le nouveau document. Reportez-vous aux notes pour les valeurs possibles. |
| LangID | Facultatif | Long | ID de langue pour le document. Voir les remarques. |
Valeur renvoyée
Document
Remarques
La méthode AddEx est identique à la méthode Add si elle s'applique à la collection Documents, à la différence que AddEx fournit plusieurs arguments supplémentaires dans lesquels l'appelant peut indiquer comment le document doit être créé.
L'argument SystèmeMesure doit être l'un des membres suivants de VisMeasurementSystem déclaré dans la bibliothèque de types de Visio.
| Constante | Valeur | Description |
|---|---|---|
| visMSDefault | 0 | Choisit le système métrique ou américain en fonction des options régionales définies dans le Panneau de configuration. |
| visMSMetric | 1 | Système de mesure métrique. |
| visMSUS | 2 | Système de mesure en unités américaines. |
L'argument Indicateurs doit être une combinaison d'un ou plusieurs des membres suivants de VisOpenSaveArgs déclaré dans la bibliothèque de types de Visio.
| Constante | Valeur | Description |
|---|---|---|
| visAddDocked | 4 | Ajoute un document dans une fenêtre fixe. |
| visAddHidden | 64 | Ajoute un document dans une fenêtre masquée. |
| visAddMacrosDisabled | 128 | Ajoute un document avec des macros désactivées. |
| visAddMinimized | 16 | Ajoute un document dans une fenêtre réduite. |
| visAddNoWorkspace | 256 | Ajoute un document sans aucune information d'espace de travail. |
| visAddStencil | 512 | Ajoute un nouveau fichier de gabarit. |
L’argument LangID doit être l’un des ID standard utilisés par Windows pour encoder différentes versions de langage. Par exemple, l'ID de langue est &H0409 pour la version américaine de Visio. Pour voir une liste des ID de langue, recherchez « VERSIONINFO » dans le Kit de développement Platform SDK de Microsoft sur le site Web MSDN.
Pour créer un dessin qui ne soit basé sur aucun modèle, transmettez une chaîne de longueur nulle ("") à la méthode AddEx.
Pour créer un dessin basé sur un modèle, transmettez la valeur « templatename.vst » à la méthode AddEx. Visio ouvre les gabarits faisant partie de l'espace de travail du modèle et copie les styles et les autres paramètres associés au modèle dans le nouveau document. Si le nom de fichier du modèle n'est pas valide, aucun document n'est renvoyé et une erreur est générée.
Pour créer un nouveau gabarit basé sur aucun modèle, transmettez (« vss »).
Pour ouvrir une copie d'un gabarit, transmettez (« stencilname.vss »).
Pour ouvrir une copie d'un dessin, transmettez (« drawingname.vsd »).
Remarque
Ouvrir une copie d’un gabarit ou d’un dessin revient à sélectionner l’option Ouvrir en tant que copie de la liste Ouvrir de la boîte de dialogue Ouvrir ou à utiliser la méthode OpenEx avec l’indicateur visOpenCopy.
Exemple
Cette macro Microsoft Visual Basic pour Applications (VBA) indique comment utiliser la méthode AddEx pour créer un document basé sur le modèle « BASICD_U.VST » qui utilise les unités du système de mesure par défaut.
Public Sub AddEx_Example()
Application.Documents.AddEx "BASICD_U.VST", visMSDefault
End Sub
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.