home *** CD-ROM | disk | FTP | other *** search
/ PC World 2003 May / PCWorld_2003-05_cd.bin / Komunik / phoenix / chrome / toolkit.jar / content / global / nsClipboard.js < prev    next >
Text File  |  2001-11-10  |  4KB  |  98 lines
  1. /* -*- Mode: Java; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
  2. /* ***** BEGIN LICENSE BLOCK *****
  3.  * Version: NPL 1.1/GPL 2.0/LGPL 2.1
  4.  *
  5.  * The contents of this file are subject to the Netscape Public License
  6.  * Version 1.1 (the "License"); you may not use this file except in
  7.  * compliance with the License. You may obtain a copy of the License at
  8.  * http://www.mozilla.org/NPL/
  9.  *
  10.  * Software distributed under the License is distributed on an "AS IS" basis,
  11.  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
  12.  * for the specific language governing rights and limitations under the
  13.  * License.
  14.  *
  15.  * The Original Code is mozilla.org code.
  16.  *
  17.  * The Initial Developer of the Original Code is 
  18.  * Netscape Communications Corporation.
  19.  * Portions created by the Initial Developer are Copyright (C) 1998
  20.  * the Initial Developer. All Rights Reserved.
  21.  *
  22.  * Contributor(s):
  23.  *   Ben Matthew Goodger <ben@netscape.com>
  24.  *
  25.  * Alternatively, the contents of this file may be used under the terms of
  26.  * either the GNU General Public License Version 2 or later (the "GPL"), or 
  27.  * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
  28.  * in which case the provisions of the GPL or the LGPL are applicable instead
  29.  * of those above. If you wish to allow use of your version of this file only
  30.  * under the terms of either the GPL or the LGPL, and not to allow others to
  31.  * use your version of this file under the terms of the NPL, indicate your
  32.  * decision by deleting the provisions above and replace them with the notice
  33.  * and other provisions required by the GPL or the LGPL. If you do not delete
  34.  * the provisions above, a recipient may use your version of this file under
  35.  * the terms of any one of the NPL, the GPL or the LGPL.
  36.  *
  37.  * ***** END LICENSE BLOCK ***** */
  38.  
  39. /** 
  40.  * nsClipboard - wrapper around nsIClipboard and nsITransferable
  41.  *               that simplifies access to the clipboard. 
  42.  **/ 
  43. var nsClipboard = {
  44.   _CB: null,
  45.   get mClipboard()
  46.     {
  47.       if (!this._CB) 
  48.         {
  49.           const kCBContractID = "@mozilla.org/widget/clipboard;1";
  50.           const kCBIID = Components.interfaces.nsIClipboard;
  51.           this._CB = Components.classes[kCBContractID].getService(kCBIID);
  52.         }
  53.       return this._CB;
  54.     },
  55.     
  56.   currentClipboard: null,
  57.   /** 
  58.    * Array/Object read (Object aFlavourList, long aClipboard, Bool aAnyFlag) ;
  59.    *
  60.    * returns the data in the clipboard
  61.    * 
  62.    * @param FlavourSet aFlavourSet
  63.    *        formatted list of desired flavours
  64.    * @param long aClipboard
  65.    *        the clipboard to read data from (kSelectionClipboard/kGlobalClipboard)
  66.    * @param Bool aAnyFlag
  67.    *        should be false.
  68.    **/
  69.   read: function (aFlavourList, aClipboard, aAnyFlag)
  70.     {
  71.       this.currentClipboard = aClipboard;
  72.       var data = nsTransferable.get(aFlavourList, this.getClipboardTransferable, aAnyFlag);
  73.       return data.first.first;  // only support one item
  74.     },
  75.     
  76.   /**
  77.    * nsISupportsArray getClipboardTransferable (Object aFlavourList) ;
  78.    * 
  79.    * returns a nsISupportsArray of the item on the clipboard
  80.    *
  81.    * @param Object aFlavourList
  82.    *        formatted list of desired flavours.
  83.    **/
  84.   getClipboardTransferable: function (aFlavourList)
  85.     {
  86.       const supportsContractID = "@mozilla.org/supports-array;1";
  87.       const supportsIID = Components.interfaces.nsISupportsArray;
  88.       var supportsArray = Components.classes[supportsContractID].createInstance(supportsIID);
  89.       var trans = nsTransferable.createTransferable();
  90.       for (var flavour in aFlavourList) 
  91.         trans.addDataFlavor(flavour);
  92.       nsClipboard.mClipboard.getData(trans, nsClipboard.currentClipboard)
  93.       supportsArray.AppendElement(trans);
  94.       return supportsArray;
  95.     }
  96. };
  97.  
  98.