Disabling Office 2003 Browser Inline Behavior

by Charles Chen · Published March 25, 2008 · Updated August 12, 2010

There’s a unique problem in an Office 2003 environment that may be encountered by add-in developers. Namely, by default, Office 2003 documents, when opened from a URL (for example, clicking on a link in an email or typing a URL into a browser address bar) will cause the document to open “inline” with the browser.

The problem with this, for add-in developers, is that while the WINWORD.EXE process is indeed launched, the add-in is not loaded (I’m still not sure why, but I’m guessing it’s due to the different security restrictions of being “hosted” in Internet Explorer). Aside from this, it’s generally problematic because the default menu bars and toolbars are not displayed by default…not the ideal behavior.

As it turns out, in Office 2007, the behavior is entirely different: the document always open in a standalone WINWORD.EXE process. So how can we get Office 2003 to behave the same way? A series of articles lead the way to an answer:

First, Microsoft actually has a KB (927009) which advises how to enabled Office 2003 behavior in an Office 2007 environment. This is the first clue that the core of the issue is a series of registry keys. Knowing which keys to look for, I simply checked the keys in an Office 2007 environment to get the values which would cause an application like Word to launch in standalone mode instead of inline mode (decimal 44 in the case of Word).

The next step was figuring out how to adjust these values in existing deployments. One option would have been to use a similar registry script as porposed in the KB but I decided to use a programmatic approach instead. I came across some hints on how to approach this task from a forum posting and MSDN articles.

The outcome was this script:

<span style="font-family: Lucida Console;"><span style="color: #008000;">/*=============================================================================</span>

<span style="color: #008000;">   This file contains the scripts which are executed after installation of the </span>

<span style="color: #008000;">   Office 2003 client update registry keys which would otherwise force Office </span>

<span style="color: #008000;">   documents to open in Internet Explorer (inline behavior)</span>

<span style="color: #008000;">=============================================================================*/</span>

<span style="color: #008000;">// Key paths</span>

<span style="color: #4d70ea;">var </span><span style="color: #000000;">commonRootPath = </span><span style="color: #a56dbc;">"HKLM\\SOFTWARE\\Classes\\"</span><span style="color: #000000;">;</span>

<span style="color: #4d70ea;">var </span><span style="color: #000000;">commonPath = </span><span style="color: #a56dbc;">"SOFTWARE\\Classes\\"</span><span style="color: #000000;">;</span>

<span style="color: #4d70ea;">var </span><span style="color: #000000;">commonKey = </span><span style="color: #a56dbc;">"BrowserFlags"</span><span style="color: #000000;">;</span>

<span style="color: #4d70ea;">var </span><span style="color: #000000;">HKLM = </span><span style="color: #ff00ff;">0x80000002</span><span style="color: #000000;">;</span></span>

<span style="font-family: Lucida Console;"><span style="color: #008000;">// Instantiate the shell.</span>

<span style="color: #4d70ea;">var </span><span style="color: #000000;">shell = WScript.CreateObject(</span><span style="color: #a56dbc;">"WScript.Shell"</span><span style="color: #000000;">);</span></span>

<span style="font-family: Lucida Console;"><span style="color: #008000;">// Holds the values for the key types</span>

<span style="color: #4d70ea;">var </span><span style="color: #000000;">keyTypes = {</span>

    <span style="color: #ff0000;">String</span><span style="color: #000000;">:</span><span style="color: #a56dbc;">"REG_SZ"</span><span style="color: #000000;">, </span>

    <span style="color: #000000;">Number:</span><span style="color: #a56dbc;">"REG_DWORD"</span><span style="color: #000000;">, </span>

    <span style="color: #000000;">Binary:</span><span style="color: #a56dbc;">"REG_BINARY"</span><span style="color: #000000;">, </span>

    <span style="color: #000000;">ExpandableString:</span><span style="color: #a56dbc;">"REG_EXPAND_SZ"</span>

<span style="color: #000000;">};</span></span>

<span style="font-family: Lucida Console;"><span style="color: #008000;">// Holds the array of all key paths (not including the shared "BrowserFlags" </span>

<span style="color: #008000;">// DWORD key name) and the value to assign to the key (different for each</span>

<span style="color: #008000;">// runtime).</span>

<span style="color: #4d70ea;">var </span><span style="color: #000000;">keys = [</span>

    <span style="color: #000000;">{Class:</span><span style="color: #a56dbc;">"Word.Document"</span><span style="color: #000000;">, Value:</span><span style="color: #ff00ff;">44</span><span style="color: #000000;">},</span>

    <span style="color: #000000;">{Class:</span><span style="color: #a56dbc;">"Word.Document.6"</span><span style="color: #000000;">, Value:</span><span style="color: #ff00ff;">44</span><span style="color: #000000;">},</span>

    <span style="color: #000000;">{Class:</span><span style="color: #a56dbc;">"Word.Document.8"</span><span style="color: #000000;">, Value:</span><span style="color: #ff00ff;">44</span><span style="color: #000000;">},</span>

    <span style="color: #000000;">{Class:</span><span style="color: #a56dbc;">"Word.Document.12"</span><span style="color: #000000;">, Value:</span><span style="color: #ff00ff;">44</span><span style="color: #000000;">},</span>

    <span style="color: #000000;">{Class:</span><span style="color: #a56dbc;">"Word.RTF.8"</span><span style="color: #000000;">, Value:</span><span style="color: #ff00ff;">44</span><span style="color: #000000;">},</span>

    <span style="color: #000000;">{Class:</span><span style="color: #a56dbc;">"Word.DocumentMacroEnabled.12"</span><span style="color: #000000;">, Value:</span><span style="color: #ff00ff;">44</span><span style="color: #000000;">}</span>

<span style="color: #000000;">];</span></span>

