Microsoft KB Archive/188018

= How To Pass Parameters from HTML to ActiveX Documents =

Article ID: 188018

Article Last Modified on 7/2/2004

-

APPLIES TO


 * Microsoft Internet Explorer 3.02
 * Microsoft Internet Explorer 4.0 128-Bit Edition
 * Microsoft Internet Explorer 4.01 Service Pack 2
 * Microsoft Internet Explorer 4.01 Service Pack 1
 * Microsoft Internet Explorer 5.0
 * Microsoft Internet Explorer 5.5
 * Microsoft Visual Basic 5.0 Learning Edition
 * Microsoft Visual Basic 6.0 Learning Edition
 * Microsoft Visual Basic 5.0 Professional Edition
 * Microsoft Visual Basic 6.0 Professional Edition
 * Microsoft Visual Basic 5.0 Enterprise Edition
 * Microsoft Visual Basic 6.0 Enterprise Edition

-



This article was previously published under Q188018



SUMMARY
When you are launching a Visual Basic 5.0 UserDocument under Internet Explorer, you may want to pass it some information. You cannot call public methods and properties of the UserDocument from within the HTML for two reasons. First, as soon as the UserDocument loads, the HTML page used to launch it is destroyed. Second, Internet Explorer does not consider UserDocuments safe for scripting.

This article shows you a technique to pass information to the UserDocument you are launching from within the launching HTML page.



MORE INFORMATION
You can pass parameters to the UserDocument you are launching as a query string using the question mark(?) in the URL. After passing the desired information using the question mark from the HTML, you can retrieve it in your UserDocument.

HTML File
Modify the Setup Wizard generated .htm file as described in Knowledge Base article 168431 (see REFERENCES section below). Append the parameters you are interested in to the URL using the question mark (?):

Location.Replace = "MyDoc.VBD?MyParametersStr"

The string ParameterStr is passed using the question mark above. The question mark (?) is typically used to pass query string information. In addition to using Location.Replace, you can also navigate using Location.HREF, Window.Navigate, or a simple  tag.

Please note that any information passed in a URL is restricted to "safe" characters.

UserDocument Code
To retrieve the parameters sent to the UserDocument from the launching .htm file, examine the Parent.LocationURL property from the Show event of the UserDocument. Since Parent.LocationURL returns the entire URL for the UserDocument, you will have to parse out the parameter information from it.

When using the file:// protocol the ? will be encoded to a %3F. If the URL is a relative one you are using the file:// protocol and Internet Explorer 4, then the question mark must be explicitly escaped to %3F for this to work. If it is not escaped, the parameter will not get passed on. Please note that any unsafe characters in the query string will be be escaped.

The launching htm can look like this:  Sub Window_OnLoad ' For relative URLs, ? should be explicitly escaped to %3F ' for Internet Explorer 4 location.href = "userdocument1.vbd%3FMyParamString"

' For absolute file urls, the ? is automatically escaped to %3F location.href = "file://c:\Tests\userdocument1.vbd?MyParamString" End Sub 

Here is an example of how the parameters can be retrieved in the UserDocument accounting for both the encoded and unencoded question mark: Private Sub UserDocument_Show Dim Param Dim P As Integer

P = InStr(Parent.LocationURL, "%3F") If P > 0 Then Param = Mid$(Parent.LocationURL, P + 3) End If

MsgBox "Got : " & Param End Sub

