Método Documents.AddEx (Visio)

Agrega una nueva galería de símbolos o un nuevo dibujo a la colección Documents, al tiempo que permite pasar información adicional en un argumento.

Sintaxis

expresión. AddEx( _FileName_ , _MeasurementSystem_ , _Flags_ , _LangID_ )

Expresión Variable que representa un objeto Documents .

Parameters

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
FileName	Necesario	String	Tipo o nombre de archivo del documento que se va a agregar; Si no incluye una ruta de acceso, Microsoft Visio busca en la carpeta o carpetas designadas en la propiedad TemplatePaths del objeto Application y en todas las plantillas publicadas, incluidas las plantillas de terceros publicadas.
MeasurementSystem	Opcional	VisMeasurementSystem	Unidades de medida que se usarán en el nuevo documento. Vea la sección Comentarios para obtener los posibles valores.
Flags	Opcional	Long	Marcas que muestran cómo se abre el nuevo documento. Vea la sección de comentarios para obtener los posibles valores.
LangID	Opcional	Long	Identificador de idioma del documento. Consulte Comentarios.

Valor devuelto

Document

Observaciones

El método AddEx es similar al método Add, ya que se aplica a la colección Documents, pero difiere en que AddEx proporciona varios argumentos adicionales en los que el llamador puede especificar el modo en que se crean los documentos.

El argumento MeasurementSystem debería ser uno de los miembros siguientes de VisMeasurementSystem, que se declara en la biblioteca de tipos de Visio.

Constante	Valor	Descripción
visMSDefault	0	Elija el sistema métrico o el de EE.UU., dependiendo de las opciones regionales que se hayan definido en el Panel de control.
visMSMetric	1	Sistema métrico.
visMSUS	2	Sistema de EE.UU.

El argumento Flags debería ser una combinación de uno o varios de los miembros siguientes de VisOpenSaveArgs, que se declara en la biblioteca de tipos de Visio.

Constante	Valor	Descripción
visAddDocked	4	Agrega un documento en una ventana acoplada.
visAddHidden	64	Agrega un documento en una ventana oculta.
visAddMacrosDisabled	128	Agrega un documento con las macros deshabilitadas.
visAddMinimized	16	Agrega un documento en una ventana minimizada.
visAddNoWorkspace	256	Agrega un documento sin información del área de trabajo.
visAddStencil	512	Agrega un nuevo archivo de galería de símbolos.

El argumento LangID debe ser uno de los identificadores estándar que usa Windows para codificar versiones de lenguaje diferentes. Por ejemplo, el identificador de idioma es &H0409 para la versión de Visio en inglés de Estados Unidos. Para ver una lista de los identificadores de idioma, busque "VERSIONINFO" en Microsoft Platform SDK en MSDN.

Para crear un dibujo nuevo sin partir de ninguna plantilla, pase una cadena de longitud cero ( "" ) al método AddEx.

Para crear un dibujo nuevo partiendo de una plantilla, pase "nombredeplantilla.vst" al método AddEx. Visio abre galerías de símbolos que forman parte del área de trabajo de la plantilla y copia en el nuevo documento los estilos y demás configuraciones asociadas a la plantilla. Si el nombre del archivo de plantilla no es válido, no se devolverá ningún documento y se generará un error.

Para crear una nueva galería de símbolos sin partir de ninguna otra, pase ("vss").

Para abrir una copia de una galería de símbolos, pase ("nombredegalería.vss").

Para abrir una copia de un dibujo, pase ("nombrededibujo.vsd").

Nota:

Abrir una copia de una galería de símbolos o de un dibujo equivale a seleccionar Abrir como copia en la lista Abrir del cuadro de diálogo Abrir o a usar el método OpenEx con la marca visOpenCopy.

Ejemplo

Esta macro de Microsoft Visual Basic para Aplicaciones (VBA) muestra cómo utilizar el método AddEx para crear un documento basado en la plantilla "BASICD_U.VST" que utiliza las unidades del sistema de medida predeterminado.

Public Sub AddEx_Example() 
 
 Application.Documents.AddEx "BASICD_U.VST", visMSDefault 
 
End Sub

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.