<span style="font-family: Lucida Console;"><span style="color: #008000;">/*-----------------------------------------------------------------------------</span>

<span style="color: #008000;">    Main method.</span>

<span style="color: #008000;">-----------------------------------------------------------------------------*/    </span>

<span style="color: #4d70ea;">function </span><span style="color: #000000;">Run() {</span>

    <span style="color: #4d70ea;">try </span><span style="color: #000000;">{</span>

        <span style="color: #4d70ea;">for</span><span style="color: #000000;">(</span><span style="color: #4d70ea;">var </span><span style="color: #000000;">i = </span><span style="color: #ff00ff;">0</span><span style="color: #000000;">; i &lt; keys.length; i++) {  </span>

            <span style="color: #4d70ea;">var </span><span style="color: #000000;">key = keys[i];</span></span>

<span style="font-family: Lucida Console;">            <span style="color: #4d70ea;">if</span><span style="color: #000000;">(RegistryKeyExists(key.Class)) {            </span>

                <span style="color: #4d70ea;">var </span><span style="color: #000000;">keyPath = commonRootPath + key.Class + </span><span style="color: #a56dbc;">"\\" </span><span style="color: #000000;">+ commonKey;                              </span></span>

<span style="font-family: Lucida Console;">                <span style="color: #000000;">shell.RegWrite(keyPath, key.Value, keyTypes.Number);</span>

            <span style="color: #000000;">}</span>

        <span style="color: #000000;">}   </span></span>

<span style="font-family: Lucida Console;">	    <span style="color: #000000;">shell.Popup(</span><span style="color: #a56dbc;">"Updated registry keys."</span><span style="color: #000000;">, </span><span style="color: #ff00ff;">0</span><span style="color: #000000;">, </span><span style="color: #a56dbc;">"Completed"</span><span style="color: #000000;">, </span><span style="color: #ff00ff;">0 </span><span style="color: #000000;">+ </span><span style="color: #ff00ff;">64</span><span style="color: #000000;">);</span>

    <span style="color: #000000;">}</span>

    <span style="color: #4d70ea;">catch</span><span style="color: #000000;">(all) {</span>

        <span style="color: #008000;">// Failures are considered non-fatal.</span>

        <span style="color: #4d70ea;">var </span><span style="color: #000000;">errorMessage = </span><span style="color: #a56dbc;">"A non-fatal error occurred while configuring Word 2003\r\n"</span><span style="color: #000000;">;</span>

        <span style="color: #000000;">errorMessage += </span><span style="color: #a56dbc;">"document handling in IE.\r\n\r\n"</span><span style="color: #000000;">;</span>

        <span style="color: #000000;">errorMessage += </span><span style="color: #a56dbc;">"You can re-run this script at a later time from:\r\n\r\n"</span><span style="color: #000000;">;</span>

        <span style="color: #000000;">errorMessage += </span><span style="color: #a56dbc;">"[Program Files]\\[Common Files]\\FirstPoint\";</span>

		<span style="color: #000000;">errorMessage += </span><span style="color: #a56dbc;">"UpdateOffice2003RegistrySettings.js\r\n\r\n"</span><span style="color: #000000;">;</span>

        <span style="color: #000000;">errorMessage += </span><span style="color: #a56dbc;">"Press OK to continue."</span><span style="color: #000000;">;</span></span>

<span style="font-family: Lucida Console;">        <span style="color: #000000;">shell.Popup(errorMessage, </span><span style="color: #ff00ff;">0</span><span style="color: #000000;">, </span><span style="color: #a56dbc;">"Error"</span><span style="color: #000000;">, </span><span style="color: #ff00ff;">0 </span><span style="color: #000000;">+ </span><span style="color: #ff00ff;">48</span><span style="color: #000000;">);</span>

    <span style="color: #000000;">}</span>

<span style="color: #000000;">}</span></span>

<span style="font-family: Lucida Console;"><span style="color: #008000;">/*-----------------------------------------------------------------------------</span>

<span style="color: #008000;">    Checks to see if a registry key exists.</span>

<span style="color: #008000;">-----------------------------------------------------------------------------*/</span>

<span style="color: #4d70ea;">function </span><span style="color: #000000;">RegistryKeyExists(className) {</span>

    <span style="color: #4d70ea;">var </span><span style="color: #000000;">registry = GetObject(</span><span style="color: #a56dbc;">"winmgmts:\\\\.\\root\\default:StdRegProv"</span><span style="color: #000000;">);   </span></span>

<span style="font-family: Lucida Console;">    <span style="color: #4d70ea;">var </span><span style="color: #000000;">path = commonPath + className;       </span></span>

<span style="font-family: Lucida Console;">    <span style="color: #4d70ea;">var </span><span style="color: #000000;">value = registry.GetStringValue(HKLM, path, </span><span style="color: #a56dbc;">""</span><span style="color: #000000;">);</span></span>

<span style="font-family: Lucida Console;">    <span style="color: #4d70ea;">return </span><span style="color: #000000;">value == </span><span style="color: #ff00ff;">0</span><span style="color: #000000;">;</span>

<span style="color: #000000;">}</span></span>

<span style="font-family: Lucida Console;"><span style="color: #008000;">/*-----------------------------------------------------------------------------</span>

<span style="color: #008000;">    Abstracts Popup()</span>

<span style="color: #008000;">-----------------------------------------------------------------------------*/</span>

<span style="color: #4d70ea;">function </span><span style="color: #000000;">Alert(string) {</span>

    <span style="color: #000000;">shell.Popup(string, </span><span style="color: #ff00ff;">0</span><span style="color: #000000;">, </span><span style="color: #a56dbc;">"Message"</span><span style="color: #000000;">, </span><span style="color: #ff00ff;">0</span><span style="color: #000000;">);</span>

<span style="color: #000000;">}</span></span>

<span style="font-family: Lucida Console;"><span style="color: #000000;">Run();</span></span>

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

/*=============================================================================

This file contains the scripts which are executed after installation of the

Office 2003 client update registry keys which would otherwise force Office

documents to open in Internet Explorer (inline behavior)

=============================================================================*/

// Key paths

var commonRootPath = "HKLM\\SOFTWARE\\Classes\\";

var commonPath = "SOFTWARE\\Classes\\";

var commonKey = "BrowserFlags";

var HKLM = 0x80000002;

// Instantiate the shell.

var shell = WScript.CreateObject("WScript.Shell");

// Holds the values for the key types

var keyTypes = {

String:"REG_SZ",

Number:"REG_DWORD",

Binary:"REG_BINARY",

ExpandableString:"REG_EXPAND_SZ"

};

// Holds the array of all key paths (not including the shared "BrowserFlags"

// DWORD key name) and the value to assign to the key (different for each

// runtime).

var keys = [

{Class:"Word.Document", Value:44},

{Class:"Word.Document.6", Value:44},

{Class:"Word.Document.8", Value:44},

{Class:"Word.Document.12", Value:44},

{Class:"Word.RTF.8", Value:44},

{Class:"Word.DocumentMacroEnabled.12", Value:44}

];

/*-----------------------------------------------------------------------------

Main method.

-----------------------------------------------------------------------------*/

function Run() {

try {

for(var i = 0; i < keys.length; i++) {

var key = keys[i];

if(RegistryKeyExists(key.Class)) {

var keyPath = commonRootPath + key.Class + "\\" + commonKey;

shell.RegWrite(keyPath, key.Value, keyTypes.Number);

}

}

shell.Popup("Updated registry keys.", 0, "Completed", 0 + 64);

}

catch(all) {

// Failures are considered non-fatal.

var errorMessage = "A non-fatal error occurred while configuring Word 2003\r\n";

errorMessage += "document handling in IE.\r\n\r\n";

errorMessage += "You can re-run this script at a later time from:\r\n\r\n";

errorMessage += "[Program Files]\\[Common Files]\\FirstPoint\";

errorMessage += "UpdateOffice2003RegistrySettings.js\r\n\r\n";

errorMessage += "Press OK to continue.";

shell.Popup(errorMessage, 0, "Error", 0 + 48);

}

}

/*-----------------------------------------------------------------------------

Checks to see if a registry key exists.

-----------------------------------------------------------------------------*/

function RegistryKeyExists(className) {

var registry = GetObject("winmgmts:\\\\.\\root\\default:StdRegProv");

var path = commonPath + className;

var value = registry.GetStringValue(HKLM, path, "");

return value == 0;

}

/*-----------------------------------------------------------------------------

Abstracts Popup()

-----------------------------------------------------------------------------*/

function Alert(string) {

shell.Popup(string, 0, "Message", 0);

}

Run();

Perhaps the most useful little tidbit in all of this is the RegistryKeyExists method which checks to see a registry path exists. A return value of 0 from any of the Get[KeyType]Value() method calls indicates that the path was found; it’s a very neat little trick to have up your sleeve.

Disabling Office 2003 Browser Inline Behavior

You may also like...

Recent Posts

Recommended

Calendar

Browse by Category

Browse Archives

Meta

Disabling Office 2003 Browser Inline Behavior

SHARE

You may also like...

The Beauty of Mongo

More Thoughts on Object Oriented Code

Revisiting Spring.Net

Recent Posts

Recommended

Calendar

Browse by Category

Browse Archives

Meta