Méthode Documents.AddEx (Visio)

Article
04/07/2023

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.

Share via