DrawingPaths property

Microsoft Visio Developer Reference

DrawingPaths property

   Example   

Gets or sets the paths where Microsoft Visio looks for drawings.

Version added

4.0

Syntax

strRet = object.DrawingPaths
object.DrawingPaths = pathsStr

object

Required. An expression that returns an Application object.

strRet, pathsStr

String. A text string containing a list of folders.

Remarks

To indicate more than one folder, separate individual items in the path string with semicolons.

The string passed to and received from the DrawingPaths property is the same string shown on the File Paths tab in the Options dialog box (click Options on the Tools menu). This string is stored in HKEY_CURRENT_USER\Software\Microsoft\Visio\application\DrawingsPath.

Visio looks for drawings in all paths named in the DrawingPaths property and all the subfolders of those paths. If you pass the DrawingPaths property to the EnumDirectories method, it returns a complete list of fully qualified paths in which Visio looks.

If a path is not fully qualified, Visio looks for the folder in the folder that contains the Visio program files (appObj.Path). For example, if the Visio executable file is installed in c:\Visio, and the DrawingPaths property is "Drawings;d:\Drawings", Visio looks for add-ons in both c:\Visio\Drawings and d:\Drawings.