CAD Clinic: Writing Apps with the DWP Viewer Control, Part 315 Apr, 2005 By: Mike Tuersley Cadalyst
Use DWF Viewer Control with HTML to publish DWF files to the web
What more could I possibly write about the DWF Viewer Control [EV for short]? Well, I missed a whole development segment - the HTML'ers. So this month, let's take a look at how to add the EV control to a standard HTML page for an intranet or the Internet. Because HTML is a whole different programming topic, I'll limit this article to a simple Web page. Before the e-mails start flying at me, remember this is an over-simplified explanation of HTML programming.
To begin, I'm going to keep it simple and just use Windows' NotePad to generate my Web page. You can use any ASCII or HTML editor. Once I open NotePad, I'll begin by adding some basic HTML code to signify that this is a Web page:
<title> HTML DWF Viewer Sample</title>
That's all there is to it. As a brief explanation, HTML is more of a writing style than a programming language. Every object used to define a page must start and end with a "tag." A tag is a code word surrounded by "< >" and the ending tag is identical to the starting tag except the code word is prefaced with a forward slash "/". With this in mind, this example has:
- The HTML tag designates this document as an HTML document.
- The Head and Title tags are used to add the title to the Web browser interface.
- The Body tag indicates what will reside within the space of the Web browser.
Figure 1. Select All Files in Notepad to save the file as an HTML document.
Now that the file is saved, you can open it in your Internet browser. It should appear as a blank page but have the title in the browser's title bar at the top.
Adding the DWF Viewer Control
The next step in this little project is to add the EV control. While it's very simple to do, some forethought is required. The easiest way to add the control is to consult the DWF API Guide available free from Autodesk.
After downloading and opening the Help file, it's only a matter of copy/pasting the correct code. The forethought lies in how you wish to access the control itself. There are three options:
- Referencing it from the Autodesk Web site - the user is prompted to download or install the viewer if the viewer is not already installed on the local machine
- Referencing it from the local hard drive - the browser assumes it is already installed on the local machine
- Referencing a viewer version number - the user is prompted to install a new version if it's not at or above the specified build version number.
<object id = "DwfViewer"
classid = "clsid:A662DA7E-CCB7-4743-B71A-D817F6D575DF">
<param name = "Src" value="C:\_Projectss\Dwfs\Wilhome.dwf">
The critical part is specifying the class ID of the EV control. While there are a couple of ways to find the number, it's easiest to use it right out of the help file. Also in this code, the EV control is referenced via the Object ID as DWFViewer (this will come in handy later on), and the SRC parameter is the file to load.
Try saving the file and viewing it again in your Web browser. As long as you instruct the control to open a valid file in the SRC parameter statement, the EV control should now be visible. If you omitted a valid file name, then the page will still be blank; declaring an invalid file name should create an error when opening the page. When specifying the file name, the full path needs to be included unless the DWF is located in the same directory as the HTML file.
Tip: Once the HTML file is open in your Web browser, leave it open. As you make changes to the HTML file, save the file and then select the Refresh button in the Web browser.
Figure 2. The document should appear in your Web browser.
Adding VBScript Coding
If you've never done VBScripting in an HTML page, it's really easy and should be familiar to you based on your experiences with VBA or VB6.
To initialize VBScript, I just place a SCRIPT tag in the HTML page like so:
/--- code to go here ---
Notice that it must be placed before the HTML tag. Let's add some code to the HTML. To do so, we need to add two items. First is the code, and second is an object to run the code from the Web page. Because this example is supposed to be simple, all our code will run from hyperlinks. The first function I'm going to add is one to display the Views dialog box to the user. For this example, I added a view for each room to the Wilhome drawing (found in your AutoCAD Samples directory or included in the source code for this article). The function will look like this:
'Calls the VIEWS dialog'
And the hyperlink will look like this:
Here the Object ID specified in the EV control is used by the scripting as the reference. The VBscript function, SetView, is called by the hyperlink tag <a>. <a> has two components: the script to execute and the text that appears on the Web page. A quick save, toggle to Internet Explorer, refresh, and the Web page should look like Figure 3 after clicking on the Select View hyperlink:
Figure 3. SetView adjusts the EV control to display the specified view.
Wrapping It Up
You can specify more load parameters for the EV control so the HTML code could look like this:
id = "DwfViewer"
classid = "clsid:A662DA7E-CCB7-4743-B71A-D817F6D575DF"
width = "75.0%"
height = "60.0%">
<param name="BackColor" value=8421376>
<param name="Page" value=1>
<param name="PaperVisible" value=false>
<param name="Src" value="Wilhome.dwf">
<param name="ToolbarVisible" value=true>
<param name="UserInterfaceEnabled" value=true>
<param name="View" value="Breakfast Nook">
Now the control is loaded so that:
- Its height and width are percentages of the web page's size.
- The control's BackColor is a shade of reddish brown.
- The first page is loaded if it's a multi-page DWF [ignored if not].
- The paper outline is not shown.
- Toolbars and UserInterface [right-click menu] are enabled.
How easy was that? With a little bit of HTML knowledge and a copy of the DWF API Guide, you're on your way to developing DWF-enabled Web pages!
Kick It Up A Notch!
If you're interested in learning more about creating your own Web pages, I recommend going to your local library and checking out a copy of Creating Web Pages with HTML Simplified from maranGraphics [ISBN: 0-7645-6067-0].
Autodesk Technical Evangelist Lynn Allen guides you through a different AutoCAD feature in every edition of her popular "Circles and Lines" tutorial series. For even more AutoCAD how-to, check out Lynn's quick tips in the Cadalyst Video Gallery. Subscribe to Cadalyst's free Tips & Tools Weekly e-newsletter and we'll notify you every time a new video tip is published. All exclusively from Cadalyst!