Método Documents.AddEx (Visio)

Adiciona um novo estêncil ou desenho à coleção Documents, permitindo que informações extra sejam passadas em um argumento.

Sintaxe

expression. AddEx( _FileName_ , _MeasurementSystem_ , _Flags_ , _LangID_ )

Expressão Uma variável que representa um objeto Documents .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
FileName	Obrigatório	String	O tipo ou nome do arquivo do documento a ser adicionado; se você não incluir um caminho, o Microsoft Visio pesquisará a pasta ou pastas designadas na propriedade TemplatePaths do objeto Application e todos os modelos publicados, incluindo modelos de terceiros publicados.
MeasurementSystem	Opcional	VisMeasurementSystem	As unidades de medida a serem usadas no novo documento. Consulte Comentários para valores possíveis.
Flags	Opcional	Long	Sinalizadores que indicam como abrir o novo documento. Consulte Comentários para valores possíveis.
LangID	Opcional	Long	A identificação de idioma do documento. Consulte os comentários.

Valor de retorno

Documento

Comentários

O método AddEx é semelhante ao método Add pois se aplica à coleção Documents, exceto por AddEx fornecer vários argumentos adicionais nos quais o chamador pode especificar como o documento é criado.

O argumento MeasurementSystem deve ser um dos seguintes membros do VisMeasurementSystem, declarado na biblioteca de tipos do Visio.

Constant	Valor	Descrição
visMSDefault	0	Escolher métrico ou americano dependendo das opções regionais definidas no Painel de Controle.
visMSMetric	1	Sistema de medida métrico.
visMSUS	2	Sistema de medidas de unidades americanas.

O argumento Flags deve ser uma combinação de um ou mais dos seguintes membros de VisOpenSaveArgs, declarado na biblioteca de tipos do Visio.

Constant	Valor	Descrição
visAddDocked	4	Adiciona um documento em uma janela encaixada.
visAddHidden	64	Adiciona um documento em uma janela oculta.
visAddMacrosDisabled	128	Adiciona um documento com as macros desabilitadas.
visAddMinimized	16	Adiciona um documento em uma janela minimizada.
visAddNoWorkspace	256	Adiciona um documento sem informações de espaço de trabalho.
visAddStencil	512	Adiciona um novo arquivo de estêncil.

O argumento LangID deve ser uma das IDs padrão usadas pelo Windows para codificar diferentes versões de idioma. Por exemplo, a identificação de idioma é &H0409 para a versão americana do Visio. Para exibir uma lista de identificações de idioma, pesquise "VERSIONINFO" no SDK da plataforma Microsoft no MSDN.

Para criar um novo desenho não baseado em modelos, passe uma sequência de caracteres de comprimento zero ("") para o método AddEx.

Para criar um novo desenho baseado em um modelo, passe "templatename.vst" para o método AddEx. O Visio abre estênceis que são parte do espaço de trabalho do modelo e copia estilos e outras configurações associadas ao modelo para o novo documento. Se o nome de arquivo do modelo for inválido, nenhum documento será retornado e será gerado um erro.

Para criar um novo estêncil não baseado em estênceis, passe ("vss").

Para abrir uma cópia de um estêncil, passe ("stencilname.vss").

Para abrir uma cópia de um desenho, passe ("drawingname.vsd").

Observação

Abrir uma cópia de um estêncil ou desenho equivale a selecionar Abrir como Cópia na listagem Abrir da caixa de diálogo Abrir ou usar o método OpenEx com o sinalizador visOpenCopy.

Exemplo

Esta macro do Microsoft Visual Basic for Applications (VBA) mostra como usar o método AddEx para criar um documento baseado no modelo "BASICD_U.VST", que usa as unidades do sistema de medidas padrão.

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

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.