GameStar 2005 October/Gamestar_77_2005-10_dvd.iso/Programy/nsb-install-8-0.exe/chrome/help.jar/content/browser/help/contextHelp.js

Text File | 2005-07-29 | 5.5 KB | 147 lines

/* -*- Mode: Java; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 * The contents of this file are subject to the Netscape Public
 * License Version 1.1 (the "License"); you may not use this file
 * except in compliance with the License. You may obtain a copy of
 * the License at http://www.mozilla.org/NPL/
 *
 * Software distributed under the License is distributed on an "AS
 * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
 * implied. See the License for the specific language governing
 * rights and limitations under the License.
 *
 * The Original Code is Mozilla Communicator client code, released
 * March 31, 1998.
 *
 * The Initial Developer of the Original Code is Netscape
 * Communications Corporation. Portions created by Netscape are
 * Copyright (C) 1998-1999 Netscape Communications Corporation. All
 * Rights Reserved.
 *
 * Contributor(s):
 *   R.J. Keller <[e-mail]>
 */

const MOZILLA_CONTENT_PACK = "chrome://help/locale/mozillahelp.rdf";
//Set the default content pack to the Mozilla content pack. Use the
//setHelpFileURI function to set this value.
var helpFileURI = MOZILLA_CONTENT_PACK;

// openHelp - Opens up the Mozilla Help Viewer with the specified
//    topic and content pack.
// see http://www.mozilla.org/projects/help-viewer/content_packs.html
function openHelp(topic, contentPack)
{
    if (topic == "new_web_cert")
    {
        return;
    }
    // dump ("Calling openHelp with topic of " + topic + " \t");
    // showStack();

    // MERC: SL - AIM help is in own window STEVO - So does ICQ :)
//   if (topic != "im" && topic != "icq") {
      var prefService = Components.classes["@mozilla.org/preferences-service;1"]
                              .getService(Components.interfaces.nsIPrefBranch);
      if (prefService.getPrefType("browser.help.url")) {

         var helpURL = prefService.getCharPref("browser.help.url");

         if (topic == "im") {
            var aimHelpUrl = prefService.getPrefType("aim.help.url");
            if (aimHelpUrl && aimHelpUrl.length > 6)
               helpURL = prefService.getCharPref("aim.help.url");
            else
               helpURL = "http://browser.netscape.com/ns8/help/im_help.jsp";
         }

         if (topic == "icq") {
            var icqHelpUrl = prefService.getPrefType("icq.help.url");
            if (icqHelpUrl && icqHelpUrl.length > 6)
               helpURL = prefService.getCharPref("icq.help.url");
         }

            try {
              var newTab = gBrowser.addTabAt(helpURL);
              if (!prefService.getBoolPref("browser.tabs.loadInBackground"))
               gBrowser.selectedTab = newTab;
              return;
            } catch (ex) {
                        // This could be because gBrowser does not exist
              }

              // this may be called from a dialog box...
              try {
                var newTab = opener.window.gBrowser.addTabAt(helpURL);
                if (!prefService.getBoolPref("browser.tabs.loadInBackground"))
                    opener.window.gBrowser.selectedTab = newTab;
                return;
                    } catch (ex) {
                        // opener.window is probably not right
                    }

                    // Probably called from sidebar
                    try {
                // We need to find the top window (gBrowser does not exist)
                      var browser = top.document.getElementById('content');
              var newTab = browser.addTabAt(helpURL);
              if (!prefService.getBoolPref("browser.tabs.loadInBackground"))
               browser.selectedTab = newTab;
            return;
              } catch (ex) {
                  // Ok so top.document does not exist! I give up!
                  return;
              }

      }
//   }
  //cp is the content pack to use in this function. If the contentPack
  //parameter was set, we will use that content pack. If not, we will
  //use the default content pack set by setHelpFileURI().
  var cp = contentPack || helpFileURI;

  // Try to find previously opened help.
  var topWindow = locateHelpWindow(cp);

  if ( topWindow ) {
    // Open topic in existing window.
    topWindow.focus();
    topWindow.displayTopic(topic);
  } else {
    // Open topic in new window.
    const params = Components.classes["@mozilla.org/embedcomp/dialogparam;1"]
                             .createInstance(Components.interfaces.nsIDialogParamBlock);
    params.SetNumberStrings(2);
    params.SetString(0, cp);
    params.SetString(1, topic);
    const ww = Components.classes["@mozilla.org/embedcomp/window-watcher;1"]
                         .getService(Components.interfaces.nsIWindowWatcher);
    dump('ABOUT TO OPEN HELP WINDOW... !\n');
    ww.openWindow(null, "chrome://help/content/help.xul", "_blank", "chrome,all,alwaysRaised,dialog=no", params);
  }
}

//setHelpFileURI - Sets the default content pack to use in the Help Viewer
function setHelpFileURI(rdfURI) {
  helpFileURI = rdfURI;
}

// Locate mozilla:help window (if any) opened for this help file uri.
function locateHelpWindow(helpFileURI) {
  const windowManager = Components.classes['@mozilla.org/appshell/window-mediator;1']
                                  .getService(Components.interfaces.nsIWindowMediator);
  var iterator = windowManager.getEnumerator("mozilla:help");
  var topWindow = null;
  var currentWindow;

  // Loop through the help windows looking for one with the
  // current Help Content Pack loaded.
  while (iterator.hasMoreElements()) {
    currentWindow = iterator.getNext();
    if (currentWindow.getHelpFileURI() == helpFileURI) {
      topWindow = currentWindow;
      break;
    }
  }
  return topWindow;
}