Bug 251751 - Firefox Help window should not be alwaysRaised r=mconnor@myrealbox.com

toolkit/components/help/content/help.js

@@ -867,3 +867,35 @@ function showRelativePanel(goForward) {
   sidebarButtons[selectedIndex].doCommand();
 }
 
+# getXulWin - Returns the current Help window as a nsIXULWindow.
+function getXulWin()
+{
+  window.QueryInterface(Components.interfaces.nsIInterfaceRequestor);
+  var webnav = window.getInterface(Components.interfaces.nsIWebNavigation);
+  var dsti = webnav.QueryInterface(Components.interfaces.nsIDocShellTreeItem);
+  var treeowner = dsti.treeOwner;
+  var ifreq = treeowner.QueryInterface(Components.interfaces.nsIInterfaceRequestor);
+
+  return ifreq.getInterface(Components.interfaces.nsIXULWindow);
+}
+
+# toggleZLevel - Toggles whether or not the window will always appear on top. Because
+#   alwaysRaised is not supported on an OS other than windows, this code will not
+#   appear in those builds.
+#
+#   element - The DOM node that persists the checked state.
+#ifdef XP_WIN
+function toggleZLevel(element)
+{
+  var xulwin = getXulWin();
+  
+  // Now we can flip the zLevel, and set the attribute so that it persists correctly
+  if (xulwin.zLevel > xulwin.normalZ) {
+    xulwin.zLevel = xulwin.normalZ;
+    element.setAttribute("checked", "false");
+  } else {
+    xulwin.zLevel = xulwin.raisedZ;
+    element.setAttribute("checked", "true");
+  }
+}
+#endif

toolkit/components/help/content/help.xul

@@ -60,7 +60,11 @@
         xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
         width="700"
         height="550"
+#ifdef XP_WIN
+        persist="width height screenX screenY zlevel"
+#else
         persist="width height screenX screenY"
+#endif
         onload="init();"
         onunload="uninitFindBar(); window.XULBrowserWindow.destroy();">
 

toolkit/components/help/content/helpContextOverlay.xul

@@ -68,6 +68,16 @@
       		label="&textZoomReduceBtn.label;"
       		accesskey="&textZoomReduceBtn.accesskey;"
       		oncommand="ZoomManager.prototype.getInstance().reduce();"/>
+#ifdef XP_WIN
+      <menuseparator/>
+      <menuitem id="context-zlevel"
+                type="checkbox"
+                checked="true"
+                persist="checked"
+                label="&zLevel.label;"
+                accesskey="&zLevel.accesskey;"
+                oncommand="toggleZLevel(this);"/>
+#endif
     </popup>
   </popupset>
 </overlay>

toolkit/components/help/locale/en-US/help.dtd

@@ -54,3 +54,6 @@
 <!ENTITY textZoomEnlargeCmd.commandkey	"+">
 <!ENTITY textZoomEnlargeCmd.commandkey2 "="> <!-- + is above this key on many keyboards -->
 <!ENTITY textZoomResetCmd.commandkey    "0">
+
+<!ENTITY zLevel.label                   "Always on Top">
+<!ENTITY zLevel.accesskey               "T">