Embed a Visio Viewer 2003 Control in a Web Page
Microsoft Corporation
September 2004
Applies to:
Microsoft Office Visio 2003
Summary: Share Microsoft Visio drawings by embedding a Visio Viewer control in a Web page and using Microsoft Internet Explorer to view, print, and share these drawings. (6 printed pages)
Download Microsoft Office Visio Viewer 2003.
Contents
Overview
Requirements and Limitations
Embedding a Visio Viewer Control in a Web Page
Additional Resources
Overview
With Microsoft Office Visio Viewer 2003, you can use Microsoft Internet Explorer 5.0 or later to view, print, and share drawings created in Microsoft Office Visio 2003 or earlier versions that are saved in the native Visio file format (.vsd or .vdx)—even if you and your team members don't have Visio installed on your computers.
Important If you are using Visio Viewer 2002, you cannot view drawings created in Visio 2003, although you can view drawings created in Visio 2002 or earlier versions. To view Visio 2003 drawings, you must use Visio Viewer 2003.
For example, with Visio Viewer you can
- Send a Visio drawing as an e-mail attachment, and the recipients can open, view, and print the drawing using Visio Viewer
- Post Visio drawings on an intranet site, and anyone can view and print the drawings with Visio Viewer
- Incorporate Visio drawings into a Web page in their native Visio file format, which allows your audience to view custom properties saved with shapes
This article addresses the third example: incorporating a Visio drawing into a Web page in its native Visio file format. With Visio Viewer, you can embed a Visio Viewer control in a Web page, and then specify object parameters, such as the drawing you want to display and the color of the background.
Note You can also share Visio drawings by saving them in popular graphic formats, such as GIF or JPG; however, the native Visio file format is a higher-quality graphic format. Using the Visio Viewer with the native format allows your audience to view custom properties saved with shapes, something they couldn't do otherwise.
To obtain more information about using Visio Viewer
- Install Visio Viewer.
- On your Web browser's File menu, click Open, and then open a Visio drawing.
- Right-click on the drawing page, and then click Help to view the online Help.
- In the contents pane, select the topic "Use Microsoft Visio and Microsoft Visio Viewer on the Same Computer."
Requirements and Limitations
Visio Viewer works on a variety of operating systems and supports two Visio file types, but it also has several limitations. For example, Visio Viewer doesn't display Visio stencils, rulers, guides, and guide points because these elements aren't necessary in a view-only mode.
Visio file types
You can open the following Visio file types with Visio Viewer 2003:
- Visio drawing format (.vsd) saved using Visio 5.0, 2000, 2002, or 2003.
- Visio XML drawing format (.vdx) saved using Visio 2002 or 2003.
**Note **The Visio Viewer can display embedded DWG or DXF CAD drawings included in Visio drawings. However, it can't display embedded DGN CAD drawings.
Operating systems
Visio Viewer 2003 works on the following operating systems:
- Microsoft Windows XP
- Windows 2000 (Service Pack 2)
- Windows Millennium Edition
- Windows 98 Second Edition
- Windows NT 4.0 (Service Pack 6 or later)
Limitations
Visio Viewer doesn't support the following features:
- Rotated pages (pages are shown without rotation)
- More than one hyperlink included with a shape (the default hyperlink is used)
- Hyperlinks included with the drawing page
- Drawing page properties
**Note **Custom fill styles, line styles, and some line ends in Visio drawings may not look the same in the Visio Viewer as they do in Visio.
Embedding a Visio Viewer Control in a Web Page
With Visio Viewer, you can embed a Visio Viewer control in a Web page by manually inserting the tags and parameters in the Web page's source code or, in some cases, by inserting it through your application's user interface, as you can with Microsoft FrontPage. Using either method, you embed a Visio Viewer control the same way you embed any other control.
Visio Viewer includes the sample file Sample.htm, which is a Web page with an embedded Visio Viewer control and a reference to a Visio drawing. Sample.htm is located in the Visio Viewer folder (drive:\\Program Files\Microsoft Office\Visio Viewer). The following block of source code shows how to insert a Visio Viewer control and set parameters manually:
<!--
To install the Visio Viewer automatically when a user views your
Web page, you can set the value of the codebase attribute to
a download location as shown in this example:
<object classid="clsid:279D6C9A-652E-4833-BEFC-312CA8887857"
codebase="http://download.microsoft.com/download/visiostandard2002/
vview10/1/w982kmexp/en-us/vviewer.exe" id="viewer1" width="100%"
height="100">
-->
<object classid="clsid:279D6C9A-652E-4833-BEFC-312CA8887857"
id="Viewer1" width="792" height="524">
<param name="BackColor" value="16777120">
<param name="AlertsEnabled" value="1">
<param name="ContextMenuEnabled" value="1">
<param name="GridVisible" value="1">
<param name="HighQualityRender" value="1">
<param name="PageColor" value="16777215">
<param name="PageVisible" value="1">
<param name="PropertyDialogEnabled" value="1">
<param name="ScrollbarsVisible" value="1">
<param name="ToolbarVisible" value="1">
<param name="SRC" value="sample1.vdx">
<param name="CurrentPageIndex" value="1">
<param name="Zoom" value="-1">
</object>
Note You must have Visio Viewer 2002 or 2003 installed to use this code.
Parameter descriptions
Table 1 includes all of the parameters you can set for a Visio Viewer control and a description of each parameter.
Table 1. Parameter descriptions
Parameter | Description |
---|---|
AlertsEnabled | Enables warning or alert dialog boxes to show when an error occurs. |
BackColor | Sets the background color for the control. Specify an integer value. |
ContextMenuEnabled | Enables the context menu to show on right-mouse events. |
CurrentPageIndex | Specifies the page displayed when the Visio Viewer opens the drawing.
Use the index of the page you want to display (for example, 1 for Page-1, 2 for Page-2, and so on). If you don't specify a page index or you set the value to 0, the Visio Viewer displays the page that was showing the last time you saved the drawing. |
Cx | Sets the X location in the container (for example, Web page; some containers ignore this). |
Cy | Sets the Y location in the container (some containers ignore this). |
GridVisible | Displays the grid if the drawing page is visible. |
HighQualityRender | Toggles high-quality rendering. |
PageColor | Sets the drawing page color. Specify an integer value. |
PageVisible | Displays the drawing page. |
PropertyDialogEnabled | Enables the Properties & Settings dialog box to show on selection or toolbar events. |
ScrollbarsVisible | Displays the scroll bars. |
SRC | Specifies the Visio drawing to open. Specify the drawing path by using a Web address. |
ToolbarVisible | Displays the toolbar. |
Zoom | Sets the initial zoom value.
You can specify a zoom percentage as a fraction (for example, 0.5 for 50% and 1.0 for 100%) or use any of the following values: -1 = Whole page view -2 = Page width view -3 = Last zoom percentage |
If you're using FrontPage 2002 or 2003 or to author your HTML, you can use the following procedure to insert a Visio Viewer control and set parameters through the user interface.
To insert a Visio Viewer control in a Web page and set parameters using FrontPage
Start FrontPage and open a Web page.
On the Insert menu, click WebComponent. Or, on the toolbar, click the Web Component button.
In the Insert Web Component dialog box, under Component type, click AdvancedControls.
Under Choosea control, click ActiveXControl, and then click Next.
Do one of the following:
- In the Insert Web Component dialog box, under Choosea control, click Microsoft Visio Viewer, and then click Finish.
Or
- If the Microsoft Visio Viewer control doesn't appear in the Choose a control list, click Customize.
- In the Customize ActiveX Control List dialog box, under Control, select the Microsoft Visio Viewer check box, and then click OK.
- In the Insert Web Component dialog box, under Choosea control, click Microsoft Visio Viewer, and then click Finish.
Right-click the Visio Viewer control on the page, and then click ActiveX Control Properties.
In the ActiveX Control Properties dialog box, click the Parameters tab, select an attribute, and then click Modify.
Set the attribute values you want, and then click OK. Your Web page displays the Visio Viewer control with the parameters you specified.
Additional Resources
The Microsoft TechNet article Deploy Microsoft Visio Viewer 2003 provides information about deploying Visio Viewer 2003, using the following deployment scenarios:
- Deploying the Visio Viewer from an administrative installation point.
- Assigning or publishing the Visio Viewer using Microsoft Active Directory directory service.