home *** CD-ROM | disk | FTP | other *** search
/ Freelog 117 / FreelogNo117-OctobreNovembre2013.iso / Theme / 8GadgetPack / 8GadgetPackSetup.msi / library.js_8 < prev    next >
Text (UTF-16)  |  2012-05-19  |  44KB  |  692 lines
  1. ////////////////////////////////////////////////////////////////////////////////
  2. //
  3. //    THIS CODE IS NOT APPROVED FOR USE IN/ON ANY OTHER UI ELEMENT OR PRODUCT COMPONENT.
  4. //    Copyright (c) 2009 Microsoft Corporation.    All rights reserved.
  5. //
  6. ////////////////////////////////////////////////////////////////////////////////
  7.  
  8.  
  9. var gGadgetMode    = (window.System !== undefined);
  10. var gBIDIMode    = (document.dir=='rtl');    
  11.  
  12. ////////////////////////////////////////////////////////////////////////////////
  13. //
  14. // PICKLIST UTILITIES for use on SELECT Lists
  15. //
  16. ////////////////////////////////////////////////////////////////////////////////
  17.  
  18. ////////////////////////////////////////////////////////////////////////////////
  19. //
  20. // DoAdd(object oPickList, string anOptionValue, OPTIONAL string anOptionText)
  21. //    Adds an Option to passed-in oPickList (SELECT Object)
  22. //
  23. ////////////////////////////////////////////////////////////////////////////////
  24. function DoAdd(oPickList, anOptionValue, anOptionText) 
  25. {
  26.     if (oPickList && anOptionValue.length) 
  27.     {
  28.         var anOption = new Option;
  29.         anOption.value = anOptionValue;
  30.         // If we've been given a display value different than the option value, use it
  31.         if (anOptionText)
  32.         {
  33.             anOption.text    = anOptionText;
  34.         }
  35.         else
  36.         {
  37.             anOption.text    = anOptionValue;
  38.         }
  39.         
  40.         if (oPickList.selectedIndex > -1) 
  41.         { // If something is selected, then insertion point is below that item
  42.             // Insert new option above currently selected row
  43.             oPickList.add(anOption, oPickList.selectedIndex);
  44.             // Set selectedIndex of Picklist to newly inserted item
  45.             oPickList.selectedIndex -= 1;
  46.         } 
  47.         else 
  48.         {
  49.             oPickList.add(anOption);
  50.             oPickList.selectedIndex = DoFindIndex(oPickList, anOption.value);
  51.         }
  52.     }
  53. }
  54. ////////////////////////////////////////////////////////////////////////////////
  55. //
  56. // DoRemoveOption(object oPickList, OPTIONAL int anOptionIndex) 
  57. // Removes option from passed-in Select List. Default is to remove Selected-
  58. // Index but fn also accepts literal index in OPTIONAL param anOptionIndex
  59. //
  60. ////////////////////////////////////////////////////////////////////////////////
  61. function DoRemoveOption(oPickList, anOptionIndex) 
  62. {
  63.     var selectedItem    = anOptionIndex;
  64.     if (anOptionIndex===undefined)
  65.     {
  66.         selectedItem    = oPickList.selectedIndex;
  67.     }
  68.     if (selectedItem > -1) 
  69.     {
  70.         oPickList.options[selectedItem] = null;
  71.     }
  72.     // Set selectedIndex of Picklist to item above the one just removed 
  73.     // (or to the top of the list if we were already there)
  74.     if (selectedItem>0)
  75.     {
  76.         oPickList.selectedIndex = selectedItem-1;
  77.     }
  78.     else
  79.     {
  80.         oPickList.selectedIndex = 0;
  81.     }
  82. }
  83. ////////////////////////////////////////////////////////////////////////////////
  84. //
  85. // DoMoveUp(object oPickList) - Moves the currently selected option from 
  86. //    passed-in Select List Up one line
  87. //
  88. ////////////////////////////////////////////////////////////////////////////////
  89. function DoMoveUp(oPickList) 
  90. {
  91.     var selectedItem    = oPickList.selectedIndex;
  92.     if (selectedItem > 0) 
  93.     {
  94.         // If we're not already at the top of the list ...
  95.         var theOption = oPickList[selectedItem];
  96.         var theOptionB4 = oPickList[selectedItem-1];
  97.         for (prop in theOption) 
  98.         {
  99.             if ((prop=="text") || (prop=="value")) 
  100.             {
  101.                 // Swap the salient properties of the two options
  102.                 var theOptionProp = theOption[prop];
  103.                 theOption[prop] = theOptionB4[prop];
  104.                 theOptionB4[prop] = theOptionProp;
  105.             }
  106.         }
  107.         oPickList.selectedIndex = selectedItem - 1;
  108.     }
  109. }
  110. ////////////////////////////////////////////////////////////////////////////////
  111. //
  112. // DoMoveDown(object oPickList) - Moves the currently selected option from 
  113. //    passed-in Select List Up one line
  114. //
  115. ////////////////////////////////////////////////////////////////////////////////
  116. function DoMoveDown(oPickList) 
  117. {
  118.     var selectedItem    = oPickList.selectedIndex;
  119.     if ( (selectedItem > -1) && (selectedItem < oPickList.length-1) ) 
  120.     {
  121.         var theOption = oPickList[selectedItem];
  122.         var theOptionB4 = oPickList[selectedItem+1];
  123.         for (prop in theOption) 
  124.         {
  125.             if ((prop=="text") || (prop=="value")) 
  126.             {
  127.                 // Swap the salient properties of the two options
  128.                 var theOptionProp = theOption[prop];
  129.                 theOption[prop] = theOptionB4[prop];
  130.                 theOptionB4[prop] = theOptionProp;
  131.             }
  132.         }
  133.         oPickList.selectedIndex = selectedItem + 1;
  134.     }
  135. }
  136. ////////////////////////////////////////////////////////////////////////////////
  137. //
  138. // DoFindIndex(object oPickList, string anOptionValue, string anOptionText)
  139. // returns index value from a passed-in oPickList for either an 
  140. // optionValue or optionText (both OPTIONAL)
  141. //
  142. ////////////////////////////////////////////////////////////////////////////////
  143.  function DoFindIndex(oPickList, anOptionValue, anOptionText) 
  144. {
  145.     var theIndex = -1;
  146.     if (oPickList.length) 
  147.     {
  148.         for (var i=0; i<oPickList.length; i++) 
  149.         {
  150.             if (anOptionText!==undefined) 
  151.             {
  152.                 // Search based on option.text if we have anOptionText
  153.                 if (oPickList[i].text == anOptionText) 
  154.                 {
  155.                     theIndex=i;
  156.                     break;
  157.                 }
  158.             } 
  159.             else 
  160.             {
  161.                 // otherwise, search based on option.value
  162.                 if (oPickList[i].value == anOptionValue) 
  163.                 {
  164.                     theIndex=i;
  165.                     break;
  166.                 }
  167.             }
  168.         }
  169.     }
  170.     return theIndex;
  171.  }
  172.  
  173. ////////////////////////////////////////////////////////////////////////////////
  174. //
  175. // SETTINGS UTILITIES
  176. //
  177. ////////////////////////////////////////////////////////////////////////////////
  178.  
  179. ////////////////////////////////////////////////////////////////////////////////
  180. //
  181. // saveSetting(string theSettingName, string aSettingValue)- Saves a Setting
  182. //
  183. ////////////////////////////////////////////////////////////////////////////////
  184. function saveSetting(theSettingName, aSettingValue) 
  185. {
  186.     try
  187.     {
  188.         if (gGadgetMode) 
  189.         {
  190.             // If we are in "Gadget Mode", save off the value using that mechanism
  191.             System.Gadget.Settings.write(theSettingName, aSettingValue);
  192.         } 
  193.         else 
  194.         {
  195.             // If we are in "development mode" - use a cookie instead
  196.             writeCookie(theSettingName,aSettingValue);
  197.         }
  198.     }
  199.     catch (objException) 
  200.     {
  201.     }
  202. }
  203. ////////////////////////////////////////////////////////////////////////////////
  204. //
  205. // readSetting(string theSettingName)- Reads a Setting
  206. //
  207. ////////////////////////////////////////////////////////////////////////////////
  208. function readSetting(theSettingName) 
  209. {
  210.     var retVal = "";
  211.     try
  212.     {
  213.         if (gGadgetMode) 
  214.         {
  215.             // If we are in "Gadget Mode", read value using that mechanism
  216.             retVal = System.Gadget.Settings.read(theSettingName);
  217.         } 
  218.         else 
  219.         {
  220.             // If we are in "development mode" - read from a cookie instead
  221.             retVal = readCookie(theSettingName);
  222.         }
  223.     }
  224.     catch (objException) 
  225.     {
  226.         retVal = null;
  227.     }
  228.     return retVal;
  229. }
  230. ////////////////////////////////////////////////////////////////////////////////
  231. //
  232. // writeCookie(string theCookieName, string aCookieValue) - Writes a cookie
  233. //
  234. ////////////////////////////////////////////////////////////////////////////////
  235. function writeCookie(theCookieName, aCookieValue) 
  236. {
  237.     var theCookieExpirationDate = new Date ();
  238.     // Set cookie to expire in 1 year
  239.     theCookieExpirationDate.setYear(theCookieExpirationDate.getYear() + 1);
  240.     // Convert to GMT
  241.     theCookieExpirationDate = theCookieExpirationDate.toGMTString ();
  242.     document.cookie = escape(theCookieName) + "=" + escape(aCookieValue) + "; expires=" + theCookieExpirationDate;
  243. }
  244. ////////////////////////////////////////////////////////////////////////////////
  245. //
  246. // readCookie(string theCookieName) - Reads a cookie
  247. //
  248. ////////////////////////////////////////////////////////////////////////////////
  249. function readCookie(theCookieName) 
  250. {
  251.     var aCookieValue = "";
  252.     var theCookies = ("" + document.cookie).split("; ");
  253.     for (var i=0; i < theCookies.length; i++)
  254.     {
  255.         if (theCookies[i].indexOf("=") > -1) 
  256.         {    
  257.             // If we have a non-empty cookie, extract the Cookie Name
  258.             var aCookieName = theCookies[i].split("=")[0];
  259.             if (aCookieName == theCookieName) 
  260.             {
  261.                 // If this is the one we're looking for, set that as our return value and get out
  262.                 aCookieValue = theCookies[i].split("=")[1];    
  263.                 break;
  264.             }
  265.         }
  266.     }
  267.     return aCookieValue; 
  268. }
  269.  
  270. ////////////////////////////////////////////////////////////////////////////////
  271. //
  272. // GENERAL UTILITIES
  273. //
  274. ////////////////////////////////////////////////////////////////////////////////
  275.  
  276. ////////////////////////////////////////////////////////////////////////////////
  277. //
  278. // showOrHide([object|string] oHTMLElement, boolean bShowOrHide)
  279. //    Shows or Hides an HTMLElement.    
  280. //    You can pass in the id to an object or the actual object
  281. //
  282. ////////////////////////////////////////////////////////////////////////////////
  283. function showOrHide(oHTMLElement, bShowOrHide) 
  284. {
  285.     try 
  286.     {
  287.         if (typeof(oHTMLElement)=="string") 
  288.         { 
  289.             oHTMLElement = document.getElementById(oHTMLElement); 
  290.         }
  291.         if (oHTMLElement && oHTMLElement.style) 
  292.         {
  293.             if (bShowOrHide == 'inherit') 
  294.             {
  295.                 oHTMLElement.style.visibility = 'inherit';
  296.             } 
  297.             else 
  298.             {
  299.                 if (bShowOrHide)
  300.                 {
  301.                     oHTMLElement.style.visibility = 'visible';
  302.                 }
  303.                 else
  304.                 {
  305.                     oHTMLElement.style.visibility = 'hidden';
  306.                 }
  307.                 try 
  308.                 {
  309.                     if (bShowOrHide)
  310.                     {
  311.                         oHTMLElement.style.display = 'block';
  312.                     }
  313.                     else
  314.                     {
  315.                         oHTMLElement.style.display = 'none';
  316.                     }
  317.                 }
  318.                 catch (ex) 
  319.                 {
  320.                 }
  321.             }
  322.         }
  323.     }
  324.     catch (ex) 
  325.     {
  326.     }
  327. }
  328. ////////////////////////////////////////////////////////////////////////////////
  329. //
  330. // setImage(oHTMLElement, imageURL) - places an image into an element
  331. //    applying alphaImageLoader as necessary
  332. //
  333. ////////////////////////////////////////////////////////////////////////////////
  334. function setImage(oHTMLElement, imageURL) {    
  335.     if (typeof(oHTMLElement)=="string") 
  336.     { 
  337.         oHTMLElement = document.getElementById(oHTMLElement); 
  338.     }
  339.     if (gGadgetMode) 
  340.     {
  341.         oHTMLElement.src = imageURL;
  342.     } 
  343.     else 
  344.     {
  345.         oHTMLElement.style.backgroundImage = "url(images/1px.gif)";
  346.         oHTMLElement.style.filter = "progid:DXImageTransform.Microsoft.AlphaImageLoader(src='" + imageURL + "',sizingMethod='scale')";
  347.     }
  348. }
  349. ////////////////////////////////////////////////////////////////////////////////
  350. //
  351. // getSpinner( string spinnerDivID ) - establishes a Spinner Object.
  352. //
  353. ////////////////////////////////////////////////////////////////////////////////
  354. function getSpinner( spinnerDivID ) 
  355. {
  356.     var self = this;
  357.     this.id = spinnerDivID;
  358.     this.parentDiv = document.getElementById( self.id );
  359.     this.fps = 1000/30;    
  360.     with ( this.parentDiv.style ) 
  361.     {
  362.         fontSize=0;
  363.         posWidth=16;
  364.         posHeight=16;
  365.         backgroundImage = 'url("images/activity16v.png")';
  366.         backgroundPositionY = 0;
  367.     }
  368.     this.hide    = function() 
  369.     { 
  370.         self.parentDiv.style.display='none';    
  371.     }
  372.     this.show    = function() 
  373.     { 
  374.         self.parentDiv.style.display='block'; 
  375.     }
  376.     this.stop    = function() 
  377.     { 
  378.         clearInterval( self.animationInterval ); 
  379.     }
  380.     this.start = function() 
  381.     {
  382.         clearInterval( self.animationInterval );
  383.         this.animationInterval = setInterval( 'animateSpinner(' + self.id + ')', 30 );
  384.     }
  385. } 
  386. ////////////////////////////////////////////////////////////////////////////////
  387. //
  388. // animateSpinner( oHTMLElement spinnerDiv ) - animates spinner image
  389. //
  390. ////////////////////////////////////////////////////////////////////////////////
  391. function animateSpinner(spinnerDiv) 
  392. {
  393.     spinnerDiv.style.backgroundPositionY=parseInt(spinnerDiv.style.backgroundPositionY)-16; 
  394. }
  395. ////////////////////////////////////////////////////////////////////////////////
  396. //
  397. // isVisible([object|string] oHTMLElement) - boolean of if Object visible.
  398. // You can pass in the id to an object or the actual object
  399. //
  400. ////////////////////////////////////////////////////////////////////////////////
  401. function isVisible(oHTMLElement) 
  402. {
  403.     var bIsVisible = true;
  404.     if (typeof(oHTMLElement)=="string") 
  405.     { 
  406.         oHTMLElement = document.getElementById(oHTMLElement); 
  407.     }
  408.     if (oHTMLElement && oHTMLElement.style) 
  409.     {
  410.         bIsVisible =    (oHTMLElement.style.display=='block');
  411.     }
  412.     return bIsVisible;
  413. }
  414. ////////////////////////////////////////////////////////////////////////////////
  415. //
  416. // getLocalizedString(string key) - returns localized string.
  417. //    Defaults to English version if not found
  418. //
  419. ////////////////////////////////////////////////////////////////////////////////
  420. function getLocalizedString(key) 
  421. {
  422.  var retVal = key;
  423.  try 
  424.  {
  425.     retVal = L_localizedStrings_Text[key];
  426.     if (retVal === undefined) 
  427.     {
  428.         retVal = key
  429.     }
  430.  }
  431.  catch (ex) 
  432.  {
  433.  }
  434.  return retVal;
  435. }
  436. ////////////////////////////////////////////////////////////////////////////////
  437. //
  438. // commify(string aNumber) - returns a number properly "commified" 
  439. //    with a comma every three digits nnn,nnn,nnn.nn
  440. //
  441. ////////////////////////////////////////////////////////////////////////////////
  442. function commify(aNumber) {
  443.     var retVal = aNumber;
  444.     var theDecimalValue="";
  445.     var oRegExp = new RegExp("[0-9]");
  446.     if (aNumber.length) 
  447.     {
  448.         if (aNumber.lastIndexOf(".") > -1) 
  449.         {
  450.             // If we have a number with decimal places, save off the value to the 
  451.             // right of the decimal place for later use
  452.             theDecimalValue = aNumber.substring(aNumber.lastIndexOf("."), aNumber.length);
  453.             // Strip off the decimal portion of the number
  454.             retVal = retVal.substring(0, retVal.lastIndexOf("."));
  455.         }
  456.         // Reverse the number
  457.         var aNewNumber = "";
  458.         for (var i=0;i<retVal.length;i++) 
  459.         {
  460.             var aChar = retVal.substring(i,i+1);
  461.             if (oRegExp.exec(aChar)) 
  462.             { 
  463.                 // So long as we have a numeric character, use it. Has the 
  464.                 // effect of stripping out any previous formatting from the number.
  465.                 aNewNumber = aChar + aNewNumber;
  466.             }
  467.         }
  468.         // Rebuild number from the beginning, adding a comma every 3 characters
  469.         retVal = "";
  470.         for (var i=0;i<aNewNumber.length;i++) 
  471.         {
  472.             retVal = aNewNumber.substring(i,i+1) + retVal;
  473.             if (((i+1) % 3 == 0) && (i+1<aNewNumber.length)) 
  474.             {
  475.                 retVal = ',' + retVal;
  476.             }
  477.         }
  478.         // Add the decimal value back to the end of the string
  479.         retVal += theDecimalValue;
  480.     }
  481.     return retVal;
  482. }
  483. ////////////////////////////////////////////////////////////////////////////////
  484. //
  485. // cleanURL(string aURL) - formats URLS like 
  486. //    http://www.microsoft.com/gadgets.html into 
  487. //    http:\/\/www.microsoft.com\/gadgets.html.    
  488. // Useful if Hyperlinks myst be passed around as strings via Javascript 
  489. //
  490. ////////////////////////////////////////////////////////////////////////////////
  491. function cleanURL(aURL) 
  492. {
  493.     return aURL.split('/').join('\\/');
  494. }
  495. ////////////////////////////////////////////////////////////////////////////////
  496. //
  497. // URLDecode(string aString) - decodes URLEncoded strings
  498. //
  499. ////////////////////////////////////////////////////////////////////////////////
  500. function URLDecode(aString) 
  501. {
  502.     aString = aString.replace("%2F", "/");
  503.     aString = aString.replace("%7C", "|");
  504.     aString = aString.replace("%3F", "?");
  505.     aString = aString.replace("%21", "!");
  506.     aString = aString.replace("%40", "@");
  507.     aString = aString.replace("%5C", "");
  508.     aString = aString.replace("%23", "#");
  509.     aString = aString.replace("%24", "$");
  510.     aString = aString.replace("%5E", "^");
  511.     aString = aString.replace("%26", "&");
  512.     aString = aString.replace("%25", "%");
  513.     aString = aString.replace("%2A", "*");
  514.     aString = aString.replace("%28", "(");
  515.     aString = aString.replace("%29", ")");
  516.     aString = aString.replace("%7D", "}");
  517.     aString = aString.replace("%3A", ":");
  518.     aString = aString.replace("%2C", ",");
  519.     aString = aString.replace("%7B", "{");
  520.     aString = aString.replace("%2B", "+");
  521.     aString = aString.replace("%2E", ".");
  522.     aString = aString.replace("%2D", "-");
  523.     aString = aString.replace("%7E", "~");
  524.     aString = aString.replace("%2D", "-");
  525.     aString = aString.replace("%5B", "[");
  526.     aString = aString.replace("%5F", "_");
  527.     aString = aString.replace("%5D", "]");
  528.     aString = aString.replace("%60", "`"); 
  529.     aString = aString.replace("%3D", "=");
  530.     aString = aString.replace("%27", "'");
  531.     aString = aString.replace("+", " ");
  532.     aString = aString.replace("%22", '"');
  533.     return aString;
  534. }
  535. ////////////////////////////////////////////////////////////////////////////////
  536. //
  537. // function setCaretPos(anInputElement, int startPoint, int endPoint)
  538. //    sets cursor selection within an input element
  539. //
  540. ////////////////////////////////////////////////////////////////////////////////
  541. function setCaretPos( anInputElement, startPoint, endPoint ) 
  542. {
  543.     var startPoint = startPoint || 0;
  544.     var endPoint    = endPoint || startPoint;
  545.     var theInputElement = anInputElement.createTextRange();
  546.     with ( theInputElement ) 
  547.     {
  548.         collapse(true);
  549.         moveEnd('character', endPoint);
  550.         moveStart('character', startPoint);
  551.         select();
  552.     } 
  553.     theInputElement = null;    
  554. }
  555.  
  556. ////////////////////////////////////////////////////////////////////////////////
  557. //
  558. // LOCATION AWARE API UTILITIES
  559. //
  560. ////////////////////////////////////////////////////////////////////////////////
  561.  
  562. ////////////////////////////////////////////////////////////////////////////////
  563. //
  564. // getAPILatLongReport( )    - returns a location report (latitude/longitude)
  565. //    throws an exception if values out of acceptable range
  566. //    polling report from api can also throw an exception on internal error
  567. ////////////////////////////////////////////////////////////////////////////////
  568. function getAPILatLongReport( MicrosoftGadgetObject )
  569. {
  570.     var report = MicrosoftGadgetObject.factory.LatLongReport;
  571.     if ( !( (report.Latitude >= -90) && (report.Latitude <= 90) && (report.Longitude <= 180) && (report.Longitude >= -180) ) )
  572.     {
  573.         throw "Latitude/Longitude outside acceptable range";
  574.     }
  575.     return report;
  576. }
  577.  
  578. ////////////////////////////////////////////////////////////////////////////////
  579. //
  580. // getAPIStatus( )    - returns current status from location API
  581. //    in case of exception, returns -1
  582. ////////////////////////////////////////////////////////////////////////////////
  583. function getAPIStatus( MicrosoftGadgetObject )
  584. {
  585.     var status = -1;
  586.  
  587.     try
  588.     {
  589.         status = MicrosoftGadgetObject.factory.Status;
  590.     }
  591.     catch ( err )
  592.     {
  593.         System.Debug.outputString ( "API returned error, polling for status. Gadget state indeterminate" );
  594.     }
  595.  
  596.     return status;
  597. }
  598.  
  599.  
  600. ////////////////////////////////////////////////////////////////////////////////
  601. //
  602. // DistanceMovedSinceLastPositionUpdate( )    - returns distance since last position update
  603. ////////////////////////////////////////////////////////////////////////////////
  604. function DistanceMovedSinceLastPositionUpdate(positionPrevious, positionCurrent)
  605. {
  606.     // KNOWN CONSTANTS
  607.     var degreesToRadians = Math.PI / 180;
  608.     var earthRadius = 6371; // approximation in kilometers assuming earth to be spherical
  609.  
  610.     // CONVERT LATITUDE AND LONGITUDE VALUES TO RADIANS
  611.     var previousRadianLat = positionPrevious.Latitude * degreesToRadians;
  612.     var previousRadianLong = positionPrevious.Longitude * degreesToRadians;
  613.     var currentRadianLat = positionCurrent.Latitude * degreesToRadians;
  614.     var currentRadianLong = positionCurrent.Longitude * degreesToRadians;
  615.  
  616.     // CALCULATE RADIAN DELTA BETWEEN THE TWO POSITIONS
  617.     var latitudeRadianDelta = currentRadianLat - previousRadianLat;
  618.     var longitudeRadianDelta = currentRadianLong - previousRadianLong; 
  619.  
  620.     var expr1 = ( Math.sin(latitudeRadianDelta / 2) * Math.sin(latitudeRadianDelta / 2) ) +
  621.                 ( Math.cos(previousRadianLat) * Math.cos(currentRadianLat) * Math.sin(longitudeRadianDelta/2) * Math.sin(longitudeRadianDelta/2) );
  622.     var expr2 = 2 * Math.atan2( Math.sqrt( expr1 ), Math.sqrt( 1 - expr1 ) );
  623.     var distanceValue = earthRadius * expr2;
  624.  
  625.     return distanceValue;
  626. }
  627.  
  628.  
  629. ////////////////////////////////////////////////////////////////////////////////
  630. //
  631. // CONSTANTS
  632. //
  633. ////////////////////////////////////////////////////////////////////////////////
  634.  
  635.     ////////////////////////////////////////////////////////////////////////////////
  636.     //
  637.     // GADGET STATES FOR LOCATION AWARENESS
  638.     //
  639.     ////////////////////////////////////////////////////////////////////////////////
  640.  
  641.     var LOCATION_SENSING_STATE_DISABLED = 0;
  642.     var LOCATION_SENSING_STATE_ERROR_AUTO = 1;
  643.     var LOCATION_SENSING_STATE_ERROR_MANUAL = 2;
  644.     var LOCATION_SENSING_STATE_OK_AUTO = 3;
  645.     var LOCATION_SENSING_STATE_OK_MANUAL = 4;
  646.     var LOCATION_SENSING_STATE_DISCONNECTED_AUTO = 5;
  647.     var LOCATION_SENSING_STATE_DISCONNECTED_MANUAL = 6;
  648.     var LOCATION_SENSING_STATE_INVALID = 7;
  649.  
  650.     var LOCATION_SENSING_VALID_STATES_ARRAY = new Array( LOCATION_SENSING_STATE_DISABLED ,
  651.     LOCATION_SENSING_STATE_ERROR_AUTO ,
  652.     LOCATION_SENSING_STATE_ERROR_MANUAL ,
  653.     LOCATION_SENSING_STATE_OK_AUTO ,
  654.     LOCATION_SENSING_STATE_OK_MANUAL ,
  655.     LOCATION_SENSING_STATE_DISCONNECTED_AUTO ,
  656.     LOCATION_SENSING_STATE_DISCONNECTED_MANUAL
  657.  );
  658.  
  659.     var LOCATION_SENSING_MANUAL_STATES_ARRAY = new Array( LOCATION_SENSING_STATE_ERROR_MANUAL ,
  660. LOCATION_SENSING_STATE_OK_MANUAL ,
  661. LOCATION_SENSING_STATE_DISCONNECTED_MANUAL
  662.  );
  663.  
  664.     var LOCATION_SENSING_AUTO_STATES_ARRAY = new Array(    LOCATION_SENSING_STATE_ERROR_AUTO ,
  665.     LOCATION_SENSING_STATE_OK_AUTO ,
  666.     LOCATION_SENSING_STATE_DISCONNECTED_AUTO );
  667.  
  668.  
  669. ////////////////////////////////////////////////////////////////////////////////
  670. //
  671. // ARRAY UTILITIES
  672. //
  673. ////////////////////////////////////////////////////////////////////////////////
  674. if ( !Array.prototype.exists )
  675. {
  676.     Array.prototype.exists = function( elementToSearch )
  677.     {
  678.         var numElements = this.length;
  679.  
  680.         var counter;
  681.  
  682.         for ( counter = 0 ; counter < numElements ; counter++ )
  683.         {
  684.             if ( counter in this && this[counter] === elementToSearch )
  685.                 return (true);
  686.         }
  687.  
  688.         return (false);
  689.     };
  690. }
  691.  
  692.