Documents.OpenEx method (Visio)

Opens an existing Microsoft Visio file, using extra information passed in as an argument.


expression.OpenEx (FileName, Flags)

expression A variable that represents a Documents object.


Name Required/Optional Data type Description
FileName Required String The name of the file to open.
Flags Required Integer Flags that indicate how to open the file.

Return value



The OpenEx method is identical to the Open method, except that it provides an extra argument in which the caller can specify how the document opens.

The Flags argument should be a combination of zero or more of the following values.

Constant Value
visOpenCopy &H1
visOpenRO &H2
visOpenDocked &H4
visOpenDontList &H8
visOpenMinimized &H10
visOpenRW &H20
visOpenHidden &H40
visOpenMacrosDisabled &H80
visOpenNoWorkspace &H100

If visOpenDocked is specified, the file appears in a docked rather than an MDI window, provided that the file is a stencil file and there is an active drawing window in which to put the docked stencil window.

If visOpenDontList is specified, the name of the opened file does not appear in the list of recently opened documents in the Recent Documents list on the Recent tab (click the File tab, and then click Recent).

If visOpenMinimized is specified, the file opens minimized; it is not active. This flag is not supported in versions of Visio earlier than 5.0b.

If visOpenMacrosDisabled is specified, the file opens with Visual Basic macros disabled. This flag is not supported in versions earlier than Visio 2002.

If visOpenHidden is specified, the file opens in a hidden window.

If visOpenNoWorkspace is specified, the file opens with no workspace information.

If your Visual Studio solution includes the Microsoft.Office.Interop.Visio reference, this method maps to the following types:

  • Microsoft.Office.Interop.Visio.IVDocuments.OpenEx(string, short)


This Microsoft Visual Basic for Applications (VBA) macro shows how to use the OpenEx method to open a copy of a stencil file in Visio.

Public Sub OpenEx_Example()  
    'Use the OpenEx method to open a copy of a stencil.  
    Documents.OpenEx "Basic_U.vss", visOpenDocked + visOpenCopy  
End Sub

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.