lib/paintweb/docs/api-ref/symbols/src/src_includes_lib.js.html

   1 <html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"> <style>
   2         .KEYW {color: #933;}
   3         .COMM {color: #bbb; font-style: italic;}
   4         .NUMB {color: #393;}
   5         .STRN {color: #393;}
   6         .REGX {color: #339;}
   7         .line {border-right: 1px dotted #666; color: #666; font-style: normal;}
   8         </style></head><body><pre><span class='line'>  1</span> <span class="COMM">/*
   9 <span class='line'>  2</span>  * © 2009 ROBO Design
  10 <span class='line'>  3</span>  * http://www.robodesign.ro
  11 <span class='line'>  4</span>  *
  12 <span class='line'>  5</span>  * $Date: 2009-07-30 19:20:27 +0300 $
  13 <span class='line'>  6</span>  */</span><span class="WHIT">
  14 <span class='line'>  7</span>
  15 <span class='line'>  8</span> </span><span class="COMM">/**
  16 <span class='line'>  9</span>  * @author &lt;a lang="ro" href="http://www.robodesign.ro/mihai">Mihai Şucan&lt;/a>
  17 <span class='line'> 10</span>  * @fileOverview Minimal JavaScript library which provides functionality for
  18 <span class='line'> 11</span>  * cross-browser compatibility support.
  19 <span class='line'> 12</span>  */</span><span class="WHIT">
  20 <span class='line'> 13</span>
  21 <span class='line'> 14</span> </span><span class="COMM">/**
  22 <span class='line'> 15</span>  * @namespace Holds methods and properties necessary throughout the entire
  23 <span class='line'> 16</span>  * application.
  24 <span class='line'> 17</span>  */</span><span class="WHIT">
  25 <span class='line'> 18</span> </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">pwlib</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
  26 <span class='line'> 19</span>
  27 <span class='line'> 20</span> </span><span class="COMM">/**
  28 <span class='line'> 21</span>  * @namespace Holds pre-packaged files.
  29 <span class='line'> 22</span>  * @type Object
  30 <span class='line'> 23</span>  */</span><span class="WHIT">
  31 <span class='line'> 24</span> </span><span class="NAME">pwlib.fileCache</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
  32 <span class='line'> 25</span>
  33 <span class='line'> 26</span> </span><span class="COMM">/**
  34 <span class='line'> 27</span>  * @namespace Holds the implementation of each drawing tool.
  35 <span class='line'> 28</span>  *
  36 <span class='line'> 29</span>  * @type Object
  37 <span class='line'> 30</span>  *
  38 <span class='line'> 31</span>  * @see PaintWeb#toolRegister Register a new drawing tool into a PaintWeb
  39 <span class='line'> 32</span>  * instance.
  40 <span class='line'> 33</span>  * @see PaintWeb#toolActivate Activate a drawing tool in a PaintWeb instance.
  41 <span class='line'> 34</span>  * @see PaintWeb#toolUnregister Unregister a drawing tool from a PaintWeb
  42 <span class='line'> 35</span>  * instance.
  43 <span class='line'> 36</span>  *
  44 <span class='line'> 37</span>  * @see PaintWeb.config.toolDefault The default tool being activated when
  45 <span class='line'> 38</span>  * a PaintWeb instance is initialized.
  46 <span class='line'> 39</span>  * @see PaintWeb.config.tools Holds the list of tools to be loaded automatically
  47 <span class='line'> 40</span>  * when a PaintWeb instance is initialized.
  48 <span class='line'> 41</span>  */</span><span class="WHIT">
  49 <span class='line'> 42</span> </span><span class="NAME">pwlib.tools</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
  50 <span class='line'> 43</span>
  51 <span class='line'> 44</span> </span><span class="COMM">/**
  52 <span class='line'> 45</span>  * @namespace Holds all the PaintWeb extensions.
  53 <span class='line'> 46</span>  *
  54 <span class='line'> 47</span>  * @type Object
  55 <span class='line'> 48</span>  * @see PaintWeb#extensionRegister Register a new extension into a PaintWeb
  56 <span class='line'> 49</span>  * instance.
  57 <span class='line'> 50</span>  * @see PaintWeb#extensionUnregister Unregister an extension from a PaintWeb
  58 <span class='line'> 51</span>  * instance.
  59 <span class='line'> 52</span>  * @see PaintWeb.config.extensions Holds the list of extensions to be loaded
  60 <span class='line'> 53</span>  * automatically when a PaintWeb instance is initialized.
  61 <span class='line'> 54</span>  */</span><span class="WHIT">
  62 <span class='line'> 55</span> </span><span class="NAME">pwlib.extensions</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
  63 <span class='line'> 56</span>
  64 <span class='line'> 57</span> </span><span class="COMM">/**
  65 <span class='line'> 58</span>  * This function extends objects.
  66 <span class='line'> 59</span>  *
  67 <span class='line'> 60</span>  * @example
  68 <span class='line'> 61</span>  * &lt;code>var &lt;var>obj1&lt;/var> = {a: 'a1', b: 'b1', d: 'd1'},
  69 <span class='line'> 62</span>  *     &lt;var>obj2&lt;/var> = {a: 'a2', b: 'b2', c: 'c2'};
  70 <span class='line'> 63</span>  *
  71 <span class='line'> 64</span>  * pwlib.extend(&lt;var>obj1&lt;/var>, &lt;var>obj2&lt;/var>);&lt;/code>
  72 <span class='line'> 65</span>  *
  73 <span class='line'> 66</span>  * // Now &lt;var>obj1.c == 'c2'&lt;/var>, while &lt;var>obj1.a&lt;/var>, &lt;var>obj1.b&lt;/var>
  74 <span class='line'> 67</span>  * // and &lt;var>obj1.d&lt;/var> remain the same.
  75 <span class='line'> 68</span>  *
  76 <span class='line'> 69</span>  * // If &lt;code>pwlib.extend(true, &lt;var>obj1&lt;/var>, &lt;var>obj2&lt;/var>)&lt;/code> is
  77 <span class='line'> 70</span>  * // called, then &lt;var>obj1.a&lt;/var>, &lt;var>obj1.b&lt;/var>, &lt;var>obj1.c&lt;/var>
  78 <span class='line'> 71</span>  * // become all the same as in &lt;var>obj2&lt;/var>.
  79 <span class='line'> 72</span>  *
  80 <span class='line'> 73</span>  * @example
  81 <span class='line'> 74</span>  * &lt;code>var &lt;var>obj1&lt;/var> = {a: 'a1', b: 'b1', extend: pwlib.extend};
  82 <span class='line'> 75</span>  * &lt;var>obj1&lt;/var>.extend({c: 'c1', d: 'd1'});&lt;/code>
  83 <span class='line'> 76</span>  *
  84 <span class='line'> 77</span>  * // In this case the destination object which is to be extend is
  85 <span class='line'> 78</span>  * // &lt;var>obj1&lt;/var>.
  86 <span class='line'> 79</span>  *
  87 <span class='line'> 80</span>  * @param {Boolean} [overwrite=false] If the first argument is a boolean, then
  88 <span class='line'> 81</span>  * it will be considered as a boolean flag for overwriting (or not) any existing
  89 <span class='line'> 82</span>  * methods and properties in the destination object. Thus, any method and
  90 <span class='line'> 83</span>  * property from the source object will take over those in the destination. The
  91 <span class='line'> 84</span>  * argument is optional, and if it's omitted, then no method/property will be
  92 <span class='line'> 85</span>  * overwritten.
  93 <span class='line'> 86</span>  *
  94 <span class='line'> 87</span>  * @param {Object} [destination=this] The second argument is the optional
  95 <span class='line'> 88</span>  * destination object: the object which will be extended. By default, the
  96 <span class='line'> 89</span>  * &lt;var>this&lt;/var> object will be extended.
  97 <span class='line'> 90</span>  *
  98 <span class='line'> 91</span>  * @param {Object} source The third argument must provide list of methods and
  99 <span class='line'> 92</span>  * properties which will be added to the destination object.
 100 <span class='line'> 93</span>  */</span><span class="WHIT">
 101 <span class='line'> 94</span> </span><span class="NAME">pwlib.extend</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 102 <span class='line'> 95</span> </span><span class="WHIT">  </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">name</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">src</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">sval</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">dval</span><span class="PUNC">;</span><span class="WHIT">
 103 <span class='line'> 96</span>
 104 <span class='line'> 97</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">arguments</span><span class="PUNC">[</span><span class="NUMB">0</span><span class="PUNC">]</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'boolean'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 105 <span class='line'> 98</span> </span><span class="WHIT">    </span><span class="NAME">force</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">arguments</span><span class="PUNC">[</span><span class="NUMB">0</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
 106 <span class='line'> 99</span> </span><span class="WHIT">    </span><span class="NAME">dest</span><span class="WHIT">  </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">arguments</span><span class="PUNC">[</span><span class="NUMB">1</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
 107 <span class='line'>100</span> </span><span class="WHIT">    </span><span class="NAME">src</span><span class="WHIT">   </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">arguments</span><span class="PUNC">[</span><span class="NUMB">2</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
 108 <span class='line'>101</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 109 <span class='line'>102</span> </span><span class="WHIT">    </span><span class="NAME">force</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
 110 <span class='line'>103</span> </span><span class="WHIT">    </span><span class="NAME">dest</span><span class="WHIT">  </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">arguments</span><span class="PUNC">[</span><span class="NUMB">0</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
 111 <span class='line'>104</span> </span><span class="WHIT">    </span><span class="NAME">src</span><span class="WHIT">   </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">arguments</span><span class="PUNC">[</span><span class="NUMB">1</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
 112 <span class='line'>105</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 113 <span class='line'>106</span>
 114 <span class='line'>107</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">src</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'undefined'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 115 <span class='line'>108</span> </span><span class="WHIT">    </span><span class="NAME">src</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">dest</span><span class="PUNC">;</span><span class="WHIT">
 116 <span class='line'>109</span> </span><span class="WHIT">    </span><span class="NAME">dest</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">this</span><span class="PUNC">;</span><span class="WHIT">
 117 <span class='line'>110</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 118 <span class='line'>111</span>
 119 <span class='line'>112</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">dest</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'undefined'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 120 <span class='line'>113</span> </span><span class="WHIT">    </span><span class="KEYW">return</span><span class="PUNC">;</span><span class="WHIT">
 121 <span class='line'>114</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 122 <span class='line'>115</span>
 123 <span class='line'>116</span> </span><span class="WHIT">  </span><span class="KEYW">for</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">name</span><span class="WHIT"> </span><span class="KEYW">in</span><span class="WHIT"> </span><span class="NAME">src</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 124 <span class='line'>117</span> </span><span class="WHIT">    </span><span class="NAME">sval</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">src</span><span class="PUNC">[</span><span class="NAME">name</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
 125 <span class='line'>118</span> </span><span class="WHIT">    </span><span class="NAME">dval</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">dest</span><span class="PUNC">[</span><span class="NAME">name</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
 126 <span class='line'>119</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">force</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">dval</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'undefined'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 127 <span class='line'>120</span> </span><span class="WHIT">      </span><span class="NAME">dest</span><span class="PUNC">[</span><span class="NAME">name</span><span class="PUNC">]</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">sval</span><span class="PUNC">;</span><span class="WHIT">
 128 <span class='line'>121</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
 129 <span class='line'>122</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 130 <span class='line'>123</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 131 <span class='line'>124</span>
 132 <span class='line'>125</span> </span><span class="COMM">/**
 133 <span class='line'>126</span>  * Retrieve a string formatted with the provided variables.
 134 <span class='line'>127</span>  *
 135 <span class='line'>128</span>  * &lt;p>The language string must be available in the global &lt;var>lang&lt;/var>
 136 <span class='line'>129</span>  * object.
 137 <span class='line'>130</span>  *
 138 <span class='line'>131</span>  * &lt;p>The string can contain any number of variables in the form of
 139 <span class='line'>132</span>  * &lt;code>{var_name}&lt;/code>.
 140 <span class='line'>133</span>  *
 141 <span class='line'>134</span>  * @example
 142 <span class='line'>135</span>  * lang.table_cells = "The table {name} has {n} cells.";
 143 <span class='line'>136</span>  *
 144 <span class='line'>137</span>  * // later ...
 145 <span class='line'>138</span>  * console.log(pwlib.strf(lang.table_cells, {'name' : 'tbl1', 'n' : 11}));
 146 <span class='line'>139</span>  * // The output is 'The table tbl1 has 11 cells.'
 147 <span class='line'>140</span>  *
 148 <span class='line'>141</span>  * @param {String} str The string you want to output.
 149 <span class='line'>142</span>  *
 150 <span class='line'>143</span>  * @param {Object} [vars] The variables you want to set in the language string.
 151 <span class='line'>144</span>  *
 152 <span class='line'>145</span>  * @returns {String} The string updated with the variables you provided.
 153 <span class='line'>146</span>  */</span><span class="WHIT">
 154 <span class='line'>147</span> </span><span class="NAME">pwlib.strf</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">str</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">vars</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 155 <span class='line'>148</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">str</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 156 <span class='line'>149</span> </span><span class="WHIT">    </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="NAME">str</span><span class="PUNC">;</span><span class="WHIT">
 157 <span class='line'>150</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 158 <span class='line'>151</span>
 159 <span class='line'>152</span> </span><span class="WHIT">  </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">re</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">i</span><span class="PUNC">;</span><span class="WHIT">
 160 <span class='line'>153</span>
 161 <span class='line'>154</span> </span><span class="WHIT">  </span><span class="KEYW">for</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">i</span><span class="WHIT"> </span><span class="KEYW">in</span><span class="WHIT"> </span><span class="NAME">vars</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 162 <span class='line'>155</span> </span><span class="WHIT">    </span><span class="NAME">re</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">RegExp</span><span class="PUNC">(</span><span class="STRN">'{'</span><span class="WHIT"> </span><span class="PUNC">+</span><span class="WHIT"> </span><span class="NAME">i</span><span class="WHIT"> </span><span class="PUNC">+</span><span class="WHIT"> </span><span class="STRN">'}'</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'g'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 163 <span class='line'>156</span> </span><span class="WHIT">    </span><span class="NAME">str</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">str.replace</span><span class="PUNC">(</span><span class="NAME">re</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">vars</span><span class="PUNC">[</span><span class="NAME">i</span><span class="PUNC">]</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 164 <span class='line'>157</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 165 <span class='line'>158</span>
 166 <span class='line'>159</span> </span><span class="WHIT">  </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="NAME">str</span><span class="PUNC">;</span><span class="WHIT">
 167 <span class='line'>160</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 168 <span class='line'>161</span>
 169 <span class='line'>162</span> </span><span class="COMM">/**
 170 <span class='line'>163</span>  * Parse a JSON string. This method uses the global JSON parser provided by
 171 <span class='line'>164</span>  * the browser natively. The small difference is that this method allows
 172 <span class='line'>165</span>  * normal JavaScript comments in the JSON string.
 173 <span class='line'>166</span>  *
 174 <span class='line'>167</span>  * @param {String} str The JSON string to parse.
 175 <span class='line'>168</span>  * @returns The JavaScript object that was parsed.
 176 <span class='line'>169</span>  */</span><span class="WHIT">
 177 <span class='line'>170</span> </span><span class="NAME">pwlib.jsonParse</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">str</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 178 <span class='line'>171</span> </span><span class="WHIT">  </span><span class="NAME">str</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">str.replace</span><span class="PUNC">(</span><span class="REGX">/\s*\/\*(\s|.)+?\*\//g</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">''</span><span class="PUNC">)</span><span class="PUNC">.</span><span class="WHIT">
 179 <span class='line'>172</span> </span><span class="WHIT">            </span><span class="NAME">replace</span><span class="PUNC">(</span><span class="REGX">/^\s*\/\/.*$/gm</span><span class="PUNC">,</span><span class="WHIT">        </span><span class="STRN">''</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 180 <span class='line'>173</span>
 181 <span class='line'>174</span> </span><span class="WHIT">  </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="NAME">JSON.parse</span><span class="PUNC">(</span><span class="NAME">str</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 182 <span class='line'>175</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 183 <span class='line'>176</span>
 184 <span class='line'>177</span> </span><span class="COMM">/**
 185 <span class='line'>178</span>  * Load a file from a given URL using XMLHttpRequest.
 186 <span class='line'>179</span>  *
 187 <span class='line'>180</span>  * @param {String} url The URL you want to load.
 188 <span class='line'>181</span>  *
 189 <span class='line'>182</span>  * @param {Function} handler The &lt;code>onreadystatechange&lt;/code> event handler
 190 <span class='line'>183</span>  * for the XMLHttpRequest object. Your event handler will always receive the
 191 <span class='line'>184</span>  * XMLHttpRequest object as the first parameter.
 192 <span class='line'>185</span>  *
 193 <span class='line'>186</span>  * @param {String} [method="GET"] The HTTP method to use for loading the URL.
 194 <span class='line'>187</span>  *
 195 <span class='line'>188</span>  * @param {String} [send] The string you want to send in an HTTP POST request.
 196 <span class='line'>189</span>  *
 197 <span class='line'>190</span>  * @param {Object} [headers] An object holding the header names and values you
 198 <span class='line'>191</span>  * want to set for the request.
 199 <span class='line'>192</span>  *
 200 <span class='line'>193</span>  * @returns {XMLHttpRequest} The XMLHttpRequest object created by this method.
 201 <span class='line'>194</span>  */</span><span class="WHIT">
 202 <span class='line'>195</span> </span><span class="NAME">pwlib.xhrLoad</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">url</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">handler</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">method</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">send</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">headers</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 203 <span class='line'>196</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">url</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 204 <span class='line'>197</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a string!'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 205 <span class='line'>198</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 206 <span class='line'>199</span>
 207 <span class='line'>200</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">method</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 208 <span class='line'>201</span> </span><span class="WHIT">    </span><span class="NAME">method</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="STRN">'GET'</span><span class="PUNC">;</span><span class="WHIT">
 209 <span class='line'>202</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 210 <span class='line'>203</span>
 211 <span class='line'>204</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">headers</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 212 <span class='line'>205</span> </span><span class="WHIT">    </span><span class="NAME">headers</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 213 <span class='line'>206</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 214 <span class='line'>207</span>
 215 <span class='line'>208</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">send</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 216 <span class='line'>209</span> </span><span class="WHIT">    </span><span class="NAME">send</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
 217 <span class='line'>210</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 218 <span class='line'>211</span>
 219 <span class='line'>212</span> </span><span class="WHIT">  </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">xhr</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">XMLHttpRequest</span><span class="PUNC">(</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 220 <span class='line'>213</span> </span><span class="WHIT">  </span><span class="NAME">xhr.onreadystatechange</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT"> </span><span class="NAME">handler</span><span class="PUNC">(</span><span class="NAME">xhr</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT"> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 221 <span class='line'>214</span> </span><span class="WHIT">  </span><span class="NAME">xhr.open</span><span class="PUNC">(</span><span class="NAME">method</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">url</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 222 <span class='line'>215</span>
 223 <span class='line'>216</span> </span><span class="WHIT">  </span><span class="KEYW">for</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">header</span><span class="WHIT"> </span><span class="KEYW">in</span><span class="WHIT"> </span><span class="NAME">headers</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 224 <span class='line'>217</span> </span><span class="WHIT">    </span><span class="NAME">xhr.setRequestHeader</span><span class="PUNC">(</span><span class="NAME">header</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">headers</span><span class="PUNC">[</span><span class="NAME">header</span><span class="PUNC">]</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 225 <span class='line'>218</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 226 <span class='line'>219</span>
 227 <span class='line'>220</span> </span><span class="WHIT">  </span><span class="NAME">xhr.send</span><span class="PUNC">(</span><span class="NAME">send</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 228 <span class='line'>221</span>
 229 <span class='line'>222</span> </span><span class="WHIT">  </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="NAME">xhr</span><span class="PUNC">;</span><span class="WHIT">
 230 <span class='line'>223</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 231 <span class='line'>224</span>
 232 <span class='line'>225</span> </span><span class="COMM">/**
 233 <span class='line'>226</span>  * Check if an URL points to a resource from the same host as the desired one.
 234 <span class='line'>227</span>  *
 235 <span class='line'>228</span>  * &lt;p>Note that data URIs always return true.
 236 <span class='line'>229</span>  *
 237 <span class='line'>230</span>  * @param {String} url The URL you want to check.
 238 <span class='line'>231</span>  * @param {String} host The host you want in the URL.
 239 <span class='line'>232</span>  *
 240 <span class='line'>233</span>  * @returns {Boolean} True if the &lt;var>url&lt;/var> points to a resource from the
 241 <span class='line'>234</span>  * &lt;var>host&lt;/var> given, or false otherwise.
 242 <span class='line'>235</span>  */</span><span class="WHIT">
 243 <span class='line'>236</span> </span><span class="NAME">pwlib.isSameHost</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">url</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">host</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 244 <span class='line'>237</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">url</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="PUNC">!</span><span class="NAME">host</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 245 <span class='line'>238</span> </span><span class="WHIT">    </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
 246 <span class='line'>239</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 247 <span class='line'>240</span>
 248 <span class='line'>241</span> </span><span class="WHIT">  </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">pos</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">url.indexOf</span><span class="PUNC">(</span><span class="STRN">':'</span><span class="PUNC">)</span><span class="PUNC">,</span><span class="WHIT">
 249 <span class='line'>242</span> </span><span class="WHIT">      </span><span class="NAME">proto</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">url.substr</span><span class="PUNC">(</span><span class="NUMB">0</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">pos</span><span class="WHIT"> </span><span class="PUNC">+</span><span class="WHIT"> </span><span class="NUMB">1</span><span class="PUNC">)</span><span class="PUNC">.</span><span class="NAME">toLowerCase</span><span class="PUNC">(</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 250 <span class='line'>243</span>
 251 <span class='line'>244</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">proto</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'data:'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 252 <span class='line'>245</span> </span><span class="WHIT">    </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">true</span><span class="PUNC">;</span><span class="WHIT">
 253 <span class='line'>246</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 254 <span class='line'>247</span>
 255 <span class='line'>248</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">proto</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'http:'</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">proto</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'https:'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 256 <span class='line'>249</span> </span><span class="WHIT">    </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
 257 <span class='line'>250</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 258 <span class='line'>251</span>
 259 <span class='line'>252</span> </span><span class="WHIT">  </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">urlHost</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">url.replace</span><span class="PUNC">(</span><span class="REGX">/^https?:\/\//i</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">''</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 260 <span class='line'>253</span> </span><span class="WHIT">  </span><span class="NAME">pos</span><span class="WHIT">  </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">urlHost.indexOf</span><span class="PUNC">(</span><span class="STRN">'/'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 261 <span class='line'>254</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">pos</span><span class="WHIT"> </span><span class="PUNC">></span><span class="WHIT"> </span><span class="PUNC">-</span><span class="NUMB">1</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 262 <span class='line'>255</span> </span><span class="WHIT">    </span><span class="NAME">urlHost</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">urlHost.substr</span><span class="PUNC">(</span><span class="NUMB">0</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">pos</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 263 <span class='line'>256</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 264 <span class='line'>257</span>
 265 <span class='line'>258</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">urlHost</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="NAME">host</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 266 <span class='line'>259</span> </span><span class="WHIT">    </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
 267 <span class='line'>260</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 268 <span class='line'>261</span>
 269 <span class='line'>262</span> </span><span class="WHIT">  </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">true</span><span class="PUNC">;</span><span class="WHIT">
 270 <span class='line'>263</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 271 <span class='line'>264</span>
 272 <span class='line'>265</span> </span><span class="COMM">/**
 273 <span class='line'>266</span>  * @class Custom application event.
 274 <span class='line'>267</span>  *
 275 <span class='line'>268</span>  * @param {String} type Event type.
 276 <span class='line'>269</span>  * @param {Boolean} [cancelable=false] Tells if the event can be cancelled or
 277 <span class='line'>270</span>  * not.
 278 <span class='line'>271</span>  *
 279 <span class='line'>272</span>  * @throws {TypeError} If the &lt;var>type&lt;/var> parameter is not a string.
 280 <span class='line'>273</span>  * @throws {TypeError} If the &lt;var>cancelable&lt;/var> parameter is not a string.
 281 <span class='line'>274</span>  *
 282 <span class='line'>275</span>  * @see pwlib.appEvents for the application events interface which allows adding
 283 <span class='line'>276</span>  * and removing event listeners.
 284 <span class='line'>277</span>  */</span><span class="WHIT">
 285 <span class='line'>278</span> </span><span class="NAME">pwlib.appEvent</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">type</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">cancelable</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 286 <span class='line'>279</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">type</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 287 <span class='line'>280</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a string'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 288 <span class='line'>281</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">cancelable</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'undefined'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 289 <span class='line'>282</span> </span><span class="WHIT">    </span><span class="NAME">cancelable</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
 290 <span class='line'>283</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">cancelable</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'boolean'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 291 <span class='line'>284</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The second argument must be a boolean'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 292 <span class='line'>285</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 293 <span class='line'>286</span>
 294 <span class='line'>287</span> </span><span class="WHIT">  </span><span class="COMM">/**
 295 <span class='line'>288</span>    * Event target object.
 296 <span class='line'>289</span>    * @type Object
 297 <span class='line'>290</span>    */</span><span class="WHIT">
 298 <span class='line'>291</span> </span><span class="WHIT">  </span><span class="NAME">this.target</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
 299 <span class='line'>292</span>
 300 <span class='line'>293</span> </span><span class="WHIT">  </span><span class="COMM">/**
 301 <span class='line'>294</span>    * Tells if the event can be cancelled or not.
 302 <span class='line'>295</span>    * @type Boolean
 303 <span class='line'>296</span>    */</span><span class="WHIT">
 304 <span class='line'>297</span> </span><span class="WHIT">  </span><span class="NAME">this.cancelable</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">cancelable</span><span class="PUNC">;</span><span class="WHIT">
 305 <span class='line'>298</span>
 306 <span class='line'>299</span> </span><span class="WHIT">  </span><span class="COMM">/**
 307 <span class='line'>300</span>    * Tells if the event has the default action prevented or not.
 308 <span class='line'>301</span>    * @type Boolean
 309 <span class='line'>302</span>    */</span><span class="WHIT">
 310 <span class='line'>303</span> </span><span class="WHIT">  </span><span class="NAME">this.defaultPrevented</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
 311 <span class='line'>304</span>
 312 <span class='line'>305</span> </span><span class="WHIT">  </span><span class="COMM">/**
 313 <span class='line'>306</span>    * Event type.
 314 <span class='line'>307</span>    * @type String
 315 <span class='line'>308</span>    */</span><span class="WHIT">
 316 <span class='line'>309</span> </span><span class="WHIT">  </span><span class="NAME">this.type</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">type</span><span class="PUNC">;</span><span class="WHIT">
 317 <span class='line'>310</span>
 318 <span class='line'>311</span> </span><span class="WHIT">  </span><span class="COMM">/**
 319 <span class='line'>312</span>    * Prevent the default action of the event.
 320 <span class='line'>313</span>    */</span><span class="WHIT">
 321 <span class='line'>314</span> </span><span class="WHIT">  </span><span class="NAME">this.preventDefault</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 322 <span class='line'>315</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">cancelable</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 323 <span class='line'>316</span> </span><span class="WHIT">      </span><span class="NAME">this.defaultPrevented</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">true</span><span class="PUNC">;</span><span class="WHIT">
 324 <span class='line'>317</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
 325 <span class='line'>318</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 326 <span class='line'>319</span>
 327 <span class='line'>320</span> </span><span class="WHIT">  </span><span class="COMM">/**
 328 <span class='line'>321</span>    * Stop the event propagation to other event handlers.
 329 <span class='line'>322</span>    */</span><span class="WHIT">
 330 <span class='line'>323</span> </span><span class="WHIT">  </span><span class="NAME">this.stopPropagation</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 331 <span class='line'>324</span> </span><span class="WHIT">    </span><span class="NAME">this.propagationStopped_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">true</span><span class="PUNC">;</span><span class="WHIT">
 332 <span class='line'>325</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 333 <span class='line'>326</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 334 <span class='line'>327</span>
 335 <span class='line'>328</span> </span><span class="COMM">/**
 336 <span class='line'>329</span>  * @class Application initialization event. This event is not cancelable.
 337 <span class='line'>330</span>  *
 338 <span class='line'>331</span>  * @augments pwlib.appEvent
 339 <span class='line'>332</span>  *
 340 <span class='line'>333</span>  * @param {Number} state The initialization state.
 341 <span class='line'>334</span>  * @param {String} [errorMessage] The error message, if any.
 342 <span class='line'>335</span>  *
 343 <span class='line'>336</span>  * @throws {TypeError} If the &lt;var>state&lt;/var> is not a number.
 344 <span class='line'>337</span>  */</span><span class="WHIT">
 345 <span class='line'>338</span> </span><span class="NAME">pwlib.appEvent.appInit</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">state</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">errorMessage</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 346 <span class='line'>339</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">state</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'number'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 347 <span class='line'>340</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a number.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 348 <span class='line'>341</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 349 <span class='line'>342</span>
 350 <span class='line'>343</span> </span><span class="WHIT">  </span><span class="COMM">/**
 351 <span class='line'>344</span>    * Application initialization not started.
 352 <span class='line'>345</span>    * @constant
 353 <span class='line'>346</span>    */</span><span class="WHIT">
 354 <span class='line'>347</span> </span><span class="WHIT">  </span><span class="NAME">this.INIT_NOT_STARTED</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NUMB">0</span><span class="PUNC">;</span><span class="WHIT">
 355 <span class='line'>348</span>
 356 <span class='line'>349</span> </span><span class="WHIT">  </span><span class="COMM">/**
 357 <span class='line'>350</span>    * Application initialization started.
 358 <span class='line'>351</span>    * @constant
 359 <span class='line'>352</span>    */</span><span class="WHIT">
 360 <span class='line'>353</span> </span><span class="WHIT">  </span><span class="NAME">this.INIT_STARTED</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NUMB">1</span><span class="PUNC">;</span><span class="WHIT">
 361 <span class='line'>354</span>
 362 <span class='line'>355</span> </span><span class="WHIT">  </span><span class="COMM">/**
 363 <span class='line'>356</span>    * Application initialization completed successfully.
 364 <span class='line'>357</span>    * @constant
 365 <span class='line'>358</span>    */</span><span class="WHIT">
 366 <span class='line'>359</span> </span><span class="WHIT">  </span><span class="NAME">this.INIT_DONE</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NUMB">2</span><span class="PUNC">;</span><span class="WHIT">
 367 <span class='line'>360</span>
 368 <span class='line'>361</span> </span><span class="WHIT">  </span><span class="COMM">/**
 369 <span class='line'>362</span>    * Application initialization failed.
 370 <span class='line'>363</span>    * @constant
 371 <span class='line'>364</span>    */</span><span class="WHIT">
 372 <span class='line'>365</span> </span><span class="WHIT">  </span><span class="NAME">this.INIT_ERROR</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">-</span><span class="NUMB">1</span><span class="PUNC">;</span><span class="WHIT">
 373 <span class='line'>366</span>
 374 <span class='line'>367</span> </span><span class="WHIT">  </span><span class="COMM">/**
 375 <span class='line'>368</span>    * Initialization state.
 376 <span class='line'>369</span>    * @type Number
 377 <span class='line'>370</span>    */</span><span class="WHIT">
 378 <span class='line'>371</span> </span><span class="WHIT">  </span><span class="NAME">this.state</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">state</span><span class="PUNC">;</span><span class="WHIT">
 379 <span class='line'>372</span>
 380 <span class='line'>373</span> </span><span class="WHIT">  </span><span class="COMM">/**
 381 <span class='line'>374</span>    * Initialization error message, if any.
 382 <span class='line'>375</span>    * @type String|null
 383 <span class='line'>376</span>    */</span><span class="WHIT">
 384 <span class='line'>377</span> </span><span class="WHIT">  </span><span class="NAME">this.errorMessage</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">errorMessage</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
 385 <span class='line'>378</span>
 386 <span class='line'>379</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'appInit'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 387 <span class='line'>380</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 388 <span class='line'>381</span>
 389 <span class='line'>382</span> </span><span class="COMM">/**
 390 <span class='line'>383</span>  * @class Application destroy event. This event is not cancelable.
 391 <span class='line'>384</span>  *
 392 <span class='line'>385</span>  * @augments pwlib.appEvent
 393 <span class='line'>386</span>  */</span><span class="WHIT">
 394 <span class='line'>387</span> </span><span class="NAME">pwlib.appEvent.appDestroy</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 395 <span class='line'>388</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'appDestroy'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 396 <span class='line'>389</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 397 <span class='line'>390</span>
 398 <span class='line'>391</span> </span><span class="COMM">/**
 399 <span class='line'>392</span>  * @class GUI show event. This event is not cancelable.
 400 <span class='line'>393</span>  *
 401 <span class='line'>394</span>  * @augments pwlib.appEvent
 402 <span class='line'>395</span>  */</span><span class="WHIT">
 403 <span class='line'>396</span> </span><span class="NAME">pwlib.appEvent.guiShow</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 404 <span class='line'>397</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'guiShow'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 405 <span class='line'>398</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 406 <span class='line'>399</span>
 407 <span class='line'>400</span> </span><span class="COMM">/**
 408 <span class='line'>401</span>  * @class GUI hide event. This event is not cancelable.
 409 <span class='line'>402</span>  *
 410 <span class='line'>403</span>  * @augments pwlib.appEvent
 411 <span class='line'>404</span>  */</span><span class="WHIT">
 412 <span class='line'>405</span> </span><span class="NAME">pwlib.appEvent.guiHide</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 413 <span class='line'>406</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'guiHide'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 414 <span class='line'>407</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 415 <span class='line'>408</span>
 416 <span class='line'>409</span> </span><span class="COMM">/**
 417 <span class='line'>410</span>  * @class Tool preactivation event. This event is cancelable.
 418 <span class='line'>411</span>  *
 419 <span class='line'>412</span>  * @augments pwlib.appEvent
 420 <span class='line'>413</span>  *
 421 <span class='line'>414</span>  * @param {String} id The ID of the new tool being activated.
 422 <span class='line'>415</span>  * @param {String|null} prevId The ID of the previous tool.
 423 <span class='line'>416</span>  *
 424 <span class='line'>417</span>  * @throws {TypeError} If the &lt;var>id&lt;/var> is not a string.
 425 <span class='line'>418</span>  * @throws {TypeError} If the &lt;var>prevId&lt;/var> is not a string or null.
 426 <span class='line'>419</span>  */</span><span class="WHIT">
 427 <span class='line'>420</span> </span><span class="NAME">pwlib.appEvent.toolPreactivate</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">id</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">prevId</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 428 <span class='line'>421</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 429 <span class='line'>422</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a string.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 430 <span class='line'>423</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">prevId</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">prevId</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 431 <span class='line'>424</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The second argument must be a string or null.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 432 <span class='line'>425</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 433 <span class='line'>426</span>
 434 <span class='line'>427</span> </span><span class="WHIT">  </span><span class="COMM">/**
 435 <span class='line'>428</span>    * Tool ID.
 436 <span class='line'>429</span>    * @type String
 437 <span class='line'>430</span>    */</span><span class="WHIT">
 438 <span class='line'>431</span> </span><span class="WHIT">  </span><span class="NAME">this.id</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">id</span><span class="PUNC">;</span><span class="WHIT">
 439 <span class='line'>432</span>
 440 <span class='line'>433</span> </span><span class="WHIT">  </span><span class="COMM">/**
 441 <span class='line'>434</span>    * Previous tool ID.
 442 <span class='line'>435</span>    * @type String
 443 <span class='line'>436</span>    */</span><span class="WHIT">
 444 <span class='line'>437</span> </span><span class="WHIT">  </span><span class="NAME">this.prevId</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">prevId</span><span class="PUNC">;</span><span class="WHIT">
 445 <span class='line'>438</span>
 446 <span class='line'>439</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'toolPreactivate'</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="KEYW">true</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 447 <span class='line'>440</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 448 <span class='line'>441</span>
 449 <span class='line'>442</span> </span><span class="COMM">/**
 450 <span class='line'>443</span>  * @class Tool activation event. This event is not cancelable.
 451 <span class='line'>444</span>  *
 452 <span class='line'>445</span>  * @augments pwlib.appEvent
 453 <span class='line'>446</span>  *
 454 <span class='line'>447</span>  * @param {String} id The ID the tool which was activated.
 455 <span class='line'>448</span>  * @param {String|null} prevId The ID of the previous tool.
 456 <span class='line'>449</span>  *
 457 <span class='line'>450</span>  * @throws {TypeError} If the &lt;var>id&lt;/var> is not a string.
 458 <span class='line'>451</span>  * @throws {TypeError} If the &lt;var>prevId&lt;/var> is not a string or null.
 459 <span class='line'>452</span>  */</span><span class="WHIT">
 460 <span class='line'>453</span> </span><span class="NAME">pwlib.appEvent.toolActivate</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">id</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">prevId</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 461 <span class='line'>454</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 462 <span class='line'>455</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a string.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 463 <span class='line'>456</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">prevId</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">prevId</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 464 <span class='line'>457</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The second argument must be a string or null.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 465 <span class='line'>458</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 466 <span class='line'>459</span>
 467 <span class='line'>460</span> </span><span class="WHIT">  </span><span class="COMM">/**
 468 <span class='line'>461</span>    * Tool ID.
 469 <span class='line'>462</span>    * @type String
 470 <span class='line'>463</span>    */</span><span class="WHIT">
 471 <span class='line'>464</span> </span><span class="WHIT">  </span><span class="NAME">this.id</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">id</span><span class="PUNC">;</span><span class="WHIT">
 472 <span class='line'>465</span>
 473 <span class='line'>466</span> </span><span class="WHIT">  </span><span class="COMM">/**
 474 <span class='line'>467</span>    * Previous tool ID.
 475 <span class='line'>468</span>    * @type String
 476 <span class='line'>469</span>    */</span><span class="WHIT">
 477 <span class='line'>470</span> </span><span class="WHIT">  </span><span class="NAME">this.prevId</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">prevId</span><span class="PUNC">;</span><span class="WHIT">
 478 <span class='line'>471</span>
 479 <span class='line'>472</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'toolActivate'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 480 <span class='line'>473</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 481 <span class='line'>474</span>
 482 <span class='line'>475</span> </span><span class="COMM">/**
 483 <span class='line'>476</span>  * @class Tool registration event. This event is not cancelable.
 484 <span class='line'>477</span>  *
 485 <span class='line'>478</span>  * @augments pwlib.appEvent
 486 <span class='line'>479</span>  *
 487 <span class='line'>480</span>  * @param {String} id The ID of the tool being registered in an active PaintWeb
 488 <span class='line'>481</span>  * instance.
 489 <span class='line'>482</span>  *
 490 <span class='line'>483</span>  * @throws {TypeError} If the &lt;var>id&lt;/var> is not a string.
 491 <span class='line'>484</span>  */</span><span class="WHIT">
 492 <span class='line'>485</span> </span><span class="NAME">pwlib.appEvent.toolRegister</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">id</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 493 <span class='line'>486</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 494 <span class='line'>487</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a string.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 495 <span class='line'>488</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 496 <span class='line'>489</span>
 497 <span class='line'>490</span> </span><span class="WHIT">  </span><span class="COMM">/**
 498 <span class='line'>491</span>    * Tool ID.
 499 <span class='line'>492</span>    * @type String
 500 <span class='line'>493</span>    */</span><span class="WHIT">
 501 <span class='line'>494</span> </span><span class="WHIT">  </span><span class="NAME">this.id</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">id</span><span class="PUNC">;</span><span class="WHIT">
 502 <span class='line'>495</span>
 503 <span class='line'>496</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'toolRegister'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 504 <span class='line'>497</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 505 <span class='line'>498</span>
 506 <span class='line'>499</span> </span><span class="COMM">/**
 507 <span class='line'>500</span>  * @class Tool removal event. This event is not cancelable.
 508 <span class='line'>501</span>  *
 509 <span class='line'>502</span>  * @augments pwlib.appEvent
 510 <span class='line'>503</span>  *
 511 <span class='line'>504</span>  * @param {String} id The ID of the tool being unregistered in an active
 512 <span class='line'>505</span>  * PaintWeb instance.
 513 <span class='line'>506</span>  *
 514 <span class='line'>507</span>  * @throws {TypeError} If the &lt;var>id&lt;/var> is not a string.
 515 <span class='line'>508</span>  */</span><span class="WHIT">
 516 <span class='line'>509</span> </span><span class="NAME">pwlib.appEvent.toolUnregister</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">id</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 517 <span class='line'>510</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 518 <span class='line'>511</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a string.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 519 <span class='line'>512</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 520 <span class='line'>513</span>
 521 <span class='line'>514</span> </span><span class="WHIT">  </span><span class="COMM">/**
 522 <span class='line'>515</span>    * Tool ID.
 523 <span class='line'>516</span>    * @type String
 524 <span class='line'>517</span>    */</span><span class="WHIT">
 525 <span class='line'>518</span> </span><span class="WHIT">  </span><span class="NAME">this.id</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">id</span><span class="PUNC">;</span><span class="WHIT">
 526 <span class='line'>519</span>
 527 <span class='line'>520</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'toolUnregister'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 528 <span class='line'>521</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 529 <span class='line'>522</span>
 530 <span class='line'>523</span> </span><span class="COMM">/**
 531 <span class='line'>524</span>  * @class Extension registration event. This event is not cancelable.
 532 <span class='line'>525</span>  *
 533 <span class='line'>526</span>  * @augments pwlib.appEvent
 534 <span class='line'>527</span>  *
 535 <span class='line'>528</span>  * @param {String} id The ID of the extension being registered in an active
 536 <span class='line'>529</span>  * PaintWeb instance.
 537 <span class='line'>530</span>  *
 538 <span class='line'>531</span>  * @throws {TypeError} If the &lt;var>id&lt;/var> is not a string.
 539 <span class='line'>532</span>  */</span><span class="WHIT">
 540 <span class='line'>533</span> </span><span class="NAME">pwlib.appEvent.extensionRegister</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">id</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 541 <span class='line'>534</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 542 <span class='line'>535</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a string.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 543 <span class='line'>536</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 544 <span class='line'>537</span>
 545 <span class='line'>538</span> </span><span class="WHIT">  </span><span class="COMM">/**
 546 <span class='line'>539</span>    * Extension ID.
 547 <span class='line'>540</span>    * @type String
 548 <span class='line'>541</span>    */</span><span class="WHIT">
 549 <span class='line'>542</span> </span><span class="WHIT">  </span><span class="NAME">this.id</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">id</span><span class="PUNC">;</span><span class="WHIT">
 550 <span class='line'>543</span>
 551 <span class='line'>544</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'extensionRegister'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 552 <span class='line'>545</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 553 <span class='line'>546</span>
 554 <span class='line'>547</span> </span><span class="COMM">/**
 555 <span class='line'>548</span>  * @class Extension removal event. This event is not cancelable.
 556 <span class='line'>549</span>  *
 557 <span class='line'>550</span>  * @augments pwlib.appEvent
 558 <span class='line'>551</span>  *
 559 <span class='line'>552</span>  * @param {String} id The ID of the extension being unregistered in an active
 560 <span class='line'>553</span>  * PaintWeb instance.
 561 <span class='line'>554</span>  *
 562 <span class='line'>555</span>  * @throws {TypeError} If the &lt;var>id&lt;/var> is not a string.
 563 <span class='line'>556</span>  */</span><span class="WHIT">
 564 <span class='line'>557</span> </span><span class="NAME">pwlib.appEvent.extensionUnregister</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">id</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 565 <span class='line'>558</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 566 <span class='line'>559</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a string.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 567 <span class='line'>560</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 568 <span class='line'>561</span>
 569 <span class='line'>562</span> </span><span class="WHIT">  </span><span class="COMM">/**
 570 <span class='line'>563</span>    * Extension ID.
 571 <span class='line'>564</span>    * @type String
 572 <span class='line'>565</span>    */</span><span class="WHIT">
 573 <span class='line'>566</span> </span><span class="WHIT">  </span><span class="NAME">this.id</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">id</span><span class="PUNC">;</span><span class="WHIT">
 574 <span class='line'>567</span>
 575 <span class='line'>568</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'extensionUnregister'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 576 <span class='line'>569</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 577 <span class='line'>570</span>
 578 <span class='line'>571</span> </span><span class="COMM">/**
 579 <span class='line'>572</span>  * @class Command registration event. This event is not cancelable.
 580 <span class='line'>573</span>  *
 581 <span class='line'>574</span>  * @augments pwlib.appEvent
 582 <span class='line'>575</span>  *
 583 <span class='line'>576</span>  * @param {String} id The ID of the command being registered in an active
 584 <span class='line'>577</span>  * PaintWeb instance.
 585 <span class='line'>578</span>  *
 586 <span class='line'>579</span>  * @throws {TypeError} If the &lt;var>id&lt;/var> is not a string.
 587 <span class='line'>580</span>  */</span><span class="WHIT">
 588 <span class='line'>581</span> </span><span class="NAME">pwlib.appEvent.commandRegister</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">id</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 589 <span class='line'>582</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 590 <span class='line'>583</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a string.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 591 <span class='line'>584</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 592 <span class='line'>585</span>
 593 <span class='line'>586</span> </span><span class="WHIT">  </span><span class="COMM">/**
 594 <span class='line'>587</span>    * Command ID.
 595 <span class='line'>588</span>    * @type String
 596 <span class='line'>589</span>    */</span><span class="WHIT">
 597 <span class='line'>590</span> </span><span class="WHIT">  </span><span class="NAME">this.id</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">id</span><span class="PUNC">;</span><span class="WHIT">
 598 <span class='line'>591</span>
 599 <span class='line'>592</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'commandRegister'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 600 <span class='line'>593</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 601 <span class='line'>594</span>
 602 <span class='line'>595</span> </span><span class="COMM">/**
 603 <span class='line'>596</span>  * @class Command removal event. This event is not cancelable.
 604 <span class='line'>597</span>  *
 605 <span class='line'>598</span>  * @augments pwlib.appEvent
 606 <span class='line'>599</span>  *
 607 <span class='line'>600</span>  * @param {String} id The ID of the command being unregistered in an active
 608 <span class='line'>601</span>  * PaintWeb instance.
 609 <span class='line'>602</span>  *
 610 <span class='line'>603</span>  * @throws {TypeError} If the &lt;var>id&lt;/var> is not a string.
 611 <span class='line'>604</span>  */</span><span class="WHIT">
 612 <span class='line'>605</span> </span><span class="NAME">pwlib.appEvent.commandUnregister</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">id</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 613 <span class='line'>606</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 614 <span class='line'>607</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a string.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 615 <span class='line'>608</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 616 <span class='line'>609</span>
 617 <span class='line'>610</span> </span><span class="WHIT">  </span><span class="COMM">/**
 618 <span class='line'>611</span>    * Command ID.
 619 <span class='line'>612</span>    * @type String
 620 <span class='line'>613</span>    */</span><span class="WHIT">
 621 <span class='line'>614</span> </span><span class="WHIT">  </span><span class="NAME">this.id</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">id</span><span class="PUNC">;</span><span class="WHIT">
 622 <span class='line'>615</span>
 623 <span class='line'>616</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'commandUnregister'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 624 <span class='line'>617</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 625 <span class='line'>618</span>
 626 <span class='line'>619</span> </span><span class="COMM">/**
 627 <span class='line'>620</span>  * @class The image save event. This event is cancelable.
 628 <span class='line'>621</span>  *
 629 <span class='line'>622</span>  * @augments pwlib.appEvent
 630 <span class='line'>623</span>  *
 631 <span class='line'>624</span>  * @param {String} dataURL The data URL generated by the browser holding the
 632 <span class='line'>625</span>  * pixels of the image being saved, in PNG format.
 633 <span class='line'>626</span>  * @param {Number} width The image width.
 634 <span class='line'>627</span>  * @param {Number} height The image height.
 635 <span class='line'>628</span>  */</span><span class="WHIT">
 636 <span class='line'>629</span> </span><span class="NAME">pwlib.appEvent.imageSave</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">dataURL</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">width</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">height</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 637 <span class='line'>630</span> </span><span class="WHIT">  </span><span class="COMM">/**
 638 <span class='line'>631</span>    * The image saved by the browser, using the base64 encoding.
 639 <span class='line'>632</span>    * @type String
 640 <span class='line'>633</span>    */</span><span class="WHIT">
 641 <span class='line'>634</span> </span><span class="WHIT">  </span><span class="NAME">this.dataURL</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">dataURL</span><span class="PUNC">;</span><span class="WHIT">
 642 <span class='line'>635</span>
 643 <span class='line'>636</span> </span><span class="WHIT">  </span><span class="COMM">/**
 644 <span class='line'>637</span>    * Image width.
 645 <span class='line'>638</span>    * @type Number
 646 <span class='line'>639</span>    */</span><span class="WHIT">
 647 <span class='line'>640</span> </span><span class="WHIT">  </span><span class="NAME">this.width</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">width</span><span class="PUNC">;</span><span class="WHIT">
 648 <span class='line'>641</span>
 649 <span class='line'>642</span> </span><span class="WHIT">  </span><span class="COMM">/**
 650 <span class='line'>643</span>    * Image height.
 651 <span class='line'>644</span>    * @type Number
 652 <span class='line'>645</span>    */</span><span class="WHIT">
 653 <span class='line'>646</span> </span><span class="WHIT">  </span><span class="NAME">this.height</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">height</span><span class="PUNC">;</span><span class="WHIT">
 654 <span class='line'>647</span>
 655 <span class='line'>648</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'imageSave'</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="KEYW">true</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 656 <span class='line'>649</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 657 <span class='line'>650</span> </span><span class="COMM">/**
 658 <span class='line'>651</span>  * @class The image save result event. This event is not cancelable.
 659 <span class='line'>652</span>  *
 660 <span class='line'>653</span>  * @augments pwlib.appEvent
 661 <span class='line'>654</span>  *
 662 <span class='line'>655</span>  * @param {Boolean} successful Tells if the image save was successful or not.
 663 <span class='line'>656</span>  * @param {String} [url] The image address.
 664 <span class='line'>657</span>  * @param {String} [urlNew] The new image address. Provide this parameter, if,
 665 <span class='line'>658</span>  * for example, you allow saving images from a remote server to a local server.
 666 <span class='line'>659</span>  * In such cases the image address changes.
 667 <span class='line'>660</span>  */</span><span class="WHIT">
 668 <span class='line'>661</span> </span><span class="NAME">pwlib.appEvent.imageSaveResult</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">successful</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">url</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">urlNew</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 669 <span class='line'>662</span> </span><span class="WHIT">  </span><span class="COMM">/**
 670 <span class='line'>663</span>    * Tells if the image save was successful or not.
 671 <span class='line'>664</span>    * @type String
 672 <span class='line'>665</span>    */</span><span class="WHIT">
 673 <span class='line'>666</span> </span><span class="WHIT">  </span><span class="NAME">this.successful</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">successful</span><span class="PUNC">;</span><span class="WHIT">
 674 <span class='line'>667</span>
 675 <span class='line'>668</span> </span><span class="WHIT">  </span><span class="COMM">/**
 676 <span class='line'>669</span>    * The image address.
 677 <span class='line'>670</span>    * @type String|null
 678 <span class='line'>671</span>    */</span><span class="WHIT">
 679 <span class='line'>672</span> </span><span class="WHIT">  </span><span class="NAME">this.url</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">url</span><span class="PUNC">;</span><span class="WHIT">
 680 <span class='line'>673</span>
 681 <span class='line'>674</span> </span><span class="WHIT">  </span><span class="COMM">/**
 682 <span class='line'>675</span>    * The new image address.
 683 <span class='line'>676</span>    * @type String|null
 684 <span class='line'>677</span>    */</span><span class="WHIT">
 685 <span class='line'>678</span> </span><span class="WHIT">  </span><span class="NAME">this.urlNew</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">urlNew</span><span class="PUNC">;</span><span class="WHIT">
 686 <span class='line'>679</span>
 687 <span class='line'>680</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'imageSaveResult'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 688 <span class='line'>681</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 689 <span class='line'>682</span>
 690 <span class='line'>683</span> </span><span class="COMM">/**
 691 <span class='line'>684</span>  * @class History navigation event. This event is not cancelable.
 692 <span class='line'>685</span>  *
 693 <span class='line'>686</span>  * @augments pwlib.appEvent
 694 <span class='line'>687</span>  *
 695 <span class='line'>688</span>  * @param {Number} currentPos The new history position.
 696 <span class='line'>689</span>  * @param {Number} previousPos The previous history position.
 697 <span class='line'>690</span>  * @param {Number} states The number of history states available.
 698 <span class='line'>691</span>  *
 699 <span class='line'>692</span>  * @throws {TypeError} If any of the arguments are not numbers.
 700 <span class='line'>693</span>  */</span><span class="WHIT">
 701 <span class='line'>694</span> </span><span class="NAME">pwlib.appEvent.historyUpdate</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">currentPos</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">previousPos</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">states</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 702 <span class='line'>695</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">currentPos</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'number'</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">previousPos</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'number'</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT">
 703 <span class='line'>696</span>       </span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">states</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'number'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 704 <span class='line'>697</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'All arguments must be numbers.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 705 <span class='line'>698</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 706 <span class='line'>699</span>
 707 <span class='line'>700</span> </span><span class="WHIT">  </span><span class="COMM">/**
 708 <span class='line'>701</span>    * Current history position.
 709 <span class='line'>702</span>    * @type Number
 710 <span class='line'>703</span>    */</span><span class="WHIT">
 711 <span class='line'>704</span> </span><span class="WHIT">  </span><span class="NAME">this.currentPos</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">currentPos</span><span class="PUNC">;</span><span class="WHIT">
 712 <span class='line'>705</span>
 713 <span class='line'>706</span> </span><span class="WHIT">  </span><span class="COMM">/**
 714 <span class='line'>707</span>    * Previous history position.
 715 <span class='line'>708</span>    * @type Number
 716 <span class='line'>709</span>    */</span><span class="WHIT">
 717 <span class='line'>710</span> </span><span class="WHIT">  </span><span class="NAME">this.previousPos</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">previousPos</span><span class="PUNC">;</span><span class="WHIT">
 718 <span class='line'>711</span>
 719 <span class='line'>712</span> </span><span class="WHIT">  </span><span class="COMM">/**
 720 <span class='line'>713</span>    * History states count.
 721 <span class='line'>714</span>    * @type Number
 722 <span class='line'>715</span>    */</span><span class="WHIT">
 723 <span class='line'>716</span> </span><span class="WHIT">  </span><span class="NAME">this.states</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">states</span><span class="PUNC">;</span><span class="WHIT">
 724 <span class='line'>717</span>
 725 <span class='line'>718</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'historyUpdate'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 726 <span class='line'>719</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 727 <span class='line'>720</span>
 728 <span class='line'>721</span> </span><span class="COMM">/**
 729 <span class='line'>722</span>  * @class Image size change event. This event is not cancelable.
 730 <span class='line'>723</span>  *
 731 <span class='line'>724</span>  * @augments pwlib.appEvent
 732 <span class='line'>725</span>  *
 733 <span class='line'>726</span>  * @param {Number} width The new image width.
 734 <span class='line'>727</span>  * @param {Number} height The new image height.
 735 <span class='line'>728</span>  *
 736 <span class='line'>729</span>  * @throws {TypeError} If any of the arguments are not numbers.
 737 <span class='line'>730</span>  */</span><span class="WHIT">
 738 <span class='line'>731</span> </span><span class="NAME">pwlib.appEvent.imageSizeChange</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">width</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">height</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 739 <span class='line'>732</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">width</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'number'</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">height</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'number'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 740 <span class='line'>733</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'Both arguments must be numbers.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 741 <span class='line'>734</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 742 <span class='line'>735</span>
 743 <span class='line'>736</span> </span><span class="WHIT">  </span><span class="COMM">/**
 744 <span class='line'>737</span>    * New image width.
 745 <span class='line'>738</span>    * @type Number
 746 <span class='line'>739</span>    */</span><span class="WHIT">
 747 <span class='line'>740</span> </span><span class="WHIT">  </span><span class="NAME">this.width</span><span class="WHIT">  </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">width</span><span class="PUNC">;</span><span class="WHIT">
 748 <span class='line'>741</span>
 749 <span class='line'>742</span> </span><span class="WHIT">  </span><span class="COMM">/**
 750 <span class='line'>743</span>    * New image height.
 751 <span class='line'>744</span>    * @type Number
 752 <span class='line'>745</span>    */</span><span class="WHIT">
 753 <span class='line'>746</span> </span><span class="WHIT">  </span><span class="NAME">this.height</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">height</span><span class="PUNC">;</span><span class="WHIT">
 754 <span class='line'>747</span>
 755 <span class='line'>748</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'imageSizeChange'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 756 <span class='line'>749</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 757 <span class='line'>750</span>
 758 <span class='line'>751</span> </span><span class="COMM">/**
 759 <span class='line'>752</span>  * @class Canvas size change event. This event is not cancelable.
 760 <span class='line'>753</span>  *
 761 <span class='line'>754</span>  * &lt;p>Note that the Canvas size is not the same as the image size. Canvas size
 762 <span class='line'>755</span>  * refers to the scaling of the Canvas elements being applied (due to image
 763 <span class='line'>756</span>  * zooming or due to browser zoom / DPI).
 764 <span class='line'>757</span>  *
 765 <span class='line'>758</span>  * @augments pwlib.appEvent
 766 <span class='line'>759</span>  *
 767 <span class='line'>760</span>  * @param {Number} width The new Canvas style width.
 768 <span class='line'>761</span>  * @param {Number} height The new Canvas style height.
 769 <span class='line'>762</span>  * @param {Number} scale The new Canvas scaling factor.
 770 <span class='line'>763</span>  *
 771 <span class='line'>764</span>  * @throws {TypeError} If any of the arguments are not numbers.
 772 <span class='line'>765</span>  */</span><span class="WHIT">
 773 <span class='line'>766</span> </span><span class="NAME">pwlib.appEvent.canvasSizeChange</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">width</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">height</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">scale</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 774 <span class='line'>767</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">width</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'number'</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">height</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'number'</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">scale</span><span class="WHIT">
 775 <span class='line'>768</span>       </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'number'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 776 <span class='line'>769</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'All the arguments must be numbers.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 777 <span class='line'>770</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 778 <span class='line'>771</span>
 779 <span class='line'>772</span> </span><span class="WHIT">  </span><span class="COMM">/**
 780 <span class='line'>773</span>    * New Canvas style width.
 781 <span class='line'>774</span>    * @type Number
 782 <span class='line'>775</span>    */</span><span class="WHIT">
 783 <span class='line'>776</span> </span><span class="WHIT">  </span><span class="NAME">this.width</span><span class="WHIT">  </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">width</span><span class="PUNC">;</span><span class="WHIT">
 784 <span class='line'>777</span>
 785 <span class='line'>778</span> </span><span class="WHIT">  </span><span class="COMM">/**
 786 <span class='line'>779</span>    * New Canvas style height.
 787 <span class='line'>780</span>    * @type Number
 788 <span class='line'>781</span>    */</span><span class="WHIT">
 789 <span class='line'>782</span> </span><span class="WHIT">  </span><span class="NAME">this.height</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">height</span><span class="PUNC">;</span><span class="WHIT">
 790 <span class='line'>783</span>
 791 <span class='line'>784</span> </span><span class="WHIT">  </span><span class="COMM">/**
 792 <span class='line'>785</span>    * The new Canvas scaling factor.
 793 <span class='line'>786</span>    * @type Number
 794 <span class='line'>787</span>    */</span><span class="WHIT">
 795 <span class='line'>788</span> </span><span class="WHIT">  </span><span class="NAME">this.scale</span><span class="WHIT">  </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">scale</span><span class="PUNC">;</span><span class="WHIT">
 796 <span class='line'>789</span>
 797 <span class='line'>790</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'canvasSizeChange'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 798 <span class='line'>791</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 799 <span class='line'>792</span>
 800 <span class='line'>793</span> </span><span class="COMM">/**
 801 <span class='line'>794</span>  * @class Image zoom event. This event is cancelable.
 802 <span class='line'>795</span>  *
 803 <span class='line'>796</span>  * @augments pwlib.appEvent
 804 <span class='line'>797</span>  *
 805 <span class='line'>798</span>  * @param {Number} zoom The new image zoom level.
 806 <span class='line'>799</span>  *
 807 <span class='line'>800</span>  * @throws {TypeError} If the &lt;var>zoom&lt;/var> argument is not a number.
 808 <span class='line'>801</span>  */</span><span class="WHIT">
 809 <span class='line'>802</span> </span><span class="NAME">pwlib.appEvent.imageZoom</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">zoom</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 810 <span class='line'>803</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">zoom</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'number'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 811 <span class='line'>804</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a number.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 812 <span class='line'>805</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 813 <span class='line'>806</span>
 814 <span class='line'>807</span> </span><span class="WHIT">  </span><span class="COMM">/**
 815 <span class='line'>808</span>    * The new image zoom level.
 816 <span class='line'>809</span>    * @type Number
 817 <span class='line'>810</span>    */</span><span class="WHIT">
 818 <span class='line'>811</span> </span><span class="WHIT">  </span><span class="NAME">this.zoom</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">zoom</span><span class="PUNC">;</span><span class="WHIT">
 819 <span class='line'>812</span>
 820 <span class='line'>813</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'imageZoom'</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="KEYW">true</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 821 <span class='line'>814</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 822 <span class='line'>815</span>
 823 <span class='line'>816</span> </span><span class="COMM">/**
 824 <span class='line'>817</span>  * @class Image crop event. This event is cancelable.
 825 <span class='line'>818</span>  *
 826 <span class='line'>819</span>  * @augments pwlib.appEvent
 827 <span class='line'>820</span>  *
 828 <span class='line'>821</span>  * @param {Number} x The crop start position on the x-axis.
 829 <span class='line'>822</span>  * @param {Number} y The crop start position on the y-axis.
 830 <span class='line'>823</span>  * @param {Number} width The cropped image width.
 831 <span class='line'>824</span>  * @param {Number} height The cropped image height.
 832 <span class='line'>825</span>  *
 833 <span class='line'>826</span>  * @throws {TypeError} If any of the arguments are not numbers.
 834 <span class='line'>827</span>  */</span><span class="WHIT">
 835 <span class='line'>828</span> </span><span class="NAME">pwlib.appEvent.imageCrop</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">x</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">y</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">width</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">height</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 836 <span class='line'>829</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">x</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'number'</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">y</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'number'</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">width</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT">
 837 <span class='line'>830</span>       </span><span class="STRN">'number'</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">height</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'number'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 838 <span class='line'>831</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'All arguments must be numbers.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 839 <span class='line'>832</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 840 <span class='line'>833</span>
 841 <span class='line'>834</span> </span><span class="WHIT">  </span><span class="COMM">/**
 842 <span class='line'>835</span>    * The crop start position the x-axis.
 843 <span class='line'>836</span>    * @type Number
 844 <span class='line'>837</span>    */</span><span class="WHIT">
 845 <span class='line'>838</span> </span><span class="WHIT">  </span><span class="NAME">this.x</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">x</span><span class="PUNC">;</span><span class="WHIT">
 846 <span class='line'>839</span>
 847 <span class='line'>840</span> </span><span class="WHIT">  </span><span class="COMM">/**
 848 <span class='line'>841</span>    * The crop start position the y-axis.
 849 <span class='line'>842</span>    * @type Number
 850 <span class='line'>843</span>    */</span><span class="WHIT">
 851 <span class='line'>844</span> </span><span class="WHIT">  </span><span class="NAME">this.y</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">y</span><span class="PUNC">;</span><span class="WHIT">
 852 <span class='line'>845</span>
 853 <span class='line'>846</span> </span><span class="WHIT">  </span><span class="COMM">/**
 854 <span class='line'>847</span>    * The cropped image width.
 855 <span class='line'>848</span>    * @type Number
 856 <span class='line'>849</span>    */</span><span class="WHIT">
 857 <span class='line'>850</span> </span><span class="WHIT">  </span><span class="NAME">this.width</span><span class="WHIT">  </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">width</span><span class="PUNC">;</span><span class="WHIT">
 858 <span class='line'>851</span>
 859 <span class='line'>852</span> </span><span class="WHIT">  </span><span class="COMM">/**
 860 <span class='line'>853</span>    * The cropped image height.
 861 <span class='line'>854</span>    * @type Number
 862 <span class='line'>855</span>    */</span><span class="WHIT">
 863 <span class='line'>856</span> </span><span class="WHIT">  </span><span class="NAME">this.height</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">height</span><span class="PUNC">;</span><span class="WHIT">
 864 <span class='line'>857</span>
 865 <span class='line'>858</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'imageCrop'</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="KEYW">true</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 866 <span class='line'>859</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 867 <span class='line'>860</span>
 868 <span class='line'>861</span> </span><span class="COMM">/**
 869 <span class='line'>862</span>  * @class Configuration change event. This event is not cancelable.
 870 <span class='line'>863</span>  *
 871 <span class='line'>864</span>  * @augments pwlib.appEvent
 872 <span class='line'>865</span>  *
 873 <span class='line'>866</span>  * @param {String|Number|Boolean} value The new value.
 874 <span class='line'>867</span>  * @param {String|Number|Boolean} previousValue The previous value.
 875 <span class='line'>868</span>  * @param {String} config The configuration property that just changed.
 876 <span class='line'>869</span>  * @param {String} group The configuration group where the property is found.
 877 <span class='line'>870</span>  * @param {Object} groupRef The configuration group object reference.
 878 <span class='line'>871</span>  *
 879 <span class='line'>872</span>  * @throws {TypeError} If the &lt;var>prop&lt;/var> argument is not a string.
 880 <span class='line'>873</span>  * @throws {TypeError} If the &lt;var>group&lt;/var> argument is not a string.
 881 <span class='line'>874</span>  * @throws {TypeError} If the &lt;var>groupRef&lt;/var> argument is not an object.
 882 <span class='line'>875</span>  */</span><span class="WHIT">
 883 <span class='line'>876</span> </span><span class="NAME">pwlib.appEvent.configChange</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">value</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">previousValue</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">config</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">group</span><span class="PUNC">,</span><span class="WHIT">
 884 <span class='line'>877</span>     </span><span class="NAME">groupRef</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 885 <span class='line'>878</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">config</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 886 <span class='line'>879</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The third argument must be a string.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 887 <span class='line'>880</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">group</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 888 <span class='line'>881</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The fourth argument must be a string.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 889 <span class='line'>882</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">groupRef</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'object'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 890 <span class='line'>883</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The fifth argument must be an object.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 891 <span class='line'>884</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 892 <span class='line'>885</span>
 893 <span class='line'>886</span> </span><span class="WHIT">  </span><span class="COMM">/**
 894 <span class='line'>887</span>    * The new value.
 895 <span class='line'>888</span>    */</span><span class="WHIT">
 896 <span class='line'>889</span> </span><span class="WHIT">  </span><span class="NAME">this.value</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">value</span><span class="PUNC">;</span><span class="WHIT">
 897 <span class='line'>890</span>
 898 <span class='line'>891</span> </span><span class="WHIT">  </span><span class="COMM">/**
 899 <span class='line'>892</span>    * The previous value.
 900 <span class='line'>893</span>    */</span><span class="WHIT">
 901 <span class='line'>894</span> </span><span class="WHIT">  </span><span class="NAME">this.previousValue</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">previousValue</span><span class="PUNC">;</span><span class="WHIT">
 902 <span class='line'>895</span>
 903 <span class='line'>896</span> </span><span class="WHIT">  </span><span class="COMM">/**
 904 <span class='line'>897</span>    * Configuration property name.
 905 <span class='line'>898</span>    * @type String
 906 <span class='line'>899</span>    */</span><span class="WHIT">
 907 <span class='line'>900</span> </span><span class="WHIT">  </span><span class="NAME">this.config</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">config</span><span class="PUNC">;</span><span class="WHIT">
 908 <span class='line'>901</span>
 909 <span class='line'>902</span> </span><span class="WHIT">  </span><span class="COMM">/**
 910 <span class='line'>903</span>    * Configuration group name.
 911 <span class='line'>904</span>    * @type String
 912 <span class='line'>905</span>    */</span><span class="WHIT">
 913 <span class='line'>906</span> </span><span class="WHIT">  </span><span class="NAME">this.group</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">group</span><span class="PUNC">;</span><span class="WHIT">
 914 <span class='line'>907</span>
 915 <span class='line'>908</span> </span><span class="WHIT">  </span><span class="COMM">/**
 916 <span class='line'>909</span>    * Reference to the object holding the configuration property.
 917 <span class='line'>910</span>    * @type Object
 918 <span class='line'>911</span>    */</span><span class="WHIT">
 919 <span class='line'>912</span> </span><span class="WHIT">  </span><span class="NAME">this.groupRef</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">groupRef</span><span class="PUNC">;</span><span class="WHIT">
 920 <span class='line'>913</span>
 921 <span class='line'>914</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'configChange'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 922 <span class='line'>915</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 923 <span class='line'>916</span>
 924 <span class='line'>917</span> </span><span class="COMM">/**
 925 <span class='line'>918</span>  * @class Canvas shadows allowed change event. This event is not cancelable.
 926 <span class='line'>919</span>  *
 927 <span class='line'>920</span>  * @augments pwlib.appEvent
 928 <span class='line'>921</span>  *
 929 <span class='line'>922</span>  * @param {Boolean} allowed Tells the new allowance value.
 930 <span class='line'>923</span>  *
 931 <span class='line'>924</span>  * @throws {TypeError} If the argument is not a boolean value.
 932 <span class='line'>925</span>  */</span><span class="WHIT">
 933 <span class='line'>926</span> </span><span class="NAME">pwlib.appEvent.shadowAllow</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">allowed</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 934 <span class='line'>927</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">allowed</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'boolean'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 935 <span class='line'>928</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a boolean.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 936 <span class='line'>929</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
 937 <span class='line'>930</span>
 938 <span class='line'>931</span> </span><span class="WHIT">  </span><span class="COMM">/**
 939 <span class='line'>932</span>    * Tells if the Canvas shadows are allowed or not.
 940 <span class='line'>933</span>    * @type Boolean
 941 <span class='line'>934</span>    */</span><span class="WHIT">
 942 <span class='line'>935</span> </span><span class="WHIT">  </span><span class="NAME">this.allowed</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">allowed</span><span class="PUNC">;</span><span class="WHIT">
 943 <span class='line'>936</span>
 944 <span class='line'>937</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'shadowAllow'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 945 <span class='line'>938</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 946 <span class='line'>939</span>
 947 <span class='line'>940</span> </span><span class="COMM">/**
 948 <span class='line'>941</span>  * @class Clipboard update event. This event is not cancelable.
 949 <span class='line'>942</span>  *
 950 <span class='line'>943</span>  * @augments pwlib.appEvent
 951 <span class='line'>944</span>  *
 952 <span class='line'>945</span>  * @param {ImageData} data Holds the clipboard ImageData.
 953 <span class='line'>946</span>  */</span><span class="WHIT">
 954 <span class='line'>947</span> </span><span class="NAME">pwlib.appEvent.clipboardUpdate</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">data</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 955 <span class='line'>948</span> </span><span class="WHIT">  </span><span class="COMM">/**
 956 <span class='line'>949</span>    * The clipboard image data.
 957 <span class='line'>950</span>    * @type ImageData
 958 <span class='line'>951</span>    */</span><span class="WHIT">
 959 <span class='line'>952</span> </span><span class="WHIT">  </span><span class="NAME">this.data</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">data</span><span class="PUNC">;</span><span class="WHIT">
 960 <span class='line'>953</span>
 961 <span class='line'>954</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.appEvent.call</span><span class="PUNC">(</span><span class="KEYW">this</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="STRN">'clipboardUpdate'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
 962 <span class='line'>955</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 963 <span class='line'>956</span>
 964 <span class='line'>957</span> </span><span class="COMM">/**
 965 <span class='line'>958</span>  * @class An interface for adding, removing and dispatching of custom
 966 <span class='line'>959</span>  * application events.
 967 <span class='line'>960</span>  *
 968 <span class='line'>961</span>  * @param {Object} target_ The target for all the events.
 969 <span class='line'>962</span>  *
 970 <span class='line'>963</span>  * @see pwlib.appEvent to create application event objects.
 971 <span class='line'>964</span>  */</span><span class="WHIT">
 972 <span class='line'>965</span> </span><span class="NAME">pwlib.appEvents</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">target_</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 973 <span class='line'>966</span> </span><span class="WHIT">  </span><span class="COMM">/**
 974 <span class='line'>967</span>    * Holds the list of event types and event handlers.
 975 <span class='line'>968</span>    *
 976 <span class='line'>969</span>    * @private
 977 <span class='line'>970</span>    * @type Object
 978 <span class='line'>971</span>    */</span><span class="WHIT">
 979 <span class='line'>972</span> </span><span class="WHIT">  </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">events_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
 980 <span class='line'>973</span>
 981 <span class='line'>974</span> </span><span class="WHIT">  </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">eventID_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NUMB">1</span><span class="PUNC">;</span><span class="WHIT">
 982 <span class='line'>975</span>
 983 <span class='line'>976</span> </span><span class="WHIT">  </span><span class="COMM">/**
 984 <span class='line'>977</span>    * Add an event listener.
 985 <span class='line'>978</span>    *
 986 <span class='line'>979</span>    * @param {String} type The event you want to listen for.
 987 <span class='line'>980</span>    * @param {Function} handler The event handler.
 988 <span class='line'>981</span>    *
 989 <span class='line'>982</span>    * @returns {Number} The event ID.
 990 <span class='line'>983</span>    *
 991 <span class='line'>984</span>    * @throws {TypeError} If the &lt;var>type&lt;/var> argument is not a string.
 992 <span class='line'>985</span>    * @throws {TypeError} If the &lt;var>handler&lt;/var> argument is not a function.
 993 <span class='line'>986</span>    *
 994 <span class='line'>987</span>    * @see pwlib.appEvents#remove to remove events.
 995 <span class='line'>988</span>    * @see pwlib.appEvents#dispatch to dispatch an event.
 996 <span class='line'>989</span>    */</span><span class="WHIT">
 997 <span class='line'>990</span> </span><span class="WHIT">  </span><span class="NAME">this.add</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">type</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">handler</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 998 <span class='line'>991</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">type</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
 999 <span class='line'>992</span> </span><span class="WHIT">      </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a string.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
1000 <span class='line'>993</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">handler</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'function'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1001 <span class='line'>994</span> </span><span class="WHIT">      </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The second argument must be a function.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
1002 <span class='line'>995</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
1003 <span class='line'>996</span>
1004 <span class='line'>997</span> </span><span class="WHIT">    </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">eventID_</span><span class="PUNC">++</span><span class="PUNC">;</span><span class="WHIT">
1005 <span class='line'>998</span>
1006 <span class='line'>999</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="PUNC">(</span><span class="NAME">type</span><span class="WHIT"> </span><span class="KEYW">in</span><span class="WHIT"> </span><span class="NAME">events_</span><span class="PUNC">)</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1007 <span class='line'>1000</span> </span><span class="WHIT">      </span><span class="NAME">events_</span><span class="PUNC">[</span><span class="NAME">type</span><span class="PUNC">]</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
1008 <span class='line'>1001</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
1009 <span class='line'>1002</span>
1010 <span class='line'>1003</span> </span><span class="WHIT">    </span><span class="NAME">events_</span><span class="PUNC">[</span><span class="NAME">type</span><span class="PUNC">]</span><span class="PUNC">[</span><span class="NAME">id</span><span class="PUNC">]</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">handler</span><span class="PUNC">;</span><span class="WHIT">
1011 <span class='line'>1004</span>
1012 <span class='line'>1005</span> </span><span class="WHIT">    </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="NAME">id</span><span class="PUNC">;</span><span class="WHIT">
1013 <span class='line'>1006</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
1014 <span class='line'>1007</span>
1015 <span class='line'>1008</span> </span><span class="WHIT">  </span><span class="COMM">/**
1016 <span class='line'>1009</span>    * Remove an event listener.
1017 <span class='line'>1010</span>    *
1018 <span class='line'>1011</span>    * @param {String} type The event type.
1019 <span class='line'>1012</span>    * @param {Number} id The event ID.
1020 <span class='line'>1013</span>    *
1021 <span class='line'>1014</span>    * @throws {TypeError} If the &lt;var>type&lt;/var> argument is not a string.
1022 <span class='line'>1015</span>    *
1023 <span class='line'>1016</span>    * @see pwlib.appEvents#add to add events.
1024 <span class='line'>1017</span>    * @see pwlib.appEvents#dispatch to dispatch an event.
1025 <span class='line'>1018</span>    */</span><span class="WHIT">
1026 <span class='line'>1019</span> </span><span class="WHIT">  </span><span class="NAME">this.remove</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">type</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">id</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1027 <span class='line'>1020</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">type</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1028 <span class='line'>1021</span> </span><span class="WHIT">      </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be a string.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
1029 <span class='line'>1022</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
1030 <span class='line'>1023</span>
1031 <span class='line'>1024</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="PUNC">(</span><span class="NAME">type</span><span class="WHIT"> </span><span class="KEYW">in</span><span class="WHIT"> </span><span class="NAME">events_</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="PUNC">!</span><span class="PUNC">(</span><span class="NAME">id</span><span class="WHIT"> </span><span class="KEYW">in</span><span class="WHIT"> </span><span class="NAME">events_</span><span class="PUNC">[</span><span class="NAME">type</span><span class="PUNC">]</span><span class="PUNC">)</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1032 <span class='line'>1025</span> </span><span class="WHIT">      </span><span class="KEYW">return</span><span class="PUNC">;</span><span class="WHIT">
1033 <span class='line'>1026</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
1034 <span class='line'>1027</span>
1035 <span class='line'>1028</span> </span><span class="WHIT">    </span><span class="KEYW">delete</span><span class="WHIT"> </span><span class="NAME">events_</span><span class="PUNC">[</span><span class="NAME">type</span><span class="PUNC">]</span><span class="PUNC">[</span><span class="NAME">id</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
1036 <span class='line'>1029</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
1037 <span class='line'>1030</span>
1038 <span class='line'>1031</span> </span><span class="WHIT">  </span><span class="COMM">/**
1039 <span class='line'>1032</span>    * Dispatch an event.
1040 <span class='line'>1033</span>    *
1041 <span class='line'>1034</span>    * @param {String} type The event type.
1042 <span class='line'>1035</span>    * @param {pwlib.appEvent} ev The event object.
1043 <span class='line'>1036</span>    *
1044 <span class='line'>1037</span>    * @returns {Boolean} True if the &lt;code>event.preventDefault()&lt;/code> has been
1045 <span class='line'>1038</span>    * invoked by one of the event handlers, or false if not.
1046 <span class='line'>1039</span>    *
1047 <span class='line'>1040</span>    * @throws {TypeError} If the &lt;var>type&lt;/var> parameter is not a string.
1048 <span class='line'>1041</span>    * @throws {TypeError} If the &lt;var>ev&lt;/var> parameter is not an object.
1049 <span class='line'>1042</span>    *
1050 <span class='line'>1043</span>    * @see pwlib.appEvents#add to add events.
1051 <span class='line'>1044</span>    * @see pwlib.appEvents#remove to remove events.
1052 <span class='line'>1045</span>    * @see pwlib.appEvent the generic event object.
1053 <span class='line'>1046</span>    */</span><span class="WHIT">
1054 <span class='line'>1047</span> </span><span class="WHIT">  </span><span class="NAME">this.dispatch</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ev</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1055 <span class='line'>1048</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">ev</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'object'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1056 <span class='line'>1049</span> </span><span class="WHIT">      </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The second argument must be an object.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
1057 <span class='line'>1050</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">ev.type</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'string'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1058 <span class='line'>1051</span> </span><span class="WHIT">      </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The second argument must be an application event '</span><span class="WHIT"> </span><span class="PUNC">+</span><span class="WHIT">
1059 <span class='line'>1052</span> </span><span class="WHIT">        </span><span class="STRN">'object.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
1060 <span class='line'>1053</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
1061 <span class='line'>1054</span>
1062 <span class='line'>1055</span> </span><span class="WHIT">    </span><span class="COMM">// No event handlers.</span><span class="WHIT">
1063 <span class='line'>1056</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="PUNC">(</span><span class="NAME">ev.type</span><span class="WHIT"> </span><span class="KEYW">in</span><span class="WHIT"> </span><span class="NAME">events_</span><span class="PUNC">)</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1064 <span class='line'>1057</span> </span><span class="WHIT">      </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
1065 <span class='line'>1058</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
1066 <span class='line'>1059</span>
1067 <span class='line'>1060</span> </span><span class="WHIT">    </span><span class="NAME">ev.target</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">target_</span><span class="PUNC">;</span><span class="WHIT">
1068 <span class='line'>1061</span>
1069 <span class='line'>1062</span> </span><span class="WHIT">    </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">id</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">handlers</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">events_</span><span class="PUNC">[</span><span class="NAME">ev.type</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
1070 <span class='line'>1063</span> </span><span class="WHIT">    </span><span class="KEYW">for</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">id</span><span class="WHIT"> </span><span class="KEYW">in</span><span class="WHIT"> </span><span class="NAME">handlers</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1071 <span class='line'>1064</span> </span><span class="WHIT">      </span><span class="NAME">handlers</span><span class="PUNC">[</span><span class="NAME">id</span><span class="PUNC">]</span><span class="PUNC">.</span><span class="NAME">call</span><span class="PUNC">(</span><span class="NAME">target_</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">ev</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
1072 <span class='line'>1065</span>
1073 <span class='line'>1066</span> </span><span class="WHIT">      </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ev.propagationStopped_</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1074 <span class='line'>1067</span> </span><span class="WHIT">        </span><span class="KEYW">break</span><span class="PUNC">;</span><span class="WHIT">
1075 <span class='line'>1068</span> </span><span class="WHIT">      </span><span class="PUNC">}</span><span class="WHIT">
1076 <span class='line'>1069</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
1077 <span class='line'>1070</span>
1078 <span class='line'>1071</span> </span><span class="WHIT">    </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="NAME">ev.defaultPrevented</span><span class="PUNC">;</span><span class="WHIT">
1079 <span class='line'>1072</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
1080 <span class='line'>1073</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
1081 <span class='line'>1074</span>
1082 <span class='line'>1075</span>
1083 <span class='line'>1076</span> </span><span class="COMM">/**
1084 <span class='line'>1077</span>  * @namespace Holds browser information.
1085 <span class='line'>1078</span>  */</span><span class="WHIT">
1086 <span class='line'>1079</span> </span><span class="NAME">pwlib.browser</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
1087 <span class='line'>1080</span>
1088 <span class='line'>1081</span> </span><span class="PUNC">(</span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1089 <span class='line'>1082</span> </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">ua</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="STRN">''</span><span class="PUNC">;</span><span class="WHIT">
1090 <span class='line'>1083</span>
1091 <span class='line'>1084</span> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">window.navigator</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">window.navigator.userAgent</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1092 <span class='line'>1085</span> </span><span class="WHIT">  </span><span class="NAME">ua</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">window.navigator.userAgent.toLowerCase</span><span class="PUNC">(</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
1093 <span class='line'>1086</span> </span><span class="PUNC">}</span><span class="WHIT">
1094 <span class='line'>1087</span>
1095 <span class='line'>1088</span> </span><span class="COMM">/**
1096 <span class='line'>1089</span>  * @type Boolean
1097 <span class='line'>1090</span>  */</span><span class="WHIT">
1098 <span class='line'>1091</span> </span><span class="NAME">pwlib.browser.opera</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">window.opera</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="REGX">/\bopera\b/</span><span class="PUNC">.</span><span class="NAME">test</span><span class="PUNC">(</span><span class="NAME">ua</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
1099 <span class='line'>1092</span>
1100 <span class='line'>1093</span> </span><span class="COMM">/**
1101 <span class='line'>1094</span>  * Webkit is the render engine used primarily by Safari. It's also used by
1102 <span class='line'>1095</span>  * Google Chrome and GNOME Epiphany.
1103 <span class='line'>1096</span>  *
1104 <span class='line'>1097</span>  * @type Boolean
1105 <span class='line'>1098</span>  */</span><span class="WHIT">
1106 <span class='line'>1099</span> </span><span class="NAME">pwlib.browser.webkit</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">!</span><span class="NAME">pwlib.browser.opera</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT">
1107 <span class='line'>1100</span> </span><span class="WHIT">                       </span><span class="REGX">/\b(applewebkit|webkit)\b/</span><span class="PUNC">.</span><span class="NAME">test</span><span class="PUNC">(</span><span class="NAME">ua</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
1108 <span class='line'>1101</span>
1109 <span class='line'>1102</span> </span><span class="COMM">/**
1110 <span class='line'>1103</span>  * Firefox uses the Gecko render engine.
1111 <span class='line'>1104</span>  *
1112 <span class='line'>1105</span>  * @type Boolean
1113 <span class='line'>1106</span>  */</span><span class="WHIT">
1114 <span class='line'>1107</span> </span><span class="COMM">// In some variations of the User Agent strings provided by Opera, Firefox is </span><span class="WHIT">
1115 <span class='line'>1108</span> </span><span class="COMM">// mentioned.</span><span class="WHIT">
1116 <span class='line'>1109</span> </span><span class="NAME">pwlib.browser.firefox</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="REGX">/\bfirefox\b/</span><span class="PUNC">.</span><span class="NAME">test</span><span class="PUNC">(</span><span class="NAME">ua</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="PUNC">!</span><span class="NAME">pwlib.browser.opera</span><span class="PUNC">;</span><span class="WHIT">
1117 <span class='line'>1110</span>
1118 <span class='line'>1111</span> </span><span class="COMM">/**
1119 <span class='line'>1112</span>  * Gecko is the render engine used by Firefox and related products.
1120 <span class='line'>1113</span>  *
1121 <span class='line'>1114</span>  * @type Boolean
1122 <span class='line'>1115</span>  */</span><span class="WHIT">
1123 <span class='line'>1116</span> </span><span class="COMM">// Typically, the user agent string of WebKit also mentions Gecko. Additionally, </span><span class="WHIT">
1124 <span class='line'>1117</span> </span><span class="COMM">// Opera mentions Gecko for tricking some sites.</span><span class="WHIT">
1125 <span class='line'>1118</span> </span><span class="NAME">pwlib.browser.gecko</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="REGX">/\bgecko\b/</span><span class="PUNC">.</span><span class="NAME">test</span><span class="PUNC">(</span><span class="NAME">ua</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="PUNC">!</span><span class="NAME">pwlib.browser.opera</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT">
1126 <span class='line'>1119</span> </span><span class="WHIT">                      </span><span class="PUNC">!</span><span class="NAME">pwlib.browser.webkit</span><span class="PUNC">;</span><span class="WHIT">
1127 <span class='line'>1120</span>
1128 <span class='line'>1121</span> </span><span class="COMM">/**
1129 <span class='line'>1122</span>  * Microsoft Internet Explorer. The future of computing.
1130 <span class='line'>1123</span>  *
1131 <span class='line'>1124</span>  * @type Boolean
1132 <span class='line'>1125</span>  */</span><span class="WHIT">
1133 <span class='line'>1126</span> </span><span class="COMM">// Again, Opera allows users to easily fake the UA.</span><span class="WHIT">
1134 <span class='line'>1127</span> </span><span class="NAME">pwlib.browser.msie</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="REGX">/\bmsie\b/</span><span class="PUNC">.</span><span class="NAME">test</span><span class="PUNC">(</span><span class="NAME">ua</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="PUNC">!</span><span class="NAME">pwlib.browser.opera</span><span class="PUNC">;</span><span class="WHIT">
1135 <span class='line'>1128</span>
1136 <span class='line'>1129</span> </span><span class="COMM">/**
1137 <span class='line'>1130</span>  * Presto is the render engine used by Opera.
1138 <span class='line'>1131</span>  *
1139 <span class='line'>1132</span>  * @type Boolean
1140 <span class='line'>1133</span>  */</span><span class="WHIT">
1141 <span class='line'>1134</span> </span><span class="COMM">// Older versions of Opera did not mention Presto in the UA string.</span><span class="WHIT">
1142 <span class='line'>1135</span> </span><span class="NAME">pwlib.browser.presto</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="REGX">/\bpresto\b/</span><span class="PUNC">.</span><span class="NAME">test</span><span class="PUNC">(</span><span class="NAME">ua</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">pwlib.browser.opera</span><span class="PUNC">;</span><span class="WHIT">
1143 <span class='line'>1136</span>
1144 <span class='line'>1137</span>
1145 <span class='line'>1138</span> </span><span class="COMM">/**
1146 <span class='line'>1139</span>  * Browser operating system
1147 <span class='line'>1140</span>  *
1148 <span class='line'>1141</span>  * @type String
1149 <span class='line'>1142</span>  */</span><span class="WHIT">
1150 <span class='line'>1143</span> </span><span class="NAME">pwlib.browser.os</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ua.match</span><span class="PUNC">(</span><span class="REGX">/\b(windows|linux)\b/</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="PUNC">[</span><span class="PUNC">]</span><span class="PUNC">)</span><span class="PUNC">[</span><span class="NUMB">1</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
1151 <span class='line'>1144</span>
1152 <span class='line'>1145</span> </span><span class="COMM">/**
1153 <span class='line'>1146</span>  * Tells if the browser is running on an OLPC XO. Typically, only the default
1154 <span class='line'>1147</span>  * Gecko-based browser includes the OLPC XO tokens in the user agent string.
1155 <span class='line'>1148</span>  *
1156 <span class='line'>1149</span>  * @type Boolean
1157 <span class='line'>1150</span>  */</span><span class="WHIT">
1158 <span class='line'>1151</span> </span><span class="NAME">pwlib.browser.olpcxo</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="REGX">/\bolpc\b/</span><span class="PUNC">.</span><span class="NAME">test</span><span class="PUNC">(</span><span class="NAME">ua</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="REGX">/\bxo\b/</span><span class="PUNC">.</span><span class="NAME">test</span><span class="PUNC">(</span><span class="NAME">ua</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
1159 <span class='line'>1152</span>
1160 <span class='line'>1153</span> </span><span class="KEYW">delete</span><span class="WHIT"> </span><span class="NAME">ua</span><span class="PUNC">;</span><span class="WHIT">
1161 <span class='line'>1154</span> </span><span class="PUNC">}</span><span class="PUNC">)</span><span class="PUNC">(</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
1162 <span class='line'>1155</span>
1163 <span class='line'>1156</span>
1164 <span class='line'>1157</span> </span><span class="COMM">/**
1165 <span class='line'>1158</span>  * @namespace Holds methods and properties necessary for DOM manipulation.
1166 <span class='line'>1159</span>  */</span><span class="WHIT">
1167 <span class='line'>1160</span> </span><span class="NAME">pwlib.dom</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
1168 <span class='line'>1161</span>
1169 <span class='line'>1162</span> </span><span class="COMM">/**
1170 <span class='line'>1163</span>  * @namespace Holds the list of virtual key identifiers and a few characters,
1171 <span class='line'>1164</span>  * each being associated to a key code commonly used by Web browsers.
1172 <span class='line'>1165</span>  *
1173 <span class='line'>1166</span>  * @private
1174 <span class='line'>1167</span>  */</span><span class="WHIT">
1175 <span class='line'>1168</span> </span><span class="NAME">pwlib.dom.keyNames</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1176 <span class='line'>1169</span> </span><span class="WHIT">  </span><span class="NAME">Help</span><span class="PUNC">:</span><span class="WHIT">          </span><span class="NUMB">6</span><span class="PUNC">,</span><span class="WHIT">
1177 <span class='line'>1170</span> </span><span class="WHIT">  </span><span class="NAME">Backspace</span><span class="PUNC">:</span><span class="WHIT">     </span><span class="NUMB">8</span><span class="PUNC">,</span><span class="WHIT">
1178 <span class='line'>1171</span> </span><span class="WHIT">  </span><span class="NAME">Tab</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">9</span><span class="PUNC">,</span><span class="WHIT">
1179 <span class='line'>1172</span> </span><span class="WHIT">  </span><span class="NAME">Clear</span><span class="PUNC">:</span><span class="WHIT">         </span><span class="NUMB">12</span><span class="PUNC">,</span><span class="WHIT">
1180 <span class='line'>1173</span> </span><span class="WHIT">  </span><span class="NAME">Enter</span><span class="PUNC">:</span><span class="WHIT">         </span><span class="NUMB">13</span><span class="PUNC">,</span><span class="WHIT">
1181 <span class='line'>1174</span> </span><span class="WHIT">  </span><span class="NAME">Shift</span><span class="PUNC">:</span><span class="WHIT">         </span><span class="NUMB">16</span><span class="PUNC">,</span><span class="WHIT">
1182 <span class='line'>1175</span> </span><span class="WHIT">  </span><span class="NAME">Control</span><span class="PUNC">:</span><span class="WHIT">       </span><span class="NUMB">17</span><span class="PUNC">,</span><span class="WHIT">
1183 <span class='line'>1176</span> </span><span class="WHIT">  </span><span class="NAME">Alt</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">18</span><span class="PUNC">,</span><span class="WHIT">
1184 <span class='line'>1177</span> </span><span class="WHIT">  </span><span class="NAME">Pause</span><span class="PUNC">:</span><span class="WHIT">         </span><span class="NUMB">19</span><span class="PUNC">,</span><span class="WHIT">
1185 <span class='line'>1178</span> </span><span class="WHIT">  </span><span class="NAME">CapsLock</span><span class="PUNC">:</span><span class="WHIT">      </span><span class="NUMB">20</span><span class="PUNC">,</span><span class="WHIT">
1186 <span class='line'>1179</span> </span><span class="WHIT">  </span><span class="NAME">Cancel</span><span class="PUNC">:</span><span class="WHIT">        </span><span class="NUMB">24</span><span class="PUNC">,</span><span class="WHIT">
1187 <span class='line'>1180</span> </span><span class="WHIT">  </span><span class="STRN">'Escape'</span><span class="PUNC">:</span><span class="WHIT">      </span><span class="NUMB">27</span><span class="PUNC">,</span><span class="WHIT">
1188 <span class='line'>1181</span> </span><span class="WHIT">  </span><span class="NAME">Space</span><span class="PUNC">:</span><span class="WHIT">         </span><span class="NUMB">32</span><span class="PUNC">,</span><span class="WHIT">
1189 <span class='line'>1182</span> </span><span class="WHIT">  </span><span class="NAME">PageUp</span><span class="PUNC">:</span><span class="WHIT">        </span><span class="NUMB">33</span><span class="PUNC">,</span><span class="WHIT">
1190 <span class='line'>1183</span> </span><span class="WHIT">  </span><span class="NAME">PageDown</span><span class="PUNC">:</span><span class="WHIT">      </span><span class="NUMB">34</span><span class="PUNC">,</span><span class="WHIT">
1191 <span class='line'>1184</span> </span><span class="WHIT">  </span><span class="NAME">End</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">35</span><span class="PUNC">,</span><span class="WHIT">
1192 <span class='line'>1185</span> </span><span class="WHIT">  </span><span class="NAME">Home</span><span class="PUNC">:</span><span class="WHIT">          </span><span class="NUMB">36</span><span class="PUNC">,</span><span class="WHIT">
1193 <span class='line'>1186</span> </span><span class="WHIT">  </span><span class="NAME">Left</span><span class="PUNC">:</span><span class="WHIT">          </span><span class="NUMB">37</span><span class="PUNC">,</span><span class="WHIT">
1194 <span class='line'>1187</span> </span><span class="WHIT">  </span><span class="NAME">Up</span><span class="PUNC">:</span><span class="WHIT">            </span><span class="NUMB">38</span><span class="PUNC">,</span><span class="WHIT">
1195 <span class='line'>1188</span> </span><span class="WHIT">  </span><span class="NAME">Right</span><span class="PUNC">:</span><span class="WHIT">         </span><span class="NUMB">39</span><span class="PUNC">,</span><span class="WHIT">
1196 <span class='line'>1189</span> </span><span class="WHIT">  </span><span class="NAME">Down</span><span class="PUNC">:</span><span class="WHIT">          </span><span class="NUMB">40</span><span class="PUNC">,</span><span class="WHIT">
1197 <span class='line'>1190</span> </span><span class="WHIT">  </span><span class="NAME">PrintScreen</span><span class="PUNC">:</span><span class="WHIT">   </span><span class="NUMB">44</span><span class="PUNC">,</span><span class="WHIT">
1198 <span class='line'>1191</span> </span><span class="WHIT">  </span><span class="NAME">Insert</span><span class="PUNC">:</span><span class="WHIT">        </span><span class="NUMB">45</span><span class="PUNC">,</span><span class="WHIT">
1199 <span class='line'>1192</span> </span><span class="WHIT">  </span><span class="STRN">'Delete'</span><span class="PUNC">:</span><span class="WHIT">      </span><span class="NUMB">46</span><span class="PUNC">,</span><span class="WHIT">
1200 <span class='line'>1193</span> </span><span class="WHIT">  </span><span class="NAME">Win</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">91</span><span class="PUNC">,</span><span class="WHIT">
1201 <span class='line'>1194</span> </span><span class="WHIT">  </span><span class="NAME">ContextMenu</span><span class="PUNC">:</span><span class="WHIT">   </span><span class="NUMB">93</span><span class="PUNC">,</span><span class="WHIT">
1202 <span class='line'>1195</span> </span><span class="WHIT">  </span><span class="STRN">'*'</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">106</span><span class="PUNC">,</span><span class="WHIT">
1203 <span class='line'>1196</span> </span><span class="WHIT">  </span><span class="STRN">'+'</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">107</span><span class="PUNC">,</span><span class="WHIT">
1204 <span class='line'>1197</span> </span><span class="WHIT">  </span><span class="NAME">F1</span><span class="PUNC">:</span><span class="WHIT">            </span><span class="NUMB">112</span><span class="PUNC">,</span><span class="WHIT">
1205 <span class='line'>1198</span> </span><span class="WHIT">  </span><span class="NAME">F2</span><span class="PUNC">:</span><span class="WHIT">            </span><span class="NUMB">113</span><span class="PUNC">,</span><span class="WHIT">
1206 <span class='line'>1199</span> </span><span class="WHIT">  </span><span class="NAME">F3</span><span class="PUNC">:</span><span class="WHIT">            </span><span class="NUMB">114</span><span class="PUNC">,</span><span class="WHIT">
1207 <span class='line'>1200</span> </span><span class="WHIT">  </span><span class="NAME">F4</span><span class="PUNC">:</span><span class="WHIT">            </span><span class="NUMB">115</span><span class="PUNC">,</span><span class="WHIT">
1208 <span class='line'>1201</span> </span><span class="WHIT">  </span><span class="NAME">F5</span><span class="PUNC">:</span><span class="WHIT">            </span><span class="NUMB">116</span><span class="PUNC">,</span><span class="WHIT">
1209 <span class='line'>1202</span> </span><span class="WHIT">  </span><span class="NAME">F6</span><span class="PUNC">:</span><span class="WHIT">            </span><span class="NUMB">117</span><span class="PUNC">,</span><span class="WHIT">
1210 <span class='line'>1203</span> </span><span class="WHIT">  </span><span class="NAME">F7</span><span class="PUNC">:</span><span class="WHIT">            </span><span class="NUMB">118</span><span class="PUNC">,</span><span class="WHIT">
1211 <span class='line'>1204</span> </span><span class="WHIT">  </span><span class="NAME">F8</span><span class="PUNC">:</span><span class="WHIT">            </span><span class="NUMB">119</span><span class="PUNC">,</span><span class="WHIT">
1212 <span class='line'>1205</span> </span><span class="WHIT">  </span><span class="NAME">F9</span><span class="PUNC">:</span><span class="WHIT">            </span><span class="NUMB">120</span><span class="PUNC">,</span><span class="WHIT">
1213 <span class='line'>1206</span> </span><span class="WHIT">  </span><span class="NAME">F10</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">121</span><span class="PUNC">,</span><span class="WHIT">
1214 <span class='line'>1207</span> </span><span class="WHIT">  </span><span class="NAME">F11</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">122</span><span class="PUNC">,</span><span class="WHIT">
1215 <span class='line'>1208</span> </span><span class="WHIT">  </span><span class="NAME">F12</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">123</span><span class="PUNC">,</span><span class="WHIT">
1216 <span class='line'>1209</span> </span><span class="WHIT">  </span><span class="NAME">NumLock</span><span class="PUNC">:</span><span class="WHIT">       </span><span class="NUMB">144</span><span class="PUNC">,</span><span class="WHIT">
1217 <span class='line'>1210</span> </span><span class="WHIT">  </span><span class="STRN">';'</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">186</span><span class="PUNC">,</span><span class="WHIT">
1218 <span class='line'>1211</span> </span><span class="WHIT">  </span><span class="STRN">'='</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">187</span><span class="PUNC">,</span><span class="WHIT">
1219 <span class='line'>1212</span> </span><span class="WHIT">  </span><span class="STRN">','</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">188</span><span class="PUNC">,</span><span class="WHIT">
1220 <span class='line'>1213</span> </span><span class="WHIT">  </span><span class="STRN">'-'</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">189</span><span class="PUNC">,</span><span class="WHIT">
1221 <span class='line'>1214</span> </span><span class="WHIT">  </span><span class="STRN">'.'</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">190</span><span class="PUNC">,</span><span class="WHIT">
1222 <span class='line'>1215</span> </span><span class="WHIT">  </span><span class="STRN">'/'</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">191</span><span class="PUNC">,</span><span class="WHIT">
1223 <span class='line'>1216</span> </span><span class="WHIT">  </span><span class="STRN">'`'</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">192</span><span class="PUNC">,</span><span class="WHIT">
1224 <span class='line'>1217</span> </span><span class="WHIT">  </span><span class="STRN">'['</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">219</span><span class="PUNC">,</span><span class="WHIT">
1225 <span class='line'>1218</span> </span><span class="WHIT">  </span><span class="STRN">'\\'</span><span class="PUNC">:</span><span class="WHIT">          </span><span class="NUMB">220</span><span class="PUNC">,</span><span class="WHIT">
1226 <span class='line'>1219</span> </span><span class="WHIT">  </span><span class="STRN">']'</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">221</span><span class="PUNC">,</span><span class="WHIT">
1227 <span class='line'>1220</span> </span><span class="WHIT">  </span><span class="STRN">"'"</span><span class="PUNC">:</span><span class="WHIT">           </span><span class="NUMB">222</span><span class="WHIT">
1228 <span class='line'>1221</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
1229 <span class='line'>1222</span>
1230 <span class='line'>1223</span> </span><span class="COMM">/**
1231 <span class='line'>1224</span>  * @namespace Holds the list of codes, each being associated to a virtual key
1232 <span class='line'>1225</span>  * identifier.
1233 <span class='line'>1226</span>  *
1234 <span class='line'>1227</span>  * @private
1235 <span class='line'>1228</span>  */</span><span class="WHIT">
1236 <span class='line'>1229</span> </span><span class="NAME">pwlib.dom.keyCodes</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1237 <span class='line'>1230</span> </span><span class="WHIT">  </span><span class="COMM">/*
1238 <span class='line'>1231</span>    * For almost each key code, these comments give the key name, the
1239 <span class='line'>1232</span>    * keyIdentifier from the DOM 3 Events spec and the Unicode character
1240 <span class='line'>1233</span>    * information (if you would use the decimal code for direct conversion to
1241 <span class='line'>1234</span>    * a character, e.g. String.fromCharCode()). Obviously, the Unicode character
1242 <span class='line'>1235</span>    * information is not to be used, since these are only virtual key codes (not
1243 <span class='line'>1236</span>    * really char codes) associated to key names.
1244 <span class='line'>1237</span>    *
1245 <span class='line'>1238</span>    * Each key name in here tries to follow the same style as the defined
1246 <span class='line'>1239</span>    * keyIdentifiers from the DOM 3 Events. Thus for the Page Down button,
1247 <span class='line'>1240</span>    * 'PageDown' is used (not other variations like 'pag-up'), and so on.
1248 <span class='line'>1241</span>    *
1249 <span class='line'>1242</span>    * Multiple key codes might be associated to the same key - it's not an error.
1250 <span class='line'>1243</span>    *
1251 <span class='line'>1244</span>    * Note that this list is not an exhaustive key codes list. This means that
1252 <span class='line'>1245</span>    * for key A or for key 0, the script will do String.fromCharCode(keyCode), to
1253 <span class='line'>1246</span>    * determine the key. For the case of alpha-numeric keys, this works fine.
1254 <span class='line'>1247</span>    */</span><span class="WHIT">
1255 <span class='line'>1248</span>
1256 <span class='line'>1249</span> </span><span class="WHIT">  </span><span class="COMM">/*
1257 <span class='line'>1250</span>    * Key: Enter
1258 <span class='line'>1251</span>    * Unicode: U+0003 [End of text]
1259 <span class='line'>1252</span>    *
1260 <span class='line'>1253</span>    * Note 1: This keyCode is only used in Safari 2 (older Webkit) for the Enter
1261 <span class='line'>1254</span>    * key.
1262 <span class='line'>1255</span>    *
1263 <span class='line'>1256</span>    * Note 2: In Gecko this keyCode is used for the Cancel key (see
1264 <span class='line'>1257</span>    * DOM_VK_CANCEL).
1265 <span class='line'>1258</span>    */</span><span class="WHIT">
1266 <span class='line'>1259</span> </span><span class="WHIT">  </span><span class="NUMB">3</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Enter'</span><span class="PUNC">,</span><span class="WHIT">
1267 <span class='line'>1260</span>
1268 <span class='line'>1261</span> </span><span class="WHIT">  </span><span class="COMM">/*
1269 <span class='line'>1262</span>    * Key: Help
1270 <span class='line'>1263</span>    * Unicode: U+0006 [Acknowledge]
1271 <span class='line'>1264</span>    *
1272 <span class='line'>1265</span>    * Note: Taken from Gecko (DOM_VK_HELP).
1273 <span class='line'>1266</span>    */</span><span class="WHIT">
1274 <span class='line'>1267</span> </span><span class="WHIT">  </span><span class="NUMB">6</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Help'</span><span class="PUNC">,</span><span class="WHIT">
1275 <span class='line'>1268</span>
1276 <span class='line'>1269</span> </span><span class="WHIT">  </span><span class="COMM">/*
1277 <span class='line'>1270</span>    * Key: Backspace
1278 <span class='line'>1271</span>    * Unicode: U+0008 [Backspace]
1279 <span class='line'>1272</span>    * keyIdentifier: U+0008
1280 <span class='line'>1273</span>    */</span><span class="WHIT">
1281 <span class='line'>1274</span> </span><span class="WHIT">  </span><span class="NUMB">8</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Backspace'</span><span class="PUNC">,</span><span class="WHIT">
1282 <span class='line'>1275</span>
1283 <span class='line'>1276</span> </span><span class="WHIT">  </span><span class="COMM">/*
1284 <span class='line'>1277</span>    * Key: Tab
1285 <span class='line'>1278</span>    * Unicode: U+0009 [Horizontal tab]
1286 <span class='line'>1279</span>    * keyIdentifier: U+0009
1287 <span class='line'>1280</span>    */</span><span class="WHIT">
1288 <span class='line'>1281</span> </span><span class="WHIT">  </span><span class="NUMB">9</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Tab'</span><span class="PUNC">,</span><span class="WHIT">
1289 <span class='line'>1282</span>
1290 <span class='line'>1283</span> </span><span class="WHIT">  </span><span class="COMM">/*
1291 <span class='line'>1284</span>    * Key: Enter
1292 <span class='line'>1285</span>    * Unicode: U+0010 [Line feed (LF) / New line (NL) / End of line (EOL)]
1293 <span class='line'>1286</span>    *
1294 <span class='line'>1287</span>    * Note: Taken from the Unicode characters list. If it ends up as a keyCode in
1295 <span class='line'>1288</span>    * some event, it's simply considered as being the Enter key.
1296 <span class='line'>1289</span>    */</span><span class="WHIT">
1297 <span class='line'>1290</span> </span><span class="WHIT">  </span><span class="NUMB">10</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Enter'</span><span class="PUNC">,</span><span class="WHIT">
1298 <span class='line'>1291</span>
1299 <span class='line'>1292</span> </span><span class="WHIT">  </span><span class="COMM">/*
1300 <span class='line'>1293</span>    * Key: NumPad_Center
1301 <span class='line'>1294</span>    * Unicode: U+000C [Form feed]
1302 <span class='line'>1295</span>    * keyIdentifier: Clear
1303 <span class='line'>1296</span>    *
1304 <span class='line'>1297</span>    * Note 1: This keyCode is used when NumLock is off, and the user pressed the
1305 <span class='line'>1298</span>    * 5 key on the numeric pad.
1306 <span class='line'>1299</span>    *
1307 <span class='line'>1300</span>    * Note 2: Safari 2 (older Webkit) assigns this keyCode to the NumLock key
1308 <span class='line'>1301</span>    * itself.
1309 <span class='line'>1302</span>    */</span><span class="WHIT">
1310 <span class='line'>1303</span> </span><span class="WHIT">  </span><span class="NUMB">12</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Clear'</span><span class="PUNC">,</span><span class="WHIT">
1311 <span class='line'>1304</span>
1312 <span class='line'>1305</span> </span><span class="WHIT">  </span><span class="COMM">/*
1313 <span class='line'>1306</span>    * Key: Enter
1314 <span class='line'>1307</span>    * Unicode: U+000D [Carriage return (CR)]
1315 <span class='line'>1308</span>    * keyIdentifier: Enter
1316 <span class='line'>1309</span>    *
1317 <span class='line'>1310</span>    * Note 1: This is the keyCode used by most of the Web browsers when the Enter
1318 <span class='line'>1311</span>    * key is pressed.
1319 <span class='line'>1312</span>    *
1320 <span class='line'>1313</span>    * Note 2: Gecko associates the DOM_VK_RETURN to this keyCode.
1321 <span class='line'>1314</span>    */</span><span class="WHIT">
1322 <span class='line'>1315</span> </span><span class="WHIT">  </span><span class="NUMB">13</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Enter'</span><span class="PUNC">,</span><span class="WHIT">
1323 <span class='line'>1316</span>
1324 <span class='line'>1317</span> </span><span class="WHIT">  </span><span class="COMM">/*
1325 <span class='line'>1318</span>    * Key: Enter
1326 <span class='line'>1319</span>    * Unicode: U+000E [Shift out]
1327 <span class='line'>1320</span>    *
1328 <span class='line'>1321</span>    * Note: Taken from Gecko (DOM_VK_ENTER).
1329 <span class='line'>1322</span>    */</span><span class="WHIT">
1330 <span class='line'>1323</span> </span><span class="WHIT">  </span><span class="NUMB">14</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Enter'</span><span class="PUNC">,</span><span class="WHIT">
1331 <span class='line'>1324</span>
1332 <span class='line'>1325</span> </span><span class="WHIT">  </span><span class="COMM">/*
1333 <span class='line'>1326</span>    * Key: Shift
1334 <span class='line'>1327</span>    * Unicode: U+0010 [Data link escape]
1335 <span class='line'>1328</span>    * keyIdentifier: Shift
1336 <span class='line'>1329</span>    *
1337 <span class='line'>1330</span>    * Note: In older Safari (Webkit) versions Shift+Tab is assigned a different
1338 <span class='line'>1331</span>    * keyCode: keyCode 25.
1339 <span class='line'>1332</span>    */</span><span class="WHIT">
1340 <span class='line'>1333</span> </span><span class="WHIT">  </span><span class="NUMB">16</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Shift'</span><span class="PUNC">,</span><span class="WHIT">
1341 <span class='line'>1334</span>
1342 <span class='line'>1335</span> </span><span class="WHIT">  </span><span class="COMM">/*
1343 <span class='line'>1336</span>    * Key: Control
1344 <span class='line'>1337</span>    * Unicode: U+0011 [Device control one]
1345 <span class='line'>1338</span>    * keyIdentifier: Control
1346 <span class='line'>1339</span>    */</span><span class="WHIT">
1347 <span class='line'>1340</span> </span><span class="WHIT">  </span><span class="NUMB">17</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Control'</span><span class="PUNC">,</span><span class="WHIT">
1348 <span class='line'>1341</span>
1349 <span class='line'>1342</span> </span><span class="WHIT">  </span><span class="COMM">/*
1350 <span class='line'>1343</span>    * Key: Alt
1351 <span class='line'>1344</span>    * Unicode: U+0012 [Device control two]
1352 <span class='line'>1345</span>    * keyIdentifier: Alt
1353 <span class='line'>1346</span>    */</span><span class="WHIT">
1354 <span class='line'>1347</span> </span><span class="WHIT">  </span><span class="NUMB">18</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Alt'</span><span class="PUNC">,</span><span class="WHIT">
1355 <span class='line'>1348</span>
1356 <span class='line'>1349</span> </span><span class="WHIT">  </span><span class="COMM">/*
1357 <span class='line'>1350</span>    * Key: Pause
1358 <span class='line'>1351</span>    * Unicode: U+0013 [Device control three]
1359 <span class='line'>1352</span>    * keyIdentifier: Pause
1360 <span class='line'>1353</span>    */</span><span class="WHIT">
1361 <span class='line'>1354</span> </span><span class="WHIT">  </span><span class="NUMB">19</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Pause'</span><span class="PUNC">,</span><span class="WHIT">
1362 <span class='line'>1355</span>
1363 <span class='line'>1356</span> </span><span class="WHIT">  </span><span class="COMM">/*
1364 <span class='line'>1357</span>    * Key: CapsLock
1365 <span class='line'>1358</span>    * Unicode: U+0014 [Device control four]
1366 <span class='line'>1359</span>    * keyIdentifier: CapsLock
1367 <span class='line'>1360</span>    */</span><span class="WHIT">
1368 <span class='line'>1361</span> </span><span class="WHIT">  </span><span class="NUMB">20</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'CapsLock'</span><span class="PUNC">,</span><span class="WHIT">
1369 <span class='line'>1362</span>
1370 <span class='line'>1363</span> </span><span class="WHIT">  </span><span class="COMM">/*
1371 <span class='line'>1364</span>    * Key: Cancel
1372 <span class='line'>1365</span>    * Unicode: U+0018 [Cancel]
1373 <span class='line'>1366</span>    * keyIdentifier: U+0018
1374 <span class='line'>1367</span>    */</span><span class="WHIT">
1375 <span class='line'>1368</span> </span><span class="WHIT">  </span><span class="NUMB">24</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Cancel'</span><span class="PUNC">,</span><span class="WHIT">
1376 <span class='line'>1369</span>
1377 <span class='line'>1370</span> </span><span class="WHIT">  </span><span class="COMM">/*
1378 <span class='line'>1371</span>    * Key: Escape
1379 <span class='line'>1372</span>    * Unicode: U+001B [Escape]
1380 <span class='line'>1373</span>    * keyIdentifier: U+001B
1381 <span class='line'>1374</span>    */</span><span class="WHIT">
1382 <span class='line'>1375</span> </span><span class="WHIT">  </span><span class="NUMB">27</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Escape'</span><span class="PUNC">,</span><span class="WHIT">
1383 <span class='line'>1376</span>
1384 <span class='line'>1377</span> </span><span class="WHIT">  </span><span class="COMM">/*
1385 <span class='line'>1378</span>    * Key: Space
1386 <span class='line'>1379</span>    * Unicode: U+0020 [Space]
1387 <span class='line'>1380</span>    * keyIdentifier: U+0020
1388 <span class='line'>1381</span>    */</span><span class="WHIT">
1389 <span class='line'>1382</span> </span><span class="WHIT">  </span><span class="NUMB">32</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Space'</span><span class="PUNC">,</span><span class="WHIT">
1390 <span class='line'>1383</span>
1391 <span class='line'>1384</span> </span><span class="WHIT">  </span><span class="COMM">/*
1392 <span class='line'>1385</span>    * Key: PageUp or NumPad_North_East
1393 <span class='line'>1386</span>    * Unicode: U+0021 ! [Exclamation mark]
1394 <span class='line'>1387</span>    * keyIdentifier: PageUp
1395 <span class='line'>1388</span>    */</span><span class="WHIT">
1396 <span class='line'>1389</span> </span><span class="WHIT">  </span><span class="NUMB">33</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'PageUp'</span><span class="PUNC">,</span><span class="WHIT">
1397 <span class='line'>1390</span>
1398 <span class='line'>1391</span> </span><span class="WHIT">  </span><span class="COMM">/*
1399 <span class='line'>1392</span>    * Key: PageDown or NumPad_South_East
1400 <span class='line'>1393</span>    * Unicode: U+0022 " [Quotation mark]
1401 <span class='line'>1394</span>    * keyIdentifier: PageDown
1402 <span class='line'>1395</span>    */</span><span class="WHIT">
1403 <span class='line'>1396</span> </span><span class="WHIT">  </span><span class="NUMB">34</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'PageDown'</span><span class="PUNC">,</span><span class="WHIT">
1404 <span class='line'>1397</span>
1405 <span class='line'>1398</span> </span><span class="WHIT">  </span><span class="COMM">/*
1406 <span class='line'>1399</span>    * Key: End or NumPad_South_West
1407 <span class='line'>1400</span>    * Unicode: U+0023 # [Number sign]
1408 <span class='line'>1401</span>    * keyIdentifier: PageDown
1409 <span class='line'>1402</span>    */</span><span class="WHIT">
1410 <span class='line'>1403</span> </span><span class="WHIT">  </span><span class="NUMB">35</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'End'</span><span class="PUNC">,</span><span class="WHIT">
1411 <span class='line'>1404</span>
1412 <span class='line'>1405</span> </span><span class="WHIT">  </span><span class="COMM">/*
1413 <span class='line'>1406</span>    * Key: Home or NumPad_North_West
1414 <span class='line'>1407</span>    * Unicode: U+0024 $ [Dollar sign]
1415 <span class='line'>1408</span>    * keyIdentifier: Home
1416 <span class='line'>1409</span>    */</span><span class="WHIT">
1417 <span class='line'>1410</span> </span><span class="WHIT">  </span><span class="NUMB">36</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Home'</span><span class="PUNC">,</span><span class="WHIT">
1418 <span class='line'>1411</span>
1419 <span class='line'>1412</span> </span><span class="WHIT">  </span><span class="COMM">/*
1420 <span class='line'>1413</span>    * Key: Left or NumPad_West
1421 <span class='line'>1414</span>    * Unicode: U+0025 % [Percent sign]
1422 <span class='line'>1415</span>    * keyIdentifier: Left
1423 <span class='line'>1416</span>    */</span><span class="WHIT">
1424 <span class='line'>1417</span> </span><span class="WHIT">  </span><span class="NUMB">37</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Left'</span><span class="PUNC">,</span><span class="WHIT">
1425 <span class='line'>1418</span>
1426 <span class='line'>1419</span> </span><span class="WHIT">  </span><span class="COMM">/*
1427 <span class='line'>1420</span>    * Key: Up or NumPad_North
1428 <span class='line'>1421</span>    * Unicode: U+0026 & [Ampersand]
1429 <span class='line'>1422</span>    * keyIdentifier: Up
1430 <span class='line'>1423</span>    */</span><span class="WHIT">
1431 <span class='line'>1424</span> </span><span class="WHIT">  </span><span class="NUMB">38</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Up'</span><span class="PUNC">,</span><span class="WHIT">
1432 <span class='line'>1425</span>
1433 <span class='line'>1426</span> </span><span class="WHIT">  </span><span class="COMM">/*
1434 <span class='line'>1427</span>    * Key: Right or NumPad_East
1435 <span class='line'>1428</span>    * Unicode: U+0027 ' [Apostrophe]
1436 <span class='line'>1429</span>    * keyIdentifier: Right
1437 <span class='line'>1430</span>    */</span><span class="WHIT">
1438 <span class='line'>1431</span> </span><span class="WHIT">  </span><span class="NUMB">39</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Right'</span><span class="PUNC">,</span><span class="WHIT">
1439 <span class='line'>1432</span>
1440 <span class='line'>1433</span> </span><span class="WHIT">  </span><span class="COMM">/*
1441 <span class='line'>1434</span>    * Key: Down or NumPad_South
1442 <span class='line'>1435</span>    * Unicode: U+0028 ( [Left parenthesis]
1443 <span class='line'>1436</span>    * keyIdentifier: Down
1444 <span class='line'>1437</span>    */</span><span class="WHIT">
1445 <span class='line'>1438</span> </span><span class="WHIT">  </span><span class="NUMB">40</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Down'</span><span class="PUNC">,</span><span class="WHIT">
1446 <span class='line'>1439</span>
1447 <span class='line'>1440</span> </span><span class="WHIT">  </span><span class="COMM">/*
1448 <span class='line'>1441</span>    * Key: PrintScreen
1449 <span class='line'>1442</span>    * Unicode: U+002C , [Comma]
1450 <span class='line'>1443</span>    * keyIdentifier: PrintScreen
1451 <span class='line'>1444</span>    */</span><span class="WHIT">
1452 <span class='line'>1445</span> </span><span class="WHIT">  </span><span class="COMM">//44: 'PrintScreen',</span><span class="WHIT">
1453 <span class='line'>1446</span>
1454 <span class='line'>1447</span> </span><span class="WHIT">  </span><span class="COMM">/*
1455 <span class='line'>1448</span>    * Key: Insert or NumPad_Insert
1456 <span class='line'>1449</span>    * Unicode: U+002D - [Hyphen-Minus]
1457 <span class='line'>1450</span>    * keyIdentifier: Insert
1458 <span class='line'>1451</span>    */</span><span class="WHIT">
1459 <span class='line'>1452</span> </span><span class="WHIT">  </span><span class="NUMB">45</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Insert'</span><span class="PUNC">,</span><span class="WHIT">
1460 <span class='line'>1453</span>
1461 <span class='line'>1454</span> </span><span class="WHIT">  </span><span class="COMM">/*
1462 <span class='line'>1455</span>    * Key: Delete or NumPad_Delete
1463 <span class='line'>1456</span>    * Unicode: U+002E . [Full stop / period]
1464 <span class='line'>1457</span>    * keyIdentifier: U+007F
1465 <span class='line'>1458</span>    */</span><span class="WHIT">
1466 <span class='line'>1459</span> </span><span class="WHIT">  </span><span class="NUMB">46</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Delete'</span><span class="PUNC">,</span><span class="WHIT">
1467 <span class='line'>1460</span>
1468 <span class='line'>1461</span> </span><span class="WHIT">  </span><span class="COMM">/*
1469 <span class='line'>1462</span>    * Key: WinLeft
1470 <span class='line'>1463</span>    * Unicode: U+005B [ [Left square bracket]
1471 <span class='line'>1464</span>    * keyIdentifier: Win
1472 <span class='line'>1465</span>    *
1473 <span class='line'>1466</span>    * Disabled: rarely needed.
1474 <span class='line'>1467</span>    */</span><span class="WHIT">
1475 <span class='line'>1468</span> </span><span class="WHIT">  </span><span class="COMM">//91: 'Win',</span><span class="WHIT">
1476 <span class='line'>1469</span>
1477 <span class='line'>1470</span> </span><span class="WHIT">  </span><span class="COMM">/*
1478 <span class='line'>1471</span>    * Key: WinRight
1479 <span class='line'>1472</span>    * Unicode: U+005C \ [Reverse solidus / Backslash]
1480 <span class='line'>1473</span>    * keyIdentifier: Win
1481 <span class='line'>1474</span>    */</span><span class="WHIT">
1482 <span class='line'>1475</span> </span><span class="WHIT">  </span><span class="COMM">//92: 'Win',</span><span class="WHIT">
1483 <span class='line'>1476</span>
1484 <span class='line'>1477</span> </span><span class="WHIT">  </span><span class="COMM">/*
1485 <span class='line'>1478</span>    * Key: Menu/ContextMenu
1486 <span class='line'>1479</span>    * Unicode: U+005D ] [Right square bracket]
1487 <span class='line'>1480</span>    * keyIdentifier: ...
1488 <span class='line'>1481</span>    *
1489 <span class='line'>1482</span>    * Disabled: Is it Meta? Is it Menu, ContextMenu, what? Too much mess.
1490 <span class='line'>1483</span>    */</span><span class="WHIT">
1491 <span class='line'>1484</span> </span><span class="WHIT">  </span><span class="COMM">//93: 'ContextMenu',</span><span class="WHIT">
1492 <span class='line'>1485</span>
1493 <span class='line'>1486</span> </span><span class="WHIT">  </span><span class="COMM">/*
1494 <span class='line'>1487</span>    * Key: NumPad_0
1495 <span class='line'>1488</span>    * Unicode: U+0060 ` [Grave accent]
1496 <span class='line'>1489</span>    * keyIdentifier: 0
1497 <span class='line'>1490</span>    */</span><span class="WHIT">
1498 <span class='line'>1491</span> </span><span class="WHIT">  </span><span class="NUMB">96</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'0'</span><span class="PUNC">,</span><span class="WHIT">
1499 <span class='line'>1492</span>
1500 <span class='line'>1493</span> </span><span class="WHIT">  </span><span class="COMM">/*
1501 <span class='line'>1494</span>    * Key: NumPad_1
1502 <span class='line'>1495</span>    * Unicode: U+0061 a [Latin small letter a]
1503 <span class='line'>1496</span>    * keyIdentifier: 1
1504 <span class='line'>1497</span>    */</span><span class="WHIT">
1505 <span class='line'>1498</span> </span><span class="WHIT">  </span><span class="NUMB">97</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'1'</span><span class="PUNC">,</span><span class="WHIT">
1506 <span class='line'>1499</span>
1507 <span class='line'>1500</span> </span><span class="WHIT">  </span><span class="COMM">/*
1508 <span class='line'>1501</span>    * Key: NumPad_2
1509 <span class='line'>1502</span>    * Unicode: U+0062 b [Latin small letter b]
1510 <span class='line'>1503</span>    * keyIdentifier: 2
1511 <span class='line'>1504</span>    */</span><span class="WHIT">
1512 <span class='line'>1505</span> </span><span class="WHIT">  </span><span class="NUMB">98</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'2'</span><span class="PUNC">,</span><span class="WHIT">
1513 <span class='line'>1506</span>
1514 <span class='line'>1507</span> </span><span class="WHIT">  </span><span class="COMM">/*
1515 <span class='line'>1508</span>    * Key: NumPad_3
1516 <span class='line'>1509</span>    * Unicode: U+0063 c [Latin small letter c]
1517 <span class='line'>1510</span>    * keyIdentifier: 3
1518 <span class='line'>1511</span>    */</span><span class="WHIT">
1519 <span class='line'>1512</span> </span><span class="WHIT">  </span><span class="NUMB">99</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'3'</span><span class="PUNC">,</span><span class="WHIT">
1520 <span class='line'>1513</span>
1521 <span class='line'>1514</span> </span><span class="WHIT">  </span><span class="COMM">/*
1522 <span class='line'>1515</span>    * Key: NumPad_4
1523 <span class='line'>1516</span>    * Unicode: U+0064 d [Latin small letter d]
1524 <span class='line'>1517</span>    * keyIdentifier: 4
1525 <span class='line'>1518</span>    */</span><span class="WHIT">
1526 <span class='line'>1519</span> </span><span class="WHIT">  </span><span class="NUMB">100</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'4'</span><span class="PUNC">,</span><span class="WHIT">
1527 <span class='line'>1520</span>
1528 <span class='line'>1521</span> </span><span class="WHIT">  </span><span class="COMM">/*
1529 <span class='line'>1522</span>    * Key: NumPad_5
1530 <span class='line'>1523</span>    * Unicode: U+0065 e [Latin small letter e]
1531 <span class='line'>1524</span>    * keyIdentifier: 5
1532 <span class='line'>1525</span>    */</span><span class="WHIT">
1533 <span class='line'>1526</span> </span><span class="WHIT">  </span><span class="NUMB">101</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'5'</span><span class="PUNC">,</span><span class="WHIT">
1534 <span class='line'>1527</span>
1535 <span class='line'>1528</span> </span><span class="WHIT">  </span><span class="COMM">/*
1536 <span class='line'>1529</span>    * Key: NumPad_6
1537 <span class='line'>1530</span>    * Unicode: U+0066 f [Latin small letter f]
1538 <span class='line'>1531</span>    * keyIdentifier: 6
1539 <span class='line'>1532</span>    */</span><span class="WHIT">
1540 <span class='line'>1533</span> </span><span class="WHIT">  </span><span class="NUMB">102</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'6'</span><span class="PUNC">,</span><span class="WHIT">
1541 <span class='line'>1534</span>
1542 <span class='line'>1535</span> </span><span class="WHIT">  </span><span class="COMM">/*
1543 <span class='line'>1536</span>    * Key: NumPad_7
1544 <span class='line'>1537</span>    * Unicode: U+0067 g [Latin small letter g]
1545 <span class='line'>1538</span>    * keyIdentifier: 7
1546 <span class='line'>1539</span>    */</span><span class="WHIT">
1547 <span class='line'>1540</span> </span><span class="WHIT">  </span><span class="NUMB">103</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'7'</span><span class="PUNC">,</span><span class="WHIT">
1548 <span class='line'>1541</span>
1549 <span class='line'>1542</span> </span><span class="WHIT">  </span><span class="COMM">/*
1550 <span class='line'>1543</span>    * Key: NumPad_8
1551 <span class='line'>1544</span>    * Unicode: U+0068 h [Latin small letter h]
1552 <span class='line'>1545</span>    * keyIdentifier: 8
1553 <span class='line'>1546</span>    */</span><span class="WHIT">
1554 <span class='line'>1547</span> </span><span class="WHIT">  </span><span class="NUMB">104</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'8'</span><span class="PUNC">,</span><span class="WHIT">
1555 <span class='line'>1548</span>
1556 <span class='line'>1549</span> </span><span class="WHIT">  </span><span class="COMM">/*
1557 <span class='line'>1550</span>    * Key: NumPad_9
1558 <span class='line'>1551</span>    * Unicode: U+0069 i [Latin small letter i]
1559 <span class='line'>1552</span>    * keyIdentifier: 9
1560 <span class='line'>1553</span>    */</span><span class="WHIT">
1561 <span class='line'>1554</span> </span><span class="WHIT">  </span><span class="NUMB">105</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'9'</span><span class="PUNC">,</span><span class="WHIT">
1562 <span class='line'>1555</span>
1563 <span class='line'>1556</span> </span><span class="WHIT">  </span><span class="COMM">/*
1564 <span class='line'>1557</span>    * Key: NumPad_Multiply
1565 <span class='line'>1558</span>    * Unicode: U+0070 j [Latin small letter j]
1566 <span class='line'>1559</span>    * keyIdentifier: U+002A * [Asterisk / Star]
1567 <span class='line'>1560</span>    */</span><span class="WHIT">
1568 <span class='line'>1561</span> </span><span class="WHIT">  </span><span class="NUMB">106</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'*'</span><span class="PUNC">,</span><span class="WHIT">
1569 <span class='line'>1562</span>
1570 <span class='line'>1563</span> </span><span class="WHIT">  </span><span class="COMM">/*
1571 <span class='line'>1564</span>    * Key: NumPad_Plus
1572 <span class='line'>1565</span>    * Unicode: U+0071 k [Latin small letter k]
1573 <span class='line'>1566</span>    * keyIdentifier: U+002B + [Plus]
1574 <span class='line'>1567</span>    */</span><span class="WHIT">
1575 <span class='line'>1568</span> </span><span class="WHIT">  </span><span class="NUMB">107</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'+'</span><span class="PUNC">,</span><span class="WHIT">
1576 <span class='line'>1569</span>
1577 <span class='line'>1570</span> </span><span class="WHIT">  </span><span class="COMM">/*
1578 <span class='line'>1571</span>    * Key: NumPad_Minus
1579 <span class='line'>1572</span>    * Unicode: U+0073 m [Latin small letter m]
1580 <span class='line'>1573</span>    * keyIdentifier: U+002D + [Hyphen / Minus]
1581 <span class='line'>1574</span>    */</span><span class="WHIT">
1582 <span class='line'>1575</span> </span><span class="WHIT">  </span><span class="NUMB">109</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'-'</span><span class="PUNC">,</span><span class="WHIT">
1583 <span class='line'>1576</span>
1584 <span class='line'>1577</span> </span><span class="WHIT">  </span><span class="COMM">/*
1585 <span class='line'>1578</span>    * Key: NumPad_Period
1586 <span class='line'>1579</span>    * Unicode: U+0074 n [Latin small letter n]
1587 <span class='line'>1580</span>    * keyIdentifier: U+002E . [Period]
1588 <span class='line'>1581</span>    */</span><span class="WHIT">
1589 <span class='line'>1582</span> </span><span class="WHIT">  </span><span class="NUMB">110</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'.'</span><span class="PUNC">,</span><span class="WHIT">
1590 <span class='line'>1583</span>
1591 <span class='line'>1584</span> </span><span class="WHIT">  </span><span class="COMM">/*
1592 <span class='line'>1585</span>    * Key: NumPad_Division
1593 <span class='line'>1586</span>    * Unicode: U+0075 o [Latin small letter o]
1594 <span class='line'>1587</span>    * keyIdentifier: U+002F / [Solidus / Slash]
1595 <span class='line'>1588</span>    */</span><span class="WHIT">
1596 <span class='line'>1589</span> </span><span class="WHIT">  </span><span class="NUMB">111</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'/'</span><span class="PUNC">,</span><span class="WHIT">
1597 <span class='line'>1590</span>
1598 <span class='line'>1591</span> </span><span class="WHIT">  </span><span class="NUMB">112</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'F1'</span><span class="PUNC">,</span><span class="WHIT">                </span><span class="COMM">// p</span><span class="WHIT">
1599 <span class='line'>1592</span> </span><span class="WHIT">  </span><span class="NUMB">113</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'F2'</span><span class="PUNC">,</span><span class="WHIT">                </span><span class="COMM">// q</span><span class="WHIT">
1600 <span class='line'>1593</span> </span><span class="WHIT">  </span><span class="NUMB">114</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'F3'</span><span class="PUNC">,</span><span class="WHIT">                </span><span class="COMM">// r</span><span class="WHIT">
1601 <span class='line'>1594</span> </span><span class="WHIT">  </span><span class="NUMB">115</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'F4'</span><span class="PUNC">,</span><span class="WHIT">                </span><span class="COMM">// s</span><span class="WHIT">
1602 <span class='line'>1595</span> </span><span class="WHIT">  </span><span class="NUMB">116</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'F5'</span><span class="PUNC">,</span><span class="WHIT">                </span><span class="COMM">// t</span><span class="WHIT">
1603 <span class='line'>1596</span> </span><span class="WHIT">  </span><span class="NUMB">117</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'F6'</span><span class="PUNC">,</span><span class="WHIT">                </span><span class="COMM">// u</span><span class="WHIT">
1604 <span class='line'>1597</span> </span><span class="WHIT">  </span><span class="NUMB">118</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'F7'</span><span class="PUNC">,</span><span class="WHIT">                </span><span class="COMM">// v</span><span class="WHIT">
1605 <span class='line'>1598</span> </span><span class="WHIT">  </span><span class="NUMB">119</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'F8'</span><span class="PUNC">,</span><span class="WHIT">                </span><span class="COMM">// w</span><span class="WHIT">
1606 <span class='line'>1599</span> </span><span class="WHIT">  </span><span class="NUMB">120</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'F9'</span><span class="PUNC">,</span><span class="WHIT">                </span><span class="COMM">// x</span><span class="WHIT">
1607 <span class='line'>1600</span> </span><span class="WHIT">  </span><span class="NUMB">121</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'F10'</span><span class="PUNC">,</span><span class="WHIT">               </span><span class="COMM">// y</span><span class="WHIT">
1608 <span class='line'>1601</span> </span><span class="WHIT">  </span><span class="NUMB">122</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'F11'</span><span class="PUNC">,</span><span class="WHIT">               </span><span class="COMM">// z</span><span class="WHIT">
1609 <span class='line'>1602</span> </span><span class="WHIT">  </span><span class="NUMB">123</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'F12'</span><span class="PUNC">,</span><span class="WHIT">               </span><span class="COMM">// {</span><span class="WHIT">
1610 <span class='line'>1603</span>
1611 <span class='line'>1604</span> </span><span class="WHIT">  </span><span class="COMM">/*
1612 <span class='line'>1605</span>    * Key: Delete
1613 <span class='line'>1606</span>    * Unicode: U+007F [Delete]
1614 <span class='line'>1607</span>    * keyIdentifier: U+007F
1615 <span class='line'>1608</span>    */</span><span class="WHIT">
1616 <span class='line'>1609</span> </span><span class="WHIT">  </span><span class="NUMB">127</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'Delete'</span><span class="PUNC">,</span><span class="WHIT">
1617 <span class='line'>1610</span>
1618 <span class='line'>1611</span> </span><span class="WHIT">  </span><span class="COMM">/*
1619 <span class='line'>1612</span>    * Key: NumLock
1620 <span class='line'>1613</span>    * Unicode: U+0090 [Device control string]
1621 <span class='line'>1614</span>    * keyIdentifier: NumLock
1622 <span class='line'>1615</span>    */</span><span class="WHIT">
1623 <span class='line'>1616</span> </span><span class="WHIT">  </span><span class="NUMB">144</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'NumLock'</span><span class="PUNC">,</span><span class="WHIT">
1624 <span class='line'>1617</span>
1625 <span class='line'>1618</span> </span><span class="WHIT">  </span><span class="NUMB">186</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">';'</span><span class="PUNC">,</span><span class="WHIT">                 </span><span class="COMM">// º (Masculine ordinal indicator)</span><span class="WHIT">
1626 <span class='line'>1619</span> </span><span class="WHIT">  </span><span class="NUMB">187</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'='</span><span class="PUNC">,</span><span class="WHIT">                 </span><span class="COMM">// »</span><span class="WHIT">
1627 <span class='line'>1620</span> </span><span class="WHIT">  </span><span class="NUMB">188</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">','</span><span class="PUNC">,</span><span class="WHIT">                 </span><span class="COMM">// ¼</span><span class="WHIT">
1628 <span class='line'>1621</span> </span><span class="WHIT">  </span><span class="NUMB">189</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'-'</span><span class="PUNC">,</span><span class="WHIT">                 </span><span class="COMM">// ½</span><span class="WHIT">
1629 <span class='line'>1622</span> </span><span class="WHIT">  </span><span class="NUMB">190</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'.'</span><span class="PUNC">,</span><span class="WHIT">                 </span><span class="COMM">// ¾</span><span class="WHIT">
1630 <span class='line'>1623</span> </span><span class="WHIT">  </span><span class="NUMB">191</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'/'</span><span class="PUNC">,</span><span class="WHIT">                 </span><span class="COMM">// ¿</span><span class="WHIT">
1631 <span class='line'>1624</span> </span><span class="WHIT">  </span><span class="NUMB">192</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'`'</span><span class="PUNC">,</span><span class="WHIT">                 </span><span class="COMM">// À</span><span class="WHIT">
1632 <span class='line'>1625</span> </span><span class="WHIT">  </span><span class="NUMB">219</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'['</span><span class="PUNC">,</span><span class="WHIT">                 </span><span class="COMM">// Û</span><span class="WHIT">
1633 <span class='line'>1626</span> </span><span class="WHIT">  </span><span class="NUMB">220</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">'\\'</span><span class="PUNC">,</span><span class="WHIT">                </span><span class="COMM">// Ü</span><span class="WHIT">
1634 <span class='line'>1627</span> </span><span class="WHIT">  </span><span class="NUMB">221</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">']'</span><span class="PUNC">,</span><span class="WHIT">                 </span><span class="COMM">// Ý</span><span class="WHIT">
1635 <span class='line'>1628</span> </span><span class="WHIT">  </span><span class="NUMB">222</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="STRN">"'"</span><span class="WHIT">                  </span><span class="COMM">// Þ (Latin capital letter thorn)</span><span class="WHIT">
1636 <span class='line'>1629</span>
1637 <span class='line'>1630</span> </span><span class="WHIT">  </span><span class="COMM">//224: 'Win',               // à</span><span class="WHIT">
1638 <span class='line'>1631</span> </span><span class="WHIT">  </span><span class="COMM">//229: 'WinIME',            // å or WinIME or something else in Webkit</span><span class="WHIT">
1639 <span class='line'>1632</span> </span><span class="WHIT">  </span><span class="COMM">//255: 'NumLock',           // ÿ, Gecko and Chrome, Windows XP in VirtualBox</span><span class="WHIT">
1640 <span class='line'>1633</span> </span><span class="WHIT">  </span><span class="COMM">//376: 'NumLock'            // Ÿ, Opera, Windows XP in VirtualBox</span><span class="WHIT">
1641 <span class='line'>1634</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
1642 <span class='line'>1635</span>
1643 <span class='line'>1636</span> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">pwlib.browser.gecko</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1644 <span class='line'>1637</span> </span><span class="WHIT">  </span><span class="NAME">pwlib.dom.keyCodes</span><span class="PUNC">[</span><span class="NUMB">3</span><span class="PUNC">]</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="STRN">'Cancel'</span><span class="PUNC">;</span><span class="WHIT"> </span><span class="COMM">// DOM_VK_CANCEL</span><span class="WHIT">
1645 <span class='line'>1638</span> </span><span class="PUNC">}</span><span class="WHIT">
1646 <span class='line'>1639</span>
1647 <span class='line'>1640</span> </span><span class="COMM">/**
1648 <span class='line'>1641</span>  * @namespace Holds a list of common wrong key codes in Web browsers.
1649 <span class='line'>1642</span>  *
1650 <span class='line'>1643</span>  * @private
1651 <span class='line'>1644</span>  */</span><span class="WHIT">
1652 <span class='line'>1645</span> </span><span class="NAME">pwlib.dom.keyCodes_fixes</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1653 <span class='line'>1646</span> </span><span class="WHIT">  </span><span class="NUMB">42</span><span class="PUNC">:</span><span class="WHIT">   </span><span class="NAME">pwlib.dom.keyNames</span><span class="PUNC">[</span><span class="STRN">'*'</span><span class="PUNC">]</span><span class="PUNC">,</span><span class="WHIT">        </span><span class="COMM">// char * to key *</span><span class="WHIT">
1654 <span class='line'>1647</span> </span><span class="WHIT">  </span><span class="NUMB">47</span><span class="PUNC">:</span><span class="WHIT">   </span><span class="NAME">pwlib.dom.keyNames</span><span class="PUNC">[</span><span class="STRN">'/'</span><span class="PUNC">]</span><span class="PUNC">,</span><span class="WHIT">        </span><span class="COMM">// char / to key /</span><span class="WHIT">
1655 <span class='line'>1648</span> </span><span class="WHIT">  </span><span class="NUMB">59</span><span class="PUNC">:</span><span class="WHIT">   </span><span class="NAME">pwlib.dom.keyNames</span><span class="PUNC">[</span><span class="STRN">';'</span><span class="PUNC">]</span><span class="PUNC">,</span><span class="WHIT">        </span><span class="COMM">// char ; to key ;</span><span class="WHIT">
1656 <span class='line'>1649</span> </span><span class="WHIT">  </span><span class="NUMB">61</span><span class="PUNC">:</span><span class="WHIT">   </span><span class="NAME">pwlib.dom.keyNames</span><span class="PUNC">[</span><span class="STRN">'='</span><span class="PUNC">]</span><span class="PUNC">,</span><span class="WHIT">        </span><span class="COMM">// char = to key =</span><span class="WHIT">
1657 <span class='line'>1650</span> </span><span class="WHIT">  </span><span class="NUMB">96</span><span class="PUNC">:</span><span class="WHIT">   </span><span class="NUMB">48</span><span class="PUNC">,</span><span class="WHIT">                             </span><span class="COMM">// NumPad_0 to char 0</span><span class="WHIT">
1658 <span class='line'>1651</span> </span><span class="WHIT">  </span><span class="NUMB">97</span><span class="PUNC">:</span><span class="WHIT">   </span><span class="NUMB">49</span><span class="PUNC">,</span><span class="WHIT">                             </span><span class="COMM">// NumPad_1 to char 1</span><span class="WHIT">
1659 <span class='line'>1652</span> </span><span class="WHIT">  </span><span class="NUMB">98</span><span class="PUNC">:</span><span class="WHIT">   </span><span class="NUMB">50</span><span class="PUNC">,</span><span class="WHIT">                             </span><span class="COMM">// NumPad_2 to char 2</span><span class="WHIT">
1660 <span class='line'>1653</span> </span><span class="WHIT">  </span><span class="NUMB">99</span><span class="PUNC">:</span><span class="WHIT">   </span><span class="NUMB">51</span><span class="PUNC">,</span><span class="WHIT">                             </span><span class="COMM">// NumPad_3 to char 3</span><span class="WHIT">
1661 <span class='line'>1654</span> </span><span class="WHIT">  </span><span class="NUMB">100</span><span class="PUNC">:</span><span class="WHIT">  </span><span class="NUMB">52</span><span class="PUNC">,</span><span class="WHIT">                             </span><span class="COMM">// NumPad_4 to char 4</span><span class="WHIT">
1662 <span class='line'>1655</span> </span><span class="WHIT">  </span><span class="NUMB">101</span><span class="PUNC">:</span><span class="WHIT">  </span><span class="NUMB">53</span><span class="PUNC">,</span><span class="WHIT">                             </span><span class="COMM">// NumPad_5 to char 5</span><span class="WHIT">
1663 <span class='line'>1656</span> </span><span class="WHIT">  </span><span class="NUMB">102</span><span class="PUNC">:</span><span class="WHIT">  </span><span class="NUMB">54</span><span class="PUNC">,</span><span class="WHIT">                             </span><span class="COMM">// NumPad_6 to char 6</span><span class="WHIT">
1664 <span class='line'>1657</span> </span><span class="WHIT">  </span><span class="NUMB">103</span><span class="PUNC">:</span><span class="WHIT">  </span><span class="NUMB">55</span><span class="PUNC">,</span><span class="WHIT">                             </span><span class="COMM">// NumPad_7 to char 7</span><span class="WHIT">
1665 <span class='line'>1658</span> </span><span class="WHIT">  </span><span class="NUMB">104</span><span class="PUNC">:</span><span class="WHIT">  </span><span class="NUMB">56</span><span class="PUNC">,</span><span class="WHIT">                             </span><span class="COMM">// NumPad_8 to char 8</span><span class="WHIT">
1666 <span class='line'>1659</span> </span><span class="WHIT">  </span><span class="NUMB">105</span><span class="PUNC">:</span><span class="WHIT">  </span><span class="NUMB">57</span><span class="PUNC">,</span><span class="WHIT">                             </span><span class="COMM">// NumPad_9 to char 9</span><span class="WHIT">
1667 <span class='line'>1660</span> </span><span class="WHIT">  </span><span class="COMM">//106:  56,                           // NumPad_Multiply to char 8</span><span class="WHIT">
1668 <span class='line'>1661</span> </span><span class="WHIT">  </span><span class="COMM">//107:  187,                          // NumPad_Plus to key =</span><span class="WHIT">
1669 <span class='line'>1662</span> </span><span class="WHIT">  </span><span class="NUMB">109</span><span class="PUNC">:</span><span class="WHIT">  </span><span class="NAME">pwlib.dom.keyNames</span><span class="PUNC">[</span><span class="STRN">'-'</span><span class="PUNC">]</span><span class="PUNC">,</span><span class="WHIT">        </span><span class="COMM">// NumPad_Minus to key -</span><span class="WHIT">
1670 <span class='line'>1663</span> </span><span class="WHIT">  </span><span class="NUMB">110</span><span class="PUNC">:</span><span class="WHIT">  </span><span class="NAME">pwlib.dom.keyNames</span><span class="PUNC">[</span><span class="STRN">'.'</span><span class="PUNC">]</span><span class="PUNC">,</span><span class="WHIT">        </span><span class="COMM">// NumPad_Period to key .</span><span class="WHIT">
1671 <span class='line'>1664</span> </span><span class="WHIT">  </span><span class="NUMB">111</span><span class="PUNC">:</span><span class="WHIT">  </span><span class="NAME">pwlib.dom.keyNames</span><span class="PUNC">[</span><span class="STRN">'/'</span><span class="PUNC">]</span><span class="WHIT">         </span><span class="COMM">// NumPad_Division to key /</span><span class="WHIT">
1672 <span class='line'>1665</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
1673 <span class='line'>1666</span>
1674 <span class='line'>1667</span> </span><span class="COMM">/**
1675 <span class='line'>1668</span>  * @namespace Holds the list of broken key codes generated by older Webkit
1676 <span class='line'>1669</span>  * (Safari 2).
1677 <span class='line'>1670</span>  *
1678 <span class='line'>1671</span>  * @private
1679 <span class='line'>1672</span>  */</span><span class="WHIT">
1680 <span class='line'>1673</span> </span><span class="NAME">pwlib.dom.keyCodes_Safari2</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1681 <span class='line'>1674</span> </span><span class="WHIT">  </span><span class="NUMB">63232</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.Up</span><span class="PUNC">,</span><span class="WHIT">               </span><span class="COMM">// 38</span><span class="WHIT">
1682 <span class='line'>1675</span> </span><span class="WHIT">  </span><span class="NUMB">63233</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.Down</span><span class="PUNC">,</span><span class="WHIT">             </span><span class="COMM">// 40</span><span class="WHIT">
1683 <span class='line'>1676</span> </span><span class="WHIT">  </span><span class="NUMB">63234</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.Left</span><span class="PUNC">,</span><span class="WHIT">             </span><span class="COMM">// 37</span><span class="WHIT">
1684 <span class='line'>1677</span> </span><span class="WHIT">  </span><span class="NUMB">63235</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.Right</span><span class="PUNC">,</span><span class="WHIT">            </span><span class="COMM">// 39</span><span class="WHIT">
1685 <span class='line'>1678</span> </span><span class="WHIT">  </span><span class="NUMB">63236</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.F1</span><span class="PUNC">,</span><span class="WHIT">               </span><span class="COMM">// 112</span><span class="WHIT">
1686 <span class='line'>1679</span> </span><span class="WHIT">  </span><span class="NUMB">63237</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.F2</span><span class="PUNC">,</span><span class="WHIT">               </span><span class="COMM">// 113</span><span class="WHIT">
1687 <span class='line'>1680</span> </span><span class="WHIT">  </span><span class="NUMB">63238</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.F3</span><span class="PUNC">,</span><span class="WHIT">               </span><span class="COMM">// 114</span><span class="WHIT">
1688 <span class='line'>1681</span> </span><span class="WHIT">  </span><span class="NUMB">63239</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.F4</span><span class="PUNC">,</span><span class="WHIT">               </span><span class="COMM">// 115</span><span class="WHIT">
1689 <span class='line'>1682</span> </span><span class="WHIT">  </span><span class="NUMB">63240</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.F5</span><span class="PUNC">,</span><span class="WHIT">               </span><span class="COMM">// 116</span><span class="WHIT">
1690 <span class='line'>1683</span> </span><span class="WHIT">  </span><span class="NUMB">63241</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.F6</span><span class="PUNC">,</span><span class="WHIT">               </span><span class="COMM">// 117</span><span class="WHIT">
1691 <span class='line'>1684</span> </span><span class="WHIT">  </span><span class="NUMB">63242</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.F7</span><span class="PUNC">,</span><span class="WHIT">               </span><span class="COMM">// 118</span><span class="WHIT">
1692 <span class='line'>1685</span> </span><span class="WHIT">  </span><span class="NUMB">63243</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.F8</span><span class="PUNC">,</span><span class="WHIT">               </span><span class="COMM">// 119</span><span class="WHIT">
1693 <span class='line'>1686</span> </span><span class="WHIT">  </span><span class="NUMB">63244</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.F9</span><span class="PUNC">,</span><span class="WHIT">               </span><span class="COMM">// 120</span><span class="WHIT">
1694 <span class='line'>1687</span> </span><span class="WHIT">  </span><span class="NUMB">63245</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.F10</span><span class="PUNC">,</span><span class="WHIT">              </span><span class="COMM">// 121</span><span class="WHIT">
1695 <span class='line'>1688</span> </span><span class="WHIT">  </span><span class="NUMB">63246</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.F11</span><span class="PUNC">,</span><span class="WHIT">              </span><span class="COMM">// 122</span><span class="WHIT">
1696 <span class='line'>1689</span> </span><span class="WHIT">  </span><span class="NUMB">63247</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.F12</span><span class="PUNC">,</span><span class="WHIT">              </span><span class="COMM">// 123</span><span class="WHIT">
1697 <span class='line'>1690</span> </span><span class="WHIT">  </span><span class="NUMB">63248</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.PrintScreen</span><span class="PUNC">,</span><span class="WHIT">      </span><span class="COMM">// 44</span><span class="WHIT">
1698 <span class='line'>1691</span> </span><span class="WHIT">  </span><span class="NUMB">63272</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames</span><span class="PUNC">[</span><span class="STRN">'Delete'</span><span class="PUNC">]</span><span class="PUNC">,</span><span class="WHIT">        </span><span class="COMM">// 46</span><span class="WHIT">
1699 <span class='line'>1692</span> </span><span class="WHIT">  </span><span class="NUMB">63273</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.Home</span><span class="PUNC">,</span><span class="WHIT">             </span><span class="COMM">// 36</span><span class="WHIT">
1700 <span class='line'>1693</span> </span><span class="WHIT">  </span><span class="NUMB">63275</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.End</span><span class="PUNC">,</span><span class="WHIT">              </span><span class="COMM">// 35</span><span class="WHIT">
1701 <span class='line'>1694</span> </span><span class="WHIT">  </span><span class="NUMB">63276</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.PageUp</span><span class="PUNC">,</span><span class="WHIT">           </span><span class="COMM">// 33</span><span class="WHIT">
1702 <span class='line'>1695</span> </span><span class="WHIT">  </span><span class="NUMB">63277</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.PageDown</span><span class="PUNC">,</span><span class="WHIT">         </span><span class="COMM">// 34</span><span class="WHIT">
1703 <span class='line'>1696</span> </span><span class="WHIT">  </span><span class="NUMB">63289</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.NumLock</span><span class="PUNC">,</span><span class="WHIT">          </span><span class="COMM">// 144</span><span class="WHIT">
1704 <span class='line'>1697</span> </span><span class="WHIT">  </span><span class="NUMB">63302</span><span class="PUNC">:</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.Insert</span><span class="WHIT">            </span><span class="COMM">// 45</span><span class="WHIT">
1705 <span class='line'>1698</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
1706 <span class='line'>1699</span>
1707 <span class='line'>1700</span>
1708 <span class='line'>1701</span> </span><span class="COMM">/**
1709 <span class='line'>1702</span>  * A complete keyboard events cross-browser compatibility layer.
1710 <span class='line'>1703</span>  *
1711 <span class='line'>1704</span>  * &lt;p>Unfortunately, due to the important differences across Web browsers,
1712 <span class='line'>1705</span>  * simply using the available properties in a single keyboard event is not
1713 <span class='line'>1706</span>  * enough to accurately determine the key the user pressed. Thus, one needs to
1714 <span class='line'>1707</span>  * have event handlers for all keyboard-related events &lt;code>keydown&lt;/code>,
1715 <span class='line'>1708</span>  * &lt;code>keypress&lt;/code> and &lt;code>keyup&lt;/code>.
1716 <span class='line'>1709</span>  *
1717 <span class='line'>1710</span>  * &lt;p>This class provides a complete keyboard event compatibility layer. For any
1718 <span class='line'>1711</span>  * new instance you provide the DOM element you want to listen events for, and
1719 <span class='line'>1712</span>  * the event handlers for any of the three events &lt;code>keydown&lt;/code>
1720 <span class='line'>1713</span>  * / &lt;code>keypress&lt;/code> / &lt;code>keyup&lt;/code>.
1721 <span class='line'>1714</span>  *
1722 <span class='line'>1715</span>  * &lt;p>Your event handlers will receive the original DOM Event object, with
1723 <span class='line'>1716</span>  * several new properties defined:
1724 <span class='line'>1717</span>  *
1725 <span class='line'>1718</span>  * &lt;ul>
1726 <span class='line'>1719</span>  *   &lt;li>&lt;var>event.keyCode_&lt;/var> holds the correct code for event key.
1727 <span class='line'>1720</span>  *
1728 <span class='line'>1721</span>  *   &lt;li>&lt;var>event.key_&lt;/var> holds the key the user pressed. It can be either
1729 <span class='line'>1722</span>  *   a key name like "PageDown", "Delete", "Enter", or it is a character like
1730 <span class='line'>1723</span>  *   "A", "1", or "[".
1731 <span class='line'>1724</span>  *
1732 <span class='line'>1725</span>  *   &lt;li>&lt;var>event.charCode_&lt;/var> holds the Unicode character decimal code.
1733 <span class='line'>1726</span>  *
1734 <span class='line'>1727</span>  *   &lt;li>&lt;var>event.char_&lt;/var> holds the character generated by the event.
1735 <span class='line'>1728</span>  *
1736 <span class='line'>1729</span>  *   &lt;li>&lt;var>event.repeat_&lt;/var> is a boolean property telling if the
1737 <span class='line'>1730</span>  *   &lt;code>keypress&lt;/code> event is repeated - the user is holding down the key
1738 <span class='line'>1731</span>  *   for a long-enough period of time to generate multiple events.
1739 <span class='line'>1732</span>  * &lt;/ul>
1740 <span class='line'>1733</span>  *
1741 <span class='line'>1734</span>  * &lt;p>The character-related properties, &lt;var>charCode_&lt;/var> and
1742 <span class='line'>1735</span>  * &lt;var>char_&lt;/var> are only available in the &lt;code>keypress&lt;/code> and
1743 <span class='line'>1736</span>  * &lt;code>keyup&lt;/code> event objects.
1744 <span class='line'>1737</span>  *
1745 <span class='line'>1738</span>  * &lt;p>This class will ensure that the &lt;code>keypress&lt;/code> event is always
1746 <span class='line'>1739</span>  * fired in Webkit and MSIE for all keys, except modifiers. For modifier keys
1747 <span class='line'>1740</span>  * like &lt;kbd>Shift&lt;/kbd>, &lt;kbd>Control&lt;/kbd>, and &lt;kbd>Alt&lt;/kbd>, the
1748 <span class='line'>1741</span>  * &lt;code>keypress&lt;/code> event will not be fired, even if the Web browser does
1749 <span class='line'>1742</span>  * it.
1750 <span class='line'>1743</span>  *
1751 <span class='line'>1744</span>  * &lt;p>Some user agents like Webkit repeat the &lt;code>keydown&lt;/code> event while
1752 <span class='line'>1745</span>  * the user holds down a key. This class will ensure that only the
1753 <span class='line'>1746</span>  * &lt;code>keypress&lt;/code> event is repeated.
1754 <span class='line'>1747</span>  *
1755 <span class='line'>1748</span>  * &lt;p>If you want to prevent the default action for an event, you should prevent
1756 <span class='line'>1749</span>  * it on &lt;code>keypress&lt;/code>. This class will prevent the default action for
1757 <span class='line'>1750</span>  * &lt;code>keydown&lt;/code> if need (in MSIE).
1758 <span class='line'>1751</span>  *
1759 <span class='line'>1752</span>  * @example
1760 <span class='line'>1753</span>  * &lt;code>var &lt;var>klogger&lt;/var> = function (&lt;var>ev&lt;/var>) {
1761 <span class='line'>1754</span>  *   console.log(&lt;var>ev&lt;/var>.type +
1762 <span class='line'>1755</span>  *     ' keyCode_ ' + &lt;var>ev&lt;/var>.keyCode_ +
1763 <span class='line'>1756</span>  *     ' key_ ' + &lt;var>ev&lt;/var>.key_ +
1764 <span class='line'>1757</span>  *     ' charCode_ ' + &lt;var>ev&lt;/var>.charCode_ +
1765 <span class='line'>1758</span>  *     ' char_ ' + &lt;var>ev&lt;/var>.char_ +
1766 <span class='line'>1759</span>  *     ' repeat_ ' + &lt;var>ev&lt;/var>.repeat_);
1767 <span class='line'>1760</span>  * };
1768 <span class='line'>1761</span>  *
1769 <span class='line'>1762</span>  * var &lt;var>kbListener&lt;/var> = new pwlib.dom.KeyboardEventListener(window,
1770 <span class='line'>1763</span>  *               {keydown: &lt;var>klogger&lt;/var>,
1771 <span class='line'>1764</span>  *                keypress: &lt;var>klogger&lt;/var>,
1772 <span class='line'>1765</span>  *                keyup: &lt;var>klogger&lt;/var>});&lt;/code>
1773 <span class='line'>1766</span>  *
1774 <span class='line'>1767</span>  * // later when you're done...
1775 <span class='line'>1768</span>  * &lt;code>&lt;var>kbListener&lt;/var>.detach();&lt;/code>
1776 <span class='line'>1769</span>  *
1777 <span class='line'>1770</span>  * @class A complete keyboard events cross-browser compatibility layer.
1778 <span class='line'>1771</span>  *
1779 <span class='line'>1772</span>  * @param {Element} elem_ The DOM Element you want to listen events for.
1780 <span class='line'>1773</span>  *
1781 <span class='line'>1774</span>  * @param {Object} handlers_ The object holding the list of event handlers
1782 <span class='line'>1775</span>  * associated to the name of each keyboard event you want to listen. To listen
1783 <span class='line'>1776</span>  * for all the three keyboard events use &lt;code>{keydown: &lt;var>fn1&lt;/var>,
1784 <span class='line'>1777</span>  * keypress: &lt;var>fn2&lt;/var>, keyup: &lt;var>fn3&lt;/var>}&lt;/code>.
1785 <span class='line'>1778</span>  *
1786 <span class='line'>1779</span>  * @throws {TypeError} If the &lt;var>handlers_&lt;/var> object does not contain any
1787 <span class='line'>1780</span>  * event handler.
1788 <span class='line'>1781</span>  */</span><span class="WHIT">
1789 <span class='line'>1782</span> </span><span class="NAME">pwlib.dom.KeyboardEventListener</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">elem_</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">handlers_</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
1790 <span class='line'>1783</span> </span><span class="WHIT">  </span><span class="COMM">/*
1791 <span class='line'>1784</span>     Technical details:
1792 <span class='line'>1785</span>
1793 <span class='line'>1786</span>     For the keyup and keydown events the keyCode provided is that of the virtual
1794 <span class='line'>1787</span>     key irrespective of other modifiers (e.g. Shift). Generally, during the
1795 <span class='line'>1788</span>     keypress event, the keyCode holds the Unicode value of the character
1796 <span class='line'>1789</span>     resulted from the key press, say an alphabetic upper/lower-case char,
1797 <span class='line'>1790</span>     depending on the actual intent of the user and depending on the currently
1798 <span class='line'>1791</span>     active keyboard layout.
1799 <span class='line'>1792</span>
1800 <span class='line'>1793</span>     Examples:
1801 <span class='line'>1794</span>     * Pressing p you get keyCode 80 in keyup/keydown, and keyCode 112 in
1802 <span class='line'>1795</span>     keypress.  String.fromCharCode(80) = 'P' and String.fromCharCode(112) = 'p'.
1803 <span class='line'>1796</span>     * Pressing P you get keyCode 80 in all events.
1804 <span class='line'>1797</span>     * Pressing F1 you get keyCode 112 in keyup, keydown and keypress.
1805 <span class='line'>1798</span>     * Pressing 9 you get keyCode 57 in all events.
1806 <span class='line'>1799</span>     * Pressing Shift+9 you get keyCode 57 in keyup/keydown, and keyCode 40 in
1807 <span class='line'>1800</span>     keypress. String.fromCharCode(57) = '9' and String.fromCharCode(40) = '('.
1808 <span class='line'>1801</span>
1809 <span class='line'>1802</span>     * Using the Greek layout when you press v on an US keyboard you get the
1810 <span class='line'>1803</span>     output character ω. The keyup/keydown events hold keyCode 86 which is V.
1811 <span class='line'>1804</span>     This does make sense, since it's the virtual key code we are dealing with
1812 <span class='line'>1805</span>     - not the character code, not the result of pressing the key. The keypress
1813 <span class='line'>1806</span>     event will hold keyCode 969 (ω).
1814 <span class='line'>1807</span>
1815 <span class='line'>1808</span>     * Pressing NumPad_Minus you get keyCode 109 in keyup/keydown and keyCode 45
1816 <span class='line'>1809</span>     in keypress. Again, this happens because in keyup/keydown you don't get the
1817 <span class='line'>1810</span>     character code, you get the key code, as indicated above. For
1818 <span class='line'>1811</span>     your information: String.fromCharCode(109) = 'm' and String.fromCharCode(45)
1819 <span class='line'>1812</span>     = '-'.
1820 <span class='line'>1813</span>
1821 <span class='line'>1814</span>     Therefore, we need to map all the codes of several keys, like F1-F12,
1822 <span class='line'>1815</span>     Escape, Enter, Tab, etc. This map is held by pwlib.dom.keyCodes. It
1823 <span class='line'>1816</span>     associates, for example, code 112 to F1, or 13 to Enter. This map is used to
1824 <span class='line'>1817</span>     detect virtual keys in all events.
1825 <span class='line'>1818</span>
1826 <span class='line'>1819</span>     (This is only the general story, details about browser-specific differences
1827 <span class='line'>1820</span>     follow below.)
1828 <span class='line'>1821</span>
1829 <span class='line'>1822</span>     If the code given by the browser doesn't appear in keyCode maps, it's used
1830 <span class='line'>1823</span>     as is.  The key_ returned is that of String.fromCharCode(keyCode).
1831 <span class='line'>1824</span>
1832 <span class='line'>1825</span>     In all browsers we consider all events having keyCode &lt;= 32, as being events
1833 <span class='line'>1826</span>     generated by a virtual key (not a character). As such, the keyCode value is
1834 <span class='line'>1827</span>     always searched in pwlib.dom.keyCodes.
1835 <span class='line'>1828</span>
1836 <span class='line'>1829</span>     As you might notice from the above description, in the keypress event we
1837 <span class='line'>1830</span>     cannot tell the difference from say F1 and p, because both give the code
1838 <span class='line'>1831</span>     112. In Gecko and Webkit we can tell the difference because these UAs also
1839 <span class='line'>1832</span>     set the charCode event property when the key generates a character. If F1 is
1840 <span class='line'>1833</span>     pressed, or some other virtual key, charCode is never set.
1841 <span class='line'>1834</span>
1842 <span class='line'>1835</span>     In Opera the charCode property is never set. However, the 'which' event
1843 <span class='line'>1836</span>     property is not set for several virtual keys. This means we can tell the
1844 <span class='line'>1837</span>     difference between a character and a virtual key. However, there's a catch:
1845 <span class='line'>1838</span>     not *all* virtual keys have the 'which' property unset. Known exceptions:
1846 <span class='line'>1839</span>     Backspace (8), Tab (9), Enter (13), Shift (16), Control (17), Alt (18),
1847 <span class='line'>1840</span>     Pause (19), Escape (27), End (35), Home (36), Insert (45), Delete (46) and
1848 <span class='line'>1841</span>     NumLock (144). Given we already consider any keyCode &lt;= 32 being one of some
1849 <span class='line'>1842</span>     virtual key, fewer exceptions remain. We only have the End, Home, Insert,
1850 <span class='line'>1843</span>     Delete and the NumLock keys which cannot be 100% properly detected in the
1851 <span class='line'>1844</span>     keypress event, in Opera. To properly detect End/Home we can check if the
1852 <span class='line'>1845</span>     Shift modifier is active or not. If the user wants # instead of End, then
1853 <span class='line'>1846</span>     Shift must be active. The same goes for $ and Home. Thus we now only have
1854 <span class='line'>1847</span>     the '-' (Insert) and the '.' (Delete) characters incorrectly detected as
1855 <span class='line'>1848</span>     being Insert/Delete.
1856 <span class='line'>1849</span>
1857 <span class='line'>1850</span>     The above brings us to one of the main visible difference, when comparing
1858 <span class='line'>1851</span>     the pwlib.dom.KeyboardEventListener class and the simple
1859 <span class='line'>1852</span>     pwlib.dom.KeyboardEvent.getKey() function. In getKey(), for the keypress
1860 <span class='line'>1853</span>     event we cannot accurately determine the exact key, because it requires
1861 <span class='line'>1854</span>     checking the keyCode used for the keydown event. The KeyboardEventListener
1862 <span class='line'>1855</span>     class monitors all the keyboard events, ensuring a more accurate key
1863 <span class='line'>1856</span>     detection.
1864 <span class='line'>1857</span>
1865 <span class='line'>1858</span>     Different keyboard layouts and international characters are generally
1866 <span class='line'>1859</span>     supported. Tested and known to work with the Cyrillic alphabet (Greek
1867 <span class='line'>1860</span>     keyboard layout) and with the US Dvorak keyboard layouts.
1868 <span class='line'>1861</span>
1869 <span class='line'>1862</span>     Opera does not fire the keyup event for international characters when
1870 <span class='line'>1863</span>     running on Linux. For example, this happens with the Greek keyboard layout,
1871 <span class='line'>1864</span>     when trying Cyrillic characters.
1872 <span class='line'>1865</span>
1873 <span class='line'>1866</span>     Gecko gives no keyCode/charCode/which for international characters when
1874 <span class='line'>1867</span>     running on Linux, in the keyup/keydown events. Thus, all such keys remain
1875 <span class='line'>1868</span>     unidentified for these two events. For the keypress event there are no
1876 <span class='line'>1869</span>     issues with such characters.
1877 <span class='line'>1870</span>
1878 <span class='line'>1871</span>     Webkit and Konqueror 4 also implement the keyIdentifier property from the
1879 <span class='line'>1872</span>     DOM 3 Events specification. In theory, this should be great, but it's not
1880 <span class='line'>1873</span>     without problems.  Sometimes keyCode/charCode/which are all 0, but
1881 <span class='line'>1874</span>     keyIdentifier is properly set. For several virtual keys the keyIdentifier
1882 <span class='line'>1875</span>     value is simply 'U+0000'. Thus, the keyIdentifier is used only if the value
1883 <span class='line'>1876</span>     is not 'Unidentified' / 'U+0000', and only when keyCode/charCode/which are
1884 <span class='line'>1877</span>     not available.
1885 <span class='line'>1878</span>
1886 <span class='line'>1879</span>     Konqueror 4 does not use the 'U+XXXX' notation for Unicode characters. It
1887 <span class='line'>1880</span>     simply gives the character, directly.
1888 <span class='line'>1881</span>
1889 <span class='line'>1882</span>     Additionally, Konqueror seems to have some problems with several keyCodes in
1890 <span class='line'>1883</span>     keydown/keyup. For example, the key '[' gives keyCode 91 instead of 219.
1891 <span class='line'>1884</span>     Thus, it effectively gives the Unicode for the character, not the key code.
1892 <span class='line'>1885</span>     This issue is visible with other key as well.
1893 <span class='line'>1886</span>
1894 <span class='line'>1887</span>     NumPad_Clear is unidentified on Linux in all browsers, but it works on
1895 <span class='line'>1888</span>     Windows.
1896 <span class='line'>1889</span>
1897 <span class='line'>1890</span>     In MSIE the keypress event is only fired for characters and for Escape,
1898 <span class='line'>1891</span>     Space and Enter. Similarly, Webkit only fires the keypress event for
1899 <span class='line'>1892</span>     characters. However, Webkit does not fire keypress for Escape.
1900 <span class='line'>1893</span>
1901 <span class='line'>1894</span>     International characters and different keyboard layouts seem to work fine in
1902 <span class='line'>1895</span>     MSIE as well.
1903 <span class='line'>1896</span>
1904 <span class='line'>1897</span>     As of MSIE 4.0, the keypress event fires for the following keys:
1905 <span class='line'>1898</span>       * Letters: A - Z (uppercase and lowercase)
1906 <span class='line'>1899</span>       * Numerals: 0 - 9
1907 <span class='line'>1900</span>       * Symbols: ! @ # $ % ^ & * ( ) _ - + = &lt; [ ] { } , . / ? \ | ' ` " ~
1908 <span class='line'>1901</span>       * System: Escape (27), Space (32), Enter (13)
1909 <span class='line'>1902</span>
1910 <span class='line'>1903</span>     Documentation about the keypress event:
1911 <span class='line'>1904</span>     http://msdn.microsoft.com/en-us/library/ms536939(VS.85).aspx
1912 <span class='line'>1905</span>
1913 <span class='line'>1906</span>     As of MSIE 4.0, the keydown event fires for the following keys:
1914 <span class='line'>1907</span>       * Editing: Delete (46), Insert (45)
1915 <span class='line'>1908</span>       * Function: F1 - F12
1916 <span class='line'>1909</span>       * Letters: A - Z (uppercase and lowercase)
1917 <span class='line'>1910</span>       * Navigation: Home, End, Left, Right, Up, Down
1918 <span class='line'>1911</span>       * Numerals: 0 - 9
1919 <span class='line'>1912</span>       * Symbols: ! @ # $ % ^ & * ( ) _ - + = &lt; [ ] { } , . / ? \ | ' ` " ~
1920 <span class='line'>1913</span>       * System: Escape (27), Space (32), Shift (16), Tab (9)
1921 <span class='line'>1914</span>
1922 <span class='line'>1915</span>     As of MSIE 5, the event also fires for the following keys:
1923 <span class='line'>1916</span>       * Editing: Backspace (8)
1924 <span class='line'>1917</span>       * Navigation: PageUp (33), PageDown (34)
1925 <span class='line'>1918</span>       * System: Shift+Tab (9)
1926 <span class='line'>1919</span>
1927 <span class='line'>1920</span>     Documentation about the keydown event:
1928 <span class='line'>1921</span>     http://msdn.microsoft.com/en-us/library/ms536938(VS.85).aspx
1929 <span class='line'>1922</span>
1930 <span class='line'>1923</span>     As of MSIE 4.0, the keyup event fires for the following keys:
1931 <span class='line'>1924</span>       * Editing: Delete, Insert
1932 <span class='line'>1925</span>       * Function: F1 - F12
1933 <span class='line'>1926</span>       * Letters: A - Z (uppercase and lowercase)
1934 <span class='line'>1927</span>       * Navigation: Home (36), End (35), Left (37), Right (39), Up (38), Down (40)
1935 <span class='line'>1928</span>       * Numerals: 0 - 9
1936 <span class='line'>1929</span>       * Symbols: ! @ # $ % ^ & * ( ) _ - + = &lt; [ ] { } , . / ? \ | ' ` " ~
1937 <span class='line'>1930</span>       * System: Escape (27), Space (32), Shift (16), Tab (9)
1938 <span class='line'>1931</span>
1939 <span class='line'>1932</span>     As of MSIE 5, the event also fires for the following keys:
1940 <span class='line'>1933</span>       * Editing: Backspace (8)
1941 <span class='line'>1934</span>       * Navigation: PageUp (33), PageDown (34)
1942 <span class='line'>1935</span>       * System: Shift+Tab (9)
1943 <span class='line'>1936</span>
1944 <span class='line'>1937</span>     Documentation about the keyup event:
1945 <span class='line'>1938</span>     http://msdn.microsoft.com/en-us/library/ms536940(VS.85).aspx
1946 <span class='line'>1939</span>
1947 <span class='line'>1940</span>     For further gory details and a different implementation see:
1948 <span class='line'>1941</span>     http://code.google.com/p/doctype/source/browse/trunk/goog/events/keycodes.js
1949 <span class='line'>1942</span>     http://code.google.com/p/doctype/source/browse/trunk/goog/events/keyhandler.js
1950 <span class='line'>1943</span>
1951 <span class='line'>1944</span>     Opera keydown/keyup:
1952 <span class='line'>1945</span>       These events fire for all keys, including for modifiers.
1953 <span class='line'>1946</span>       keyCode is always set.
1954 <span class='line'>1947</span>       charCode is never set.
1955 <span class='line'>1948</span>       which is always set.
1956 <span class='line'>1949</span>       keyIdentifier is always undefined.
1957 <span class='line'>1950</span>
1958 <span class='line'>1951</span>     Opera keypress:
1959 <span class='line'>1952</span>       This event fires for all keys, except for modifiers themselves.
1960 <span class='line'>1953</span>       keyCode is always set.
1961 <span class='line'>1954</span>       charCode is never set.
1962 <span class='line'>1955</span>       which is set for all characters. which = 0 for several virtual keys.
1963 <span class='line'>1956</span>       which is known to be set for: Backspace (8), Tab (9), Enter (13), Shift
1964 <span class='line'>1957</span>       (16), Control (17), Alt (18), Pause (19), Escape (27), End (35), Home
1965 <span class='line'>1958</span>       (36), Insert (45), Delete (46), NumLock (144).
1966 <span class='line'>1959</span>       which is known to be unset for: F1 - F12, PageUp (33), PageDown (34), Left
1967 <span class='line'>1960</span>       (37), Up (38), Right (39), Down (40).
1968 <span class='line'>1961</span>       keyIdentifier is always undefined.
1969 <span class='line'>1962</span>
1970 <span class='line'>1963</span>     MSIE keyup/keypress/keydown:
1971 <span class='line'>1964</span>       Event firing conditions are described above.
1972 <span class='line'>1965</span>       keyCode is always set.
1973 <span class='line'>1966</span>       charCode is never set.
1974 <span class='line'>1967</span>       which is never set.
1975 <span class='line'>1968</span>       keyIdentifier is always undefined.
1976 <span class='line'>1969</span>
1977 <span class='line'>1970</span>     Webkit keydown/keyup:
1978 <span class='line'>1971</span>       These events fires for all keys, including for modifiers.
1979 <span class='line'>1972</span>       keyCode is always set.
1980 <span class='line'>1973</span>       charCode is never set.
1981 <span class='line'>1974</span>       which is always set.
1982 <span class='line'>1975</span>       keyIdentifier is always set.
1983 <span class='line'>1976</span>
1984 <span class='line'>1977</span>     Webkit keypress:
1985 <span class='line'>1978</span>       This event fires for characters keys, similarly to MSIE (see above info).
1986 <span class='line'>1979</span>       keyCode is always set.
1987 <span class='line'>1980</span>       charCode is always set for all characters.
1988 <span class='line'>1981</span>       which is always set.
1989 <span class='line'>1982</span>       keyIdentifier is null.
1990 <span class='line'>1983</span>
1991 <span class='line'>1984</span>     Gecko keydown/keyup:
1992 <span class='line'>1985</span>       These events fire for all keys, including for modifiers.
1993 <span class='line'>1986</span>       keyCode is always set.
1994 <span class='line'>1987</span>       charCode is never set.
1995 <span class='line'>1988</span>       which is always set.
1996 <span class='line'>1989</span>       keyIdentifier is always undefined.
1997 <span class='line'>1990</span>
1998 <span class='line'>1991</span>     Gecko keypress:
1999 <span class='line'>1992</span>       This event fires for all keys, except for modifiers themselves.
2000 <span class='line'>1993</span>       keyCode is only set for virtual keys, not for characters.
2001 <span class='line'>1994</span>       charCode is always set for all characters.
2002 <span class='line'>1995</span>       which is always set for all characters and for the Enter virtual key.
2003 <span class='line'>1996</span>       keyIdentifier is always undefined.
2004 <span class='line'>1997</span>
2005 <span class='line'>1998</span>     Another important difference between the KeyboardEventListener class and the
2006 <span class='line'>1999</span>     getKey() function is that the class tries to ensure that the keypress event
2007 <span class='line'>2000</span>     is fired for the handler, even if the Web browser does not do it natively.
2008 <span class='line'>2001</span>     Also, the class tries to provide a consistent approach to keyboard event
2009 <span class='line'>2002</span>     repetition when the user holds down a key for longer periods of time, by
2010 <span class='line'>2003</span>     repeating only the keypress event.
2011 <span class='line'>2004</span>
2012 <span class='line'>2005</span>     On Linux, Opera, Firefox and Konqueror do not repeat the keydown event, only
2013 <span class='line'>2006</span>     keypress. On Windows, Opera, Firefox and MSIE do repeat the keydown and
2014 <span class='line'>2007</span>     keypress events while the user holds down the key. Webkit  repeats the
2015 <span class='line'>2008</span>     keydown and the keypress (when it fires) events on both systems.
2016 <span class='line'>2009</span>
2017 <span class='line'>2010</span>     The default action can be prevented for during keydown in MSIE, and during
2018 <span class='line'>2011</span>     keypress for the other browsers. In Webkit when keypress doesn't fire,
2019 <span class='line'>2012</span>     keydown needs to be prevented.
2020 <span class='line'>2013</span>
2021 <span class='line'>2014</span>     The KeyboardEventListener class tries to bring consistency. The keydown
2022 <span class='line'>2015</span>     event never repeats, only the keypress event repeats and it always fires for
2023 <span class='line'>2016</span>     all keys. The keypress event never fires for modifiers. Events should always
2024 <span class='line'>2017</span>     be prevented during keypress - the class deals with preventing the event
2025 <span class='line'>2018</span>     during keydown or keypress as needed in Webkit and MSIE.
2026 <span class='line'>2019</span>
2027 <span class='line'>2020</span>     If no code/keyIdentifier is given by the browser, the getKey() function
2028 <span class='line'>2021</span>     returns null. In the case of the KeyboardEventListener class, keyCode_
2029 <span class='line'>2022</span>     / key_ / charCode_ / char_ will be null or undefined.
2030 <span class='line'>2023</span>    */</span><span class="WHIT">
2031 <span class='line'>2024</span>
2032 <span class='line'>2025</span> </span><span class="WHIT">  </span><span class="COMM">/**
2033 <span class='line'>2026</span>    * During a keyboard event flow, this holds the current key code, starting
2034 <span class='line'>2027</span>    * from the &lt;code>keydown&lt;/code> event.
2035 <span class='line'>2028</span>    *
2036 <span class='line'>2029</span>    * @private
2037 <span class='line'>2030</span>    * @type Number
2038 <span class='line'>2031</span>    */</span><span class="WHIT">
2039 <span class='line'>2032</span> </span><span class="WHIT">  </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2040 <span class='line'>2033</span>
2041 <span class='line'>2034</span> </span><span class="WHIT">  </span><span class="COMM">/**
2042 <span class='line'>2035</span>    * During a keyboard event flow, this holds the current key, starting from the
2043 <span class='line'>2036</span>    * &lt;code>keydown&lt;/code> event.
2044 <span class='line'>2037</span>    *
2045 <span class='line'>2038</span>    * @private
2046 <span class='line'>2039</span>    * @type String
2047 <span class='line'>2040</span>    */</span><span class="WHIT">
2048 <span class='line'>2041</span> </span><span class="WHIT">  </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2049 <span class='line'>2042</span>
2050 <span class='line'>2043</span> </span><span class="WHIT">  </span><span class="COMM">/**
2051 <span class='line'>2044</span>    * During a keyboard event flow, this holds the current character code,
2052 <span class='line'>2045</span>    * starting from the &lt;code>keypress&lt;/code> event.
2053 <span class='line'>2046</span>    *
2054 <span class='line'>2047</span>    * @private
2055 <span class='line'>2048</span>    * @type Number
2056 <span class='line'>2049</span>    */</span><span class="WHIT">
2057 <span class='line'>2050</span> </span><span class="WHIT">  </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">charCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2058 <span class='line'>2051</span>
2059 <span class='line'>2052</span> </span><span class="WHIT">  </span><span class="COMM">/**
2060 <span class='line'>2053</span>    * During a keyboard event flow, this holds the current character, starting
2061 <span class='line'>2054</span>    * from the &lt;code>keypress&lt;/code> event.
2062 <span class='line'>2055</span>    *
2063 <span class='line'>2056</span>    * @private
2064 <span class='line'>2057</span>    * @type String
2065 <span class='line'>2058</span>    */</span><span class="WHIT">
2066 <span class='line'>2059</span> </span><span class="WHIT">  </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">char_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2067 <span class='line'>2060</span>
2068 <span class='line'>2061</span> </span><span class="WHIT">  </span><span class="COMM">/**
2069 <span class='line'>2062</span>    * True if the current keyboard event is repeating. This happens when the user
2070 <span class='line'>2063</span>    * holds down a key for longer periods of time.
2071 <span class='line'>2064</span>    *
2072 <span class='line'>2065</span>    * @private
2073 <span class='line'>2066</span>    * @type Boolean
2074 <span class='line'>2067</span>    */</span><span class="WHIT">
2075 <span class='line'>2068</span> </span><span class="WHIT">  </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">repeat_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
2076 <span class='line'>2069</span>
2077 <span class='line'>2070</span>
2078 <span class='line'>2071</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">handlers_</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2079 <span class='line'>2072</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The first argument must be of type an object.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2080 <span class='line'>2073</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
2081 <span class='line'>2074</span>
2082 <span class='line'>2075</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">handlers_.keydown</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="PUNC">!</span><span class="NAME">handlers_.keypress</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="PUNC">!</span><span class="NAME">handlers_.keyup</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2083 <span class='line'>2076</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The provided handlers object has no keyboard event'</span><span class="WHIT"> </span><span class="PUNC">+</span><span class="WHIT">
2084 <span class='line'>2077</span> </span><span class="WHIT">        </span><span class="STRN">'handler.'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2085 <span class='line'>2078</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
2086 <span class='line'>2079</span>
2087 <span class='line'>2080</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">handlers_.keydown</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">handlers_.keydown</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'function'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2088 <span class='line'>2081</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The keydown event handler is not a function!'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2089 <span class='line'>2082</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
2090 <span class='line'>2083</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">handlers_.keypress</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">handlers_.keypress</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'function'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2091 <span class='line'>2084</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The keypress event handler is not a function!'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2092 <span class='line'>2085</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
2093 <span class='line'>2086</span> </span><span class="WHIT">  </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">handlers_.keyup</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="KEYW">typeof</span><span class="WHIT"> </span><span class="NAME">handlers_.keyup</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'function'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2094 <span class='line'>2087</span> </span><span class="WHIT">    </span><span class="KEYW">throw</span><span class="WHIT"> </span><span class="KEYW">new</span><span class="WHIT"> </span><span class="NAME">TypeError</span><span class="PUNC">(</span><span class="STRN">'The keyup event handler is not a function!'</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2095 <span class='line'>2088</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="WHIT">
2096 <span class='line'>2089</span>
2097 <span class='line'>2090</span> </span><span class="WHIT">  </span><span class="COMM">/**
2098 <span class='line'>2091</span>    * Attach the keyboard event listeners to the current DOM element.
2099 <span class='line'>2092</span>    */</span><span class="WHIT">
2100 <span class='line'>2093</span> </span><span class="WHIT">  </span><span class="NAME">this.attach</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2101 <span class='line'>2094</span> </span><span class="WHIT">    </span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2102 <span class='line'>2095</span> </span><span class="WHIT">    </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2103 <span class='line'>2096</span> </span><span class="WHIT">    </span><span class="NAME">charCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2104 <span class='line'>2097</span> </span><span class="WHIT">    </span><span class="NAME">char_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2105 <span class='line'>2098</span> </span><span class="WHIT">    </span><span class="NAME">repeat_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
2106 <span class='line'>2099</span>
2107 <span class='line'>2100</span> </span><span class="WHIT">    </span><span class="COMM">// FIXME: I have some ideas for a solution to the problem of having multiple </span><span class="WHIT">
2108 <span class='line'>2101</span> </span><span class="WHIT">    </span><span class="COMM">// event handlers like these attached to the same element. Somehow, only one </span><span class="WHIT">
2109 <span class='line'>2102</span> </span><span class="WHIT">    </span><span class="COMM">// should do all the needed work.</span><span class="WHIT">
2110 <span class='line'>2103</span>
2111 <span class='line'>2104</span> </span><span class="WHIT">    </span><span class="NAME">elem_.addEventListener</span><span class="PUNC">(</span><span class="STRN">'keydown'</span><span class="PUNC">,</span><span class="WHIT">  </span><span class="NAME">keydown</span><span class="PUNC">,</span><span class="WHIT">  </span><span class="KEYW">false</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2112 <span class='line'>2105</span> </span><span class="WHIT">    </span><span class="NAME">elem_.addEventListener</span><span class="PUNC">(</span><span class="STRN">'keypress'</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">keypress</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2113 <span class='line'>2106</span> </span><span class="WHIT">    </span><span class="NAME">elem_.addEventListener</span><span class="PUNC">(</span><span class="STRN">'keyup'</span><span class="PUNC">,</span><span class="WHIT">    </span><span class="NAME">keyup</span><span class="PUNC">,</span><span class="WHIT">    </span><span class="KEYW">false</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2114 <span class='line'>2107</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
2115 <span class='line'>2108</span>
2116 <span class='line'>2109</span> </span><span class="WHIT">  </span><span class="COMM">/**
2117 <span class='line'>2110</span>    * Detach the keyboard event listeners from the current DOM element.
2118 <span class='line'>2111</span>    */</span><span class="WHIT">
2119 <span class='line'>2112</span> </span><span class="WHIT">  </span><span class="NAME">this.detach</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2120 <span class='line'>2113</span> </span><span class="WHIT">    </span><span class="NAME">elem_.removeEventListener</span><span class="PUNC">(</span><span class="STRN">'keydown'</span><span class="PUNC">,</span><span class="WHIT">  </span><span class="NAME">keydown</span><span class="PUNC">,</span><span class="WHIT">  </span><span class="KEYW">false</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2121 <span class='line'>2114</span> </span><span class="WHIT">    </span><span class="NAME">elem_.removeEventListener</span><span class="PUNC">(</span><span class="STRN">'keypress'</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">keypress</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2122 <span class='line'>2115</span> </span><span class="WHIT">    </span><span class="NAME">elem_.removeEventListener</span><span class="PUNC">(</span><span class="STRN">'keyup'</span><span class="PUNC">,</span><span class="WHIT">    </span><span class="NAME">keyup</span><span class="PUNC">,</span><span class="WHIT">    </span><span class="KEYW">false</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2123 <span class='line'>2116</span>
2124 <span class='line'>2117</span> </span><span class="WHIT">    </span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2125 <span class='line'>2118</span> </span><span class="WHIT">    </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2126 <span class='line'>2119</span> </span><span class="WHIT">    </span><span class="NAME">charCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2127 <span class='line'>2120</span> </span><span class="WHIT">    </span><span class="NAME">char_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2128 <span class='line'>2121</span> </span><span class="WHIT">    </span><span class="NAME">repeat_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
2129 <span class='line'>2122</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
2130 <span class='line'>2123</span>
2131 <span class='line'>2124</span> </span><span class="WHIT">  </span><span class="COMM">/**
2132 <span class='line'>2125</span>    * Dispatch an event.
2133 <span class='line'>2126</span>    *
2134 <span class='line'>2127</span>    * &lt;p>This function simply invokes the handler for the event of the given
2135 <span class='line'>2128</span>    * &lt;var>type&lt;/var>. The handler receives the &lt;var>ev&lt;/var> event.
2136 <span class='line'>2129</span>    *
2137 <span class='line'>2130</span>    * @private
2138 <span class='line'>2131</span>    * @param {String} type The event type to dispatch.
2139 <span class='line'>2132</span>    * @param {Event} ev The DOM Event object to dispatch to the handler.
2140 <span class='line'>2133</span>    */</span><span class="WHIT">
2141 <span class='line'>2134</span> </span><span class="WHIT">  </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="NAME">dispatch</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">type</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">ev</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2142 <span class='line'>2135</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">handlers_</span><span class="PUNC">[</span><span class="NAME">type</span><span class="PUNC">]</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2143 <span class='line'>2136</span> </span><span class="WHIT">      </span><span class="KEYW">return</span><span class="PUNC">;</span><span class="WHIT">
2144 <span class='line'>2137</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2145 <span class='line'>2138</span>
2146 <span class='line'>2139</span> </span><span class="WHIT">    </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">handler</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">handlers_</span><span class="PUNC">[</span><span class="NAME">type</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
2147 <span class='line'>2140</span>
2148 <span class='line'>2141</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">type</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="NAME">ev.type</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2149 <span class='line'>2142</span> </span><span class="WHIT">      </span><span class="NAME">handler.call</span><span class="PUNC">(</span><span class="NAME">elem_</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">ev</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2150 <span class='line'>2143</span>
2151 <span class='line'>2144</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2152 <span class='line'>2145</span> </span><span class="WHIT">      </span><span class="COMM">// This happens when the keydown event tries to dispatch a keypress event.</span><span class="WHIT">
2153 <span class='line'>2146</span>
2154 <span class='line'>2147</span> </span><span class="WHIT">      </span><span class="COMM">// FIXME: I could use createEvent() ... food for thought for later</span><span class="WHIT">
2155 <span class='line'>2148</span> </span><span class="WHIT">      </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">ev_new</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
2156 <span class='line'>2149</span> </span><span class="WHIT">      </span><span class="NAME">pwlib.extend</span><span class="PUNC">(</span><span class="NAME">ev_new</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">ev</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2157 <span class='line'>2150</span> </span><span class="WHIT">      </span><span class="NAME">ev_new.type</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">type</span><span class="PUNC">;</span><span class="WHIT">
2158 <span class='line'>2151</span>
2159 <span class='line'>2152</span> </span><span class="WHIT">      </span><span class="COMM">// Make sure preventDefault() is not borked...</span><span class="WHIT">
2160 <span class='line'>2153</span> </span><span class="WHIT">      </span><span class="NAME">ev_new.preventDefault</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2161 <span class='line'>2154</span> </span><span class="WHIT">        </span><span class="NAME">ev.preventDefault</span><span class="PUNC">(</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2162 <span class='line'>2155</span> </span><span class="WHIT">      </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
2163 <span class='line'>2156</span>
2164 <span class='line'>2157</span> </span><span class="WHIT">      </span><span class="NAME">handler.call</span><span class="PUNC">(</span><span class="NAME">elem_</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">ev_new</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2165 <span class='line'>2158</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2166 <span class='line'>2159</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
2167 <span class='line'>2160</span>
2168 <span class='line'>2161</span> </span><span class="WHIT">  </span><span class="COMM">/**
2169 <span class='line'>2162</span>    * The &lt;code>keydown&lt;/code> event handler. This function determines the key
2170 <span class='line'>2163</span>    * pressed by the user, and checks if the &lt;code>keypress&lt;/code> event will
2171 <span class='line'>2164</span>    * fire in the current Web browser, or not. If it does not, a synthetic
2172 <span class='line'>2165</span>    * &lt;code>keypress&lt;/code> event will be fired.
2173 <span class='line'>2166</span>    *
2174 <span class='line'>2167</span>    * @private
2175 <span class='line'>2168</span>    * @param {Event} ev The DOM Event object.
2176 <span class='line'>2169</span>    */</span><span class="WHIT">
2177 <span class='line'>2170</span> </span><span class="WHIT">  </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="NAME">keydown</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ev</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2178 <span class='line'>2171</span> </span><span class="WHIT">    </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">prevKey</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="PUNC">;</span><span class="WHIT">
2179 <span class='line'>2172</span>
2180 <span class='line'>2173</span> </span><span class="WHIT">    </span><span class="NAME">charCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2181 <span class='line'>2174</span> </span><span class="WHIT">    </span><span class="NAME">char_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2182 <span class='line'>2175</span>
2183 <span class='line'>2176</span> </span><span class="WHIT">    </span><span class="NAME">findKeyCode</span><span class="PUNC">(</span><span class="NAME">ev</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2184 <span class='line'>2177</span>
2185 <span class='line'>2178</span> </span><span class="WHIT">    </span><span class="NAME">ev.keyCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">keyCode_</span><span class="PUNC">;</span><span class="WHIT">
2186 <span class='line'>2179</span> </span><span class="WHIT">    </span><span class="NAME">ev.key_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="PUNC">;</span><span class="WHIT">
2187 <span class='line'>2180</span> </span><span class="WHIT">    </span><span class="NAME">ev.repeat_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">prevKey</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">?</span><span class="WHIT"> </span><span class="KEYW">true</span><span class="WHIT"> </span><span class="PUNC">:</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
2188 <span class='line'>2181</span>
2189 <span class='line'>2182</span> </span><span class="WHIT">    </span><span class="NAME">repeat_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">ev.repeat_</span><span class="PUNC">;</span><span class="WHIT">
2190 <span class='line'>2183</span>
2191 <span class='line'>2184</span> </span><span class="WHIT">    </span><span class="COMM">// When the user holds down a key for a longer period of time, the keypress </span><span class="WHIT">
2192 <span class='line'>2185</span> </span><span class="WHIT">    </span><span class="COMM">// event is generally repeated. However, in Webkit keydown is repeated (and </span><span class="WHIT">
2193 <span class='line'>2186</span> </span><span class="WHIT">    </span><span class="COMM">// keypress if it fires keypress for the key). As such, we do not dispatch </span><span class="WHIT">
2194 <span class='line'>2187</span> </span><span class="WHIT">    </span><span class="COMM">// the keydown event when a key event starts to be repeated.</span><span class="WHIT">
2195 <span class='line'>2188</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">repeat_</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2196 <span class='line'>2189</span> </span><span class="WHIT">      </span><span class="NAME">dispatch</span><span class="PUNC">(</span><span class="STRN">'keydown'</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">ev</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2197 <span class='line'>2190</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2198 <span class='line'>2191</span>
2199 <span class='line'>2192</span> </span><span class="WHIT">    </span><span class="COMM">// MSIE and Webkit only fire the keypress event for characters </span><span class="WHIT">
2200 <span class='line'>2193</span> </span><span class="WHIT">    </span><span class="COMM">// (alpha-numeric and symbols).</span><span class="WHIT">
2201 <span class='line'>2194</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">isModifierKey</span><span class="PUNC">(</span><span class="NAME">key_</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="PUNC">!</span><span class="NAME">firesKeyPress</span><span class="PUNC">(</span><span class="NAME">ev</span><span class="PUNC">)</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2202 <span class='line'>2195</span> </span><span class="WHIT">      </span><span class="NAME">ev.type_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="STRN">'keydown'</span><span class="PUNC">;</span><span class="WHIT">
2203 <span class='line'>2196</span> </span><span class="WHIT">      </span><span class="NAME">keypress</span><span class="PUNC">(</span><span class="NAME">ev</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2204 <span class='line'>2197</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2205 <span class='line'>2198</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
2206 <span class='line'>2199</span>
2207 <span class='line'>2200</span> </span><span class="WHIT">  </span><span class="COMM">/**
2208 <span class='line'>2201</span>    * The &lt;code>keypress&lt;/code> event handler. This function determines the
2209 <span class='line'>2202</span>    * character generated by the keyboard event.
2210 <span class='line'>2203</span>    *
2211 <span class='line'>2204</span>    * @private
2212 <span class='line'>2205</span>    * @param {Event} ev The DOM Event object.
2213 <span class='line'>2206</span>    */</span><span class="WHIT">
2214 <span class='line'>2207</span> </span><span class="WHIT">  </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="NAME">keypress</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ev</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2215 <span class='line'>2208</span> </span><span class="WHIT">    </span><span class="COMM">// We reuse the keyCode_/key_ from the keydown event, because ev.keyCode </span><span class="WHIT">
2216 <span class='line'>2209</span> </span><span class="WHIT">    </span><span class="COMM">// generally holds the character code during the keypress event.</span><span class="WHIT">
2217 <span class='line'>2210</span> </span><span class="WHIT">    </span><span class="COMM">// However, if keyCode_ is not available, try to determine the key for this </span><span class="WHIT">
2218 <span class='line'>2211</span> </span><span class="WHIT">    </span><span class="COMM">// event as well.</span><span class="WHIT">
2219 <span class='line'>2212</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">keyCode_</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2220 <span class='line'>2213</span> </span><span class="WHIT">      </span><span class="NAME">findKeyCode</span><span class="PUNC">(</span><span class="NAME">ev</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2221 <span class='line'>2214</span> </span><span class="WHIT">      </span><span class="NAME">repeat_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
2222 <span class='line'>2215</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2223 <span class='line'>2216</span>
2224 <span class='line'>2217</span> </span><span class="WHIT">    </span><span class="NAME">ev.keyCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">keyCode_</span><span class="PUNC">;</span><span class="WHIT">
2225 <span class='line'>2218</span> </span><span class="WHIT">    </span><span class="NAME">ev.key_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="PUNC">;</span><span class="WHIT">
2226 <span class='line'>2219</span>
2227 <span class='line'>2220</span> </span><span class="WHIT">    </span><span class="NAME">findCharCode</span><span class="PUNC">(</span><span class="NAME">ev</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2228 <span class='line'>2221</span>
2229 <span class='line'>2222</span> </span><span class="WHIT">    </span><span class="NAME">ev.charCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">charCode_</span><span class="PUNC">;</span><span class="WHIT">
2230 <span class='line'>2223</span> </span><span class="WHIT">    </span><span class="NAME">ev.char_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">char_</span><span class="PUNC">;</span><span class="WHIT">
2231 <span class='line'>2224</span>
2232 <span class='line'>2225</span> </span><span class="WHIT">    </span><span class="COMM">// Any subsequent keypress event is considered a repeated keypress (the user </span><span class="WHIT">
2233 <span class='line'>2226</span> </span><span class="WHIT">    </span><span class="COMM">// is holding down the key).</span><span class="WHIT">
2234 <span class='line'>2227</span> </span><span class="WHIT">    </span><span class="NAME">ev.repeat_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">repeat_</span><span class="PUNC">;</span><span class="WHIT">
2235 <span class='line'>2228</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">repeat_</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2236 <span class='line'>2229</span> </span><span class="WHIT">      </span><span class="NAME">repeat_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">true</span><span class="PUNC">;</span><span class="WHIT">
2237 <span class='line'>2230</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2238 <span class='line'>2231</span>
2239 <span class='line'>2232</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">isModifierKey</span><span class="PUNC">(</span><span class="NAME">key_</span><span class="PUNC">)</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2240 <span class='line'>2233</span> </span><span class="WHIT">      </span><span class="NAME">dispatch</span><span class="PUNC">(</span><span class="STRN">'keypress'</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">ev</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2241 <span class='line'>2234</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2242 <span class='line'>2235</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
2243 <span class='line'>2236</span>
2244 <span class='line'>2237</span> </span><span class="WHIT">  </span><span class="COMM">/**
2245 <span class='line'>2238</span>    * The &lt;code>keyup&lt;/code> event handler.
2246 <span class='line'>2239</span>    *
2247 <span class='line'>2240</span>    * @private
2248 <span class='line'>2241</span>    * @param {Event} ev The DOM Event object.
2249 <span class='line'>2242</span>    */</span><span class="WHIT">
2250 <span class='line'>2243</span> </span><span class="WHIT">  </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="NAME">keyup</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ev</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2251 <span class='line'>2244</span> </span><span class="WHIT">    </span><span class="COMM">/*
2252 <span class='line'>2245</span>      * Try to determine the keyCode_ for keyup again, even if we might already
2253 <span class='line'>2246</span>      * have it from keydown. This is needed because the user might press some
2254 <span class='line'>2247</span>      * key which only generates the keydown and keypress events, after which
2255 <span class='line'>2248</span>      * a sudden keyup event is fired for a completely different key.
2256 <span class='line'>2249</span>      *
2257 <span class='line'>2250</span>      * Example: in Opera press F2 then Escape. It will first generate two
2258 <span class='line'>2251</span>      * events, keydown and keypress, for the F2 key. When you press Escape to
2259 <span class='line'>2252</span>      * close the dialog box, the script receives keyup for Escape.
2260 <span class='line'>2253</span>      */</span><span class="WHIT">
2261 <span class='line'>2254</span> </span><span class="WHIT">    </span><span class="NAME">findKeyCode</span><span class="PUNC">(</span><span class="NAME">ev</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2262 <span class='line'>2255</span>
2263 <span class='line'>2256</span> </span><span class="WHIT">    </span><span class="NAME">ev.keyCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">keyCode_</span><span class="PUNC">;</span><span class="WHIT">
2264 <span class='line'>2257</span> </span><span class="WHIT">    </span><span class="NAME">ev.key_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="PUNC">;</span><span class="WHIT">
2265 <span class='line'>2258</span>
2266 <span class='line'>2259</span> </span><span class="WHIT">    </span><span class="COMM">// Provide the character info from the keypress event in keyup as well.</span><span class="WHIT">
2267 <span class='line'>2260</span> </span><span class="WHIT">    </span><span class="NAME">ev.charCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">charCode_</span><span class="PUNC">;</span><span class="WHIT">
2268 <span class='line'>2261</span> </span><span class="WHIT">    </span><span class="NAME">ev.char_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">char_</span><span class="PUNC">;</span><span class="WHIT">
2269 <span class='line'>2262</span>
2270 <span class='line'>2263</span> </span><span class="WHIT">    </span><span class="NAME">dispatch</span><span class="PUNC">(</span><span class="STRN">'keyup'</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NAME">ev</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2271 <span class='line'>2264</span>
2272 <span class='line'>2265</span> </span><span class="WHIT">    </span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2273 <span class='line'>2266</span> </span><span class="WHIT">    </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2274 <span class='line'>2267</span> </span><span class="WHIT">    </span><span class="NAME">charCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2275 <span class='line'>2268</span> </span><span class="WHIT">    </span><span class="NAME">char_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2276 <span class='line'>2269</span> </span><span class="WHIT">    </span><span class="NAME">repeat_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
2277 <span class='line'>2270</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
2278 <span class='line'>2271</span>
2279 <span class='line'>2272</span> </span><span class="WHIT">  </span><span class="COMM">/**
2280 <span class='line'>2273</span>    * Tells if the &lt;var>key&lt;/var> is a modifier or not.
2281 <span class='line'>2274</span>    *
2282 <span class='line'>2275</span>    * @private
2283 <span class='line'>2276</span>    * @param {String} key The key name.
2284 <span class='line'>2277</span>    * @returns {Boolean} True if the &lt;var>key&lt;/var> is a modifier, or false if
2285 <span class='line'>2278</span>    * not.
2286 <span class='line'>2279</span>    */</span><span class="WHIT">
2287 <span class='line'>2280</span> </span><span class="WHIT">  </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="NAME">isModifierKey</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">key</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2288 <span class='line'>2281</span> </span><span class="WHIT">    </span><span class="KEYW">switch</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">key</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2289 <span class='line'>2282</span> </span><span class="WHIT">      </span><span class="KEYW">case</span><span class="WHIT"> </span><span class="STRN">'Shift'</span><span class="PUNC">:</span><span class="WHIT">
2290 <span class='line'>2283</span> </span><span class="WHIT">      </span><span class="KEYW">case</span><span class="WHIT"> </span><span class="STRN">'Control'</span><span class="PUNC">:</span><span class="WHIT">
2291 <span class='line'>2284</span> </span><span class="WHIT">      </span><span class="KEYW">case</span><span class="WHIT"> </span><span class="STRN">'Alt'</span><span class="PUNC">:</span><span class="WHIT">
2292 <span class='line'>2285</span> </span><span class="WHIT">      </span><span class="KEYW">case</span><span class="WHIT"> </span><span class="STRN">'Meta'</span><span class="PUNC">:</span><span class="WHIT">
2293 <span class='line'>2286</span> </span><span class="WHIT">      </span><span class="KEYW">case</span><span class="WHIT"> </span><span class="STRN">'Win'</span><span class="PUNC">:</span><span class="WHIT">
2294 <span class='line'>2287</span> </span><span class="WHIT">        </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">true</span><span class="PUNC">;</span><span class="WHIT">
2295 <span class='line'>2288</span> </span><span class="WHIT">      </span><span class="KEYW">default</span><span class="PUNC">:</span><span class="WHIT">
2296 <span class='line'>2289</span> </span><span class="WHIT">        </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
2297 <span class='line'>2290</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2298 <span class='line'>2291</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
2299 <span class='line'>2292</span>
2300 <span class='line'>2293</span> </span><span class="WHIT">  </span><span class="COMM">/**
2301 <span class='line'>2294</span>    * Tells if the current Web browser will fire the &lt;code>keypress&lt;/code> event
2302 <span class='line'>2295</span>    * for the current &lt;code>keydown&lt;/code> event object.
2303 <span class='line'>2296</span>    *
2304 <span class='line'>2297</span>    * @private
2305 <span class='line'>2298</span>    * @param {Event} ev The DOM Event object.
2306 <span class='line'>2299</span>    * @returns {Boolean} True if the Web browser will fire
2307 <span class='line'>2300</span>    * a &lt;code>keypress&lt;/code> event, or false if not.
2308 <span class='line'>2301</span>    */</span><span class="WHIT">
2309 <span class='line'>2302</span> </span><span class="WHIT">  </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="NAME">firesKeyPress</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ev</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2310 <span class='line'>2303</span> </span><span class="WHIT">    </span><span class="COMM">// Gecko does not fire keypress for the Up/Down arrows when the target is an </span><span class="WHIT">
2311 <span class='line'>2304</span> </span><span class="WHIT">    </span><span class="COMM">// input element.</span><span class="WHIT">
2312 <span class='line'>2305</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">(</span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'Up'</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'Down'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">pwlib.browser.gecko</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">ev.target</span><span class="WHIT">
2313 <span class='line'>2306</span>         </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">ev.target.tagName.toLowerCase</span><span class="PUNC">(</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'input'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2314 <span class='line'>2307</span> </span><span class="WHIT">      </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
2315 <span class='line'>2308</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2316 <span class='line'>2309</span>
2317 <span class='line'>2310</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">pwlib.browser.msie</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="PUNC">!</span><span class="NAME">pwlib.browser.webkit</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2318 <span class='line'>2311</span> </span><span class="WHIT">      </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">true</span><span class="PUNC">;</span><span class="WHIT">
2319 <span class='line'>2312</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2320 <span class='line'>2313</span>
2321 <span class='line'>2314</span> </span><span class="WHIT">    </span><span class="COMM">// Check if the key is a character key, or not.</span><span class="WHIT">
2322 <span class='line'>2315</span> </span><span class="WHIT">    </span><span class="COMM">// If it's not a character, then keypress will not fire.</span><span class="WHIT">
2323 <span class='line'>2316</span> </span><span class="WHIT">    </span><span class="COMM">// Known exceptions: keypress fires for Space, Enter and Escape in MSIE.</span><span class="WHIT">
2324 <span class='line'>2317</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'Space'</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'Enter'</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'Escape'</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT">
2325 <span class='line'>2318</span>         </span><span class="NAME">key_.length</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="NUMB">1</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2326 <span class='line'>2319</span> </span><span class="WHIT">      </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
2327 <span class='line'>2320</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2328 <span class='line'>2321</span>
2329 <span class='line'>2322</span> </span><span class="WHIT">    </span><span class="COMM">// Webkit doesn't fire keypress for Escape as well ...</span><span class="WHIT">
2330 <span class='line'>2323</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">pwlib.browser.webkit</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'Escape'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2331 <span class='line'>2324</span> </span><span class="WHIT">      </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
2332 <span class='line'>2325</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2333 <span class='line'>2326</span>
2334 <span class='line'>2327</span> </span><span class="WHIT">    </span><span class="COMM">// MSIE does not fire keypress if you hold Control / Alt down, while Shift </span><span class="WHIT">
2335 <span class='line'>2328</span> </span><span class="WHIT">    </span><span class="COMM">// is off. Albeit, based on testing I am not completely sure if Shift needs </span><span class="WHIT">
2336 <span class='line'>2329</span> </span><span class="WHIT">    </span><span class="COMM">// to be down or not. Sometimes MSIE won't fire keypress even if I hold </span><span class="WHIT">
2337 <span class='line'>2330</span> </span><span class="WHIT">    </span><span class="COMM">// Shift down, and sometimes it does. Eh.</span><span class="WHIT">
2338 <span class='line'>2331</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">pwlib.browser.msie</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="PUNC">!</span><span class="NAME">ev.shiftKey</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ev.ctrlKey</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">ev.altKey</span><span class="PUNC">)</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2339 <span class='line'>2332</span> </span><span class="WHIT">      </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
2340 <span class='line'>2333</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2341 <span class='line'>2334</span>
2342 <span class='line'>2335</span> </span><span class="WHIT">    </span><span class="KEYW">return</span><span class="WHIT"> </span><span class="KEYW">true</span><span class="PUNC">;</span><span class="WHIT">
2343 <span class='line'>2336</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
2344 <span class='line'>2337</span>
2345 <span class='line'>2338</span> </span><span class="WHIT">  </span><span class="COMM">/**
2346 <span class='line'>2339</span>    * Determine the key and the key code for the current DOM Event object. This
2347 <span class='line'>2340</span>    * function updates the &lt;var>keyCode_&lt;/var> and the &lt;var>key_&lt;/var> variables
2348 <span class='line'>2341</span>    * to hold the result.
2349 <span class='line'>2342</span>    *
2350 <span class='line'>2343</span>    * @private
2351 <span class='line'>2344</span>    * @param {Event} ev The DOM Event object.
2352 <span class='line'>2345</span>    */</span><span class="WHIT">
2353 <span class='line'>2346</span> </span><span class="WHIT">  </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="NAME">findKeyCode</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ev</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2354 <span class='line'>2347</span> </span><span class="WHIT">    </span><span class="COMM">/*
2355 <span class='line'>2348</span>      * If the event has no keyCode/which/keyIdentifier values, then simply do
2356 <span class='line'>2349</span>      * not overwrite any existing keyCode_/key_.
2357 <span class='line'>2350</span>      */</span><span class="WHIT">
2358 <span class='line'>2351</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ev.type</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'keyup'</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="PUNC">!</span><span class="NAME">ev.keyCode</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="PUNC">!</span><span class="NAME">ev.which</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">ev.keyIdentifier</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT">
2359 <span class='line'>2352</span>           </span><span class="NAME">ev.keyIdentifier</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'Unidentified'</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">ev.keyIdentifier</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'U+0000'</span><span class="PUNC">)</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2360 <span class='line'>2353</span> </span><span class="WHIT">      </span><span class="KEYW">return</span><span class="PUNC">;</span><span class="WHIT">
2361 <span class='line'>2354</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2362 <span class='line'>2355</span>
2363 <span class='line'>2356</span> </span><span class="WHIT">    </span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2364 <span class='line'>2357</span> </span><span class="WHIT">    </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2365 <span class='line'>2358</span>
2366 <span class='line'>2359</span> </span><span class="WHIT">    </span><span class="COMM">// Try to use keyCode/which.</span><span class="WHIT">
2367 <span class='line'>2360</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ev.keyCode</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">ev.which</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2368 <span class='line'>2361</span> </span><span class="WHIT">      </span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">ev.keyCode</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">ev.which</span><span class="PUNC">;</span><span class="WHIT">
2369 <span class='line'>2362</span>
2370 <span class='line'>2363</span> </span><span class="WHIT">      </span><span class="COMM">// Fix Webkit quirks</span><span class="WHIT">
2371 <span class='line'>2364</span> </span><span class="WHIT">      </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">pwlib.browser.webkit</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2372 <span class='line'>2365</span> </span><span class="WHIT">        </span><span class="COMM">// Old Webkit gives keyCode 25 when Shift+Tab is used.</span><span class="WHIT">
2373 <span class='line'>2366</span> </span><span class="WHIT">        </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="PUNC">==</span><span class="WHIT"> </span><span class="NUMB">25</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">this.shiftKey</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2374 <span class='line'>2367</span> </span><span class="WHIT">          </span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.Tab</span><span class="PUNC">;</span><span class="WHIT">
2375 <span class='line'>2368</span> </span><span class="WHIT">        </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="PUNC">>=</span><span class="WHIT"> </span><span class="NUMB">63232</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="KEYW">in</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyCodes_Safari2</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2376 <span class='line'>2369</span> </span><span class="WHIT">          </span><span class="COMM">// Old Webkit gives wrong values for several keys.</span><span class="WHIT">
2377 <span class='line'>2370</span> </span><span class="WHIT">          </span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyCodes_Safari2</span><span class="PUNC">[</span><span class="NAME">keyCode_</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
2378 <span class='line'>2371</span> </span><span class="WHIT">        </span><span class="PUNC">}</span><span class="WHIT">
2379 <span class='line'>2372</span> </span><span class="WHIT">      </span><span class="PUNC">}</span><span class="WHIT">
2380 <span class='line'>2373</span>
2381 <span class='line'>2374</span> </span><span class="WHIT">      </span><span class="COMM">// Fix keyCode quirks in all browsers.</span><span class="WHIT">
2382 <span class='line'>2375</span> </span><span class="WHIT">      </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="KEYW">in</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyCodes_fixes</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2383 <span class='line'>2376</span> </span><span class="WHIT">        </span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyCodes_fixes</span><span class="PUNC">[</span><span class="NAME">keyCode_</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
2384 <span class='line'>2377</span> </span><span class="WHIT">      </span><span class="PUNC">}</span><span class="WHIT">
2385 <span class='line'>2378</span>
2386 <span class='line'>2379</span> </span><span class="WHIT">      </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyCodes</span><span class="PUNC">[</span><span class="NAME">keyCode_</span><span class="PUNC">]</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">String.fromCharCode</span><span class="PUNC">(</span><span class="NAME">keyCode_</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2387 <span class='line'>2380</span>
2388 <span class='line'>2381</span> </span><span class="WHIT">      </span><span class="KEYW">return</span><span class="PUNC">;</span><span class="WHIT">
2389 <span class='line'>2382</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2390 <span class='line'>2383</span>
2391 <span class='line'>2384</span> </span><span class="WHIT">    </span><span class="COMM">// Try to use ev.keyIdentifier. This is only available in Webkit and </span><span class="WHIT">
2392 <span class='line'>2385</span> </span><span class="WHIT">    </span><span class="COMM">// Konqueror 4, each having some quirks. Sometimes the property is needed, </span><span class="WHIT">
2393 <span class='line'>2386</span> </span><span class="WHIT">    </span><span class="COMM">// because keyCode/which are not always available.</span><span class="WHIT">
2394 <span class='line'>2387</span>
2395 <span class='line'>2388</span> </span><span class="WHIT">    </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">key</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">,</span><span class="WHIT">
2396 <span class='line'>2389</span> </span><span class="WHIT">        </span><span class="NAME">keyCode</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">,</span><span class="WHIT">
2397 <span class='line'>2390</span> </span><span class="WHIT">        </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">ev.keyIdentifier</span><span class="PUNC">;</span><span class="WHIT">
2398 <span class='line'>2391</span>
2399 <span class='line'>2392</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'Unidentified'</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'U+0000'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2400 <span class='line'>2393</span> </span><span class="WHIT">      </span><span class="KEYW">return</span><span class="PUNC">;</span><span class="WHIT">
2401 <span class='line'>2394</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2402 <span class='line'>2395</span>
2403 <span class='line'>2396</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">id.substr</span><span class="PUNC">(</span><span class="NUMB">0</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NUMB">2</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'U+'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2404 <span class='line'>2397</span> </span><span class="WHIT">      </span><span class="COMM">// Webkit gives character codes using the 'U+XXXX' notation, as per spec.</span><span class="WHIT">
2405 <span class='line'>2398</span> </span><span class="WHIT">      </span><span class="NAME">keyCode</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">parseInt</span><span class="PUNC">(</span><span class="NAME">id.substr</span><span class="PUNC">(</span><span class="NUMB">2</span><span class="PUNC">)</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NUMB">16</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2406 <span class='line'>2399</span>
2407 <span class='line'>2400</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">id.length</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="NUMB">1</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2408 <span class='line'>2401</span> </span><span class="WHIT">      </span><span class="COMM">// Konqueror 4 implements keyIdentifier, and they provide the Unicode </span><span class="WHIT">
2409 <span class='line'>2402</span> </span><span class="WHIT">      </span><span class="COMM">// character directly, instead of using the 'U+XXXX' notation.</span><span class="WHIT">
2410 <span class='line'>2403</span> </span><span class="WHIT">      </span><span class="NAME">keyCode</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">id.charCodeAt</span><span class="PUNC">(</span><span class="NUMB">0</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2411 <span class='line'>2404</span> </span><span class="WHIT">      </span><span class="NAME">key</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">id</span><span class="PUNC">;</span><span class="WHIT">
2412 <span class='line'>2405</span>
2413 <span class='line'>2406</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2414 <span class='line'>2407</span> </span><span class="WHIT">      </span><span class="COMM">/*
2415 <span class='line'>2408</span>        * Common keyIdentifiers like 'PageDown' are used as they are.
2416 <span class='line'>2409</span>        * We determine the common keyCode used by Web browsers, from the
2417 <span class='line'>2410</span>        * pwlib.dom.keyNames object.
2418 <span class='line'>2411</span>        */</span><span class="WHIT">
2419 <span class='line'>2412</span> </span><span class="WHIT">      </span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames</span><span class="PUNC">[</span><span class="NAME">id</span><span class="PUNC">]</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2420 <span class='line'>2413</span> </span><span class="WHIT">      </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">id</span><span class="PUNC">;</span><span class="WHIT">
2421 <span class='line'>2414</span>
2422 <span class='line'>2415</span> </span><span class="WHIT">      </span><span class="KEYW">return</span><span class="PUNC">;</span><span class="WHIT">
2423 <span class='line'>2416</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2424 <span class='line'>2417</span>
2425 <span class='line'>2418</span> </span><span class="WHIT">    </span><span class="COMM">// Some keyIdentifiers like 'U+007F' (127: Delete) need to become key names.</span><span class="WHIT">
2426 <span class='line'>2419</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">keyCode</span><span class="WHIT"> </span><span class="KEYW">in</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyCodes</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">keyCode</span><span class="WHIT"> </span><span class="PUNC">&lt;=</span><span class="WHIT"> </span><span class="NUMB">32</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">keyCode</span><span class="WHIT"> </span><span class="PUNC">==</span><span class="WHIT"> </span><span class="NUMB">127</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT">
2427 <span class='line'>2420</span>           </span><span class="NAME">keyCode</span><span class="WHIT"> </span><span class="PUNC">==</span><span class="WHIT"> </span><span class="NUMB">144</span><span class="PUNC">)</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2428 <span class='line'>2421</span> </span><span class="WHIT">      </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyCodes</span><span class="PUNC">[</span><span class="NAME">keyCode</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
2429 <span class='line'>2422</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2430 <span class='line'>2423</span> </span><span class="WHIT">      </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">key</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2431 <span class='line'>2424</span> </span><span class="WHIT">        </span><span class="NAME">key</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">String.fromCharCode</span><span class="PUNC">(</span><span class="NAME">keyCode</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2432 <span class='line'>2425</span> </span><span class="WHIT">      </span><span class="PUNC">}</span><span class="WHIT">
2433 <span class='line'>2426</span>
2434 <span class='line'>2427</span> </span><span class="WHIT">      </span><span class="COMM">// Konqueror gives lower-case chars</span><span class="WHIT">
2435 <span class='line'>2428</span> </span><span class="WHIT">      </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">key.toUpperCase</span><span class="PUNC">(</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2436 <span class='line'>2429</span> </span><span class="WHIT">      </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">key</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2437 <span class='line'>2430</span> </span><span class="WHIT">        </span><span class="NAME">keyCode</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">key_.charCodeAt</span><span class="PUNC">(</span><span class="NUMB">0</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2438 <span class='line'>2431</span> </span><span class="WHIT">      </span><span class="PUNC">}</span><span class="WHIT">
2439 <span class='line'>2432</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2440 <span class='line'>2433</span>
2441 <span class='line'>2434</span> </span><span class="WHIT">    </span><span class="COMM">// Correct the keyCode, make sure it's a common keyCode, not the Unicode </span><span class="WHIT">
2442 <span class='line'>2435</span> </span><span class="WHIT">    </span><span class="COMM">// decimal representation of the character.</span><span class="WHIT">
2443 <span class='line'>2436</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'Delete'</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">key_.length</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="NUMB">1</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="KEYW">in</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2444 <span class='line'>2437</span> </span><span class="WHIT">      </span><span class="NAME">keyCode</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames</span><span class="PUNC">[</span><span class="NAME">key_</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
2445 <span class='line'>2438</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2446 <span class='line'>2439</span>
2447 <span class='line'>2440</span> </span><span class="WHIT">    </span><span class="NAME">keyCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">keyCode</span><span class="PUNC">;</span><span class="WHIT">
2448 <span class='line'>2441</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
2449 <span class='line'>2442</span>
2450 <span class='line'>2443</span> </span><span class="WHIT">  </span><span class="COMM">/**
2451 <span class='line'>2444</span>    * Determine the character and the character code for the current DOM Event
2452 <span class='line'>2445</span>    * object. This function updates the &lt;var>charCode_&lt;/var> and the
2453 <span class='line'>2446</span>    * &lt;var>char_&lt;/var> variables to hold the result.
2454 <span class='line'>2447</span>    *
2455 <span class='line'>2448</span>    * @private
2456 <span class='line'>2449</span>    * @param {Event} ev The DOM Event object.
2457 <span class='line'>2450</span>    */</span><span class="WHIT">
2458 <span class='line'>2451</span> </span><span class="WHIT">  </span><span class="KEYW">function</span><span class="WHIT"> </span><span class="NAME">findCharCode</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ev</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2459 <span class='line'>2452</span> </span><span class="WHIT">    </span><span class="NAME">charCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2460 <span class='line'>2453</span> </span><span class="WHIT">    </span><span class="NAME">char_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">;</span><span class="WHIT">
2461 <span class='line'>2454</span>
2462 <span class='line'>2455</span> </span><span class="WHIT">    </span><span class="COMM">// Webkit and Gecko implement ev.charCode.</span><span class="WHIT">
2463 <span class='line'>2456</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ev.charCode</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2464 <span class='line'>2457</span> </span><span class="WHIT">      </span><span class="NAME">charCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">ev.charCode</span><span class="PUNC">;</span><span class="WHIT">
2465 <span class='line'>2458</span> </span><span class="WHIT">      </span><span class="NAME">char_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">String.fromCharCode</span><span class="PUNC">(</span><span class="NAME">ev.charCode</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2466 <span class='line'>2459</span>
2467 <span class='line'>2460</span> </span><span class="WHIT">      </span><span class="KEYW">return</span><span class="PUNC">;</span><span class="WHIT">
2468 <span class='line'>2461</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2469 <span class='line'>2462</span>
2470 <span class='line'>2463</span> </span><span class="WHIT">    </span><span class="COMM">// Try the keyCode mess.</span><span class="WHIT">
2471 <span class='line'>2464</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ev.keyCode</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">ev.which</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2472 <span class='line'>2465</span> </span><span class="WHIT">      </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">keyCode</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">ev.keyCode</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">ev.which</span><span class="PUNC">;</span><span class="WHIT">
2473 <span class='line'>2466</span>
2474 <span class='line'>2467</span> </span><span class="WHIT">      </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">force</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">false</span><span class="PUNC">;</span><span class="WHIT">
2475 <span class='line'>2468</span>
2476 <span class='line'>2469</span> </span><span class="WHIT">      </span><span class="COMM">// We accept some keyCodes.</span><span class="WHIT">
2477 <span class='line'>2470</span> </span><span class="WHIT">      </span><span class="KEYW">switch</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">keyCode</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2478 <span class='line'>2471</span> </span><span class="WHIT">        </span><span class="KEYW">case</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.Tab</span><span class="PUNC">:</span><span class="WHIT">
2479 <span class='line'>2472</span> </span><span class="WHIT">        </span><span class="KEYW">case</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.Enter</span><span class="PUNC">:</span><span class="WHIT">
2480 <span class='line'>2473</span> </span><span class="WHIT">        </span><span class="KEYW">case</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.Space</span><span class="PUNC">:</span><span class="WHIT">
2481 <span class='line'>2474</span> </span><span class="WHIT">          </span><span class="NAME">force</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">true</span><span class="PUNC">;</span><span class="WHIT">
2482 <span class='line'>2475</span> </span><span class="WHIT">      </span><span class="PUNC">}</span><span class="WHIT">
2483 <span class='line'>2476</span>
2484 <span class='line'>2477</span> </span><span class="WHIT">      </span><span class="COMM">// Do not consider the keyCode a character code, if during the keydown </span><span class="WHIT">
2485 <span class='line'>2478</span> </span><span class="WHIT">      </span><span class="COMM">// event it was determined the key does not generate a character, unless </span><span class="WHIT">
2486 <span class='line'>2479</span> </span><span class="WHIT">      </span><span class="COMM">// it's Tab, Enter or Space.</span><span class="WHIT">
2487 <span class='line'>2480</span> </span><span class="WHIT">      </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="PUNC">!</span><span class="NAME">force</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">key_.length</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="NUMB">1</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2488 <span class='line'>2481</span> </span><span class="WHIT">        </span><span class="KEYW">return</span><span class="PUNC">;</span><span class="WHIT">
2489 <span class='line'>2482</span> </span><span class="WHIT">      </span><span class="PUNC">}</span><span class="WHIT">
2490 <span class='line'>2483</span>
2491 <span class='line'>2484</span> </span><span class="WHIT">      </span><span class="COMM">// If the keypress event at hand is synthetically dispatched by keydown, </span><span class="WHIT">
2492 <span class='line'>2485</span> </span><span class="WHIT">      </span><span class="COMM">// then special treatment is needed. This happens only in Webkit and MSIE.</span><span class="WHIT">
2493 <span class='line'>2486</span> </span><span class="WHIT">      </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">ev.type_</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'keydown'</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2494 <span class='line'>2487</span> </span><span class="WHIT">        </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">key</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyCodes</span><span class="PUNC">[</span><span class="NAME">keyCode</span><span class="PUNC">]</span><span class="PUNC">;</span><span class="WHIT">
2495 <span class='line'>2488</span> </span><span class="WHIT">        </span><span class="COMM">// Check if the keyCode points to a single character.</span><span class="WHIT">
2496 <span class='line'>2489</span> </span><span class="WHIT">        </span><span class="COMM">// If it does, use it.</span><span class="WHIT">
2497 <span class='line'>2490</span> </span><span class="WHIT">        </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">key</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">key.length</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="NUMB">1</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2498 <span class='line'>2491</span> </span><span class="WHIT">          </span><span class="NAME">charCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">key.charCodeAt</span><span class="PUNC">(</span><span class="NUMB">0</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT"> </span><span class="COMM">// keyCodes != charCodes</span><span class="WHIT">
2499 <span class='line'>2492</span> </span><span class="WHIT">          </span><span class="NAME">char_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">key</span><span class="PUNC">;</span><span class="WHIT">
2500 <span class='line'>2493</span> </span><span class="WHIT">        </span><span class="PUNC">}</span><span class="WHIT">
2501 <span class='line'>2494</span> </span><span class="WHIT">      </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">keyCode</span><span class="WHIT"> </span><span class="PUNC">>=</span><span class="WHIT"> </span><span class="NUMB">32</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">force</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2502 <span class='line'>2495</span> </span><span class="WHIT">        </span><span class="COMM">// For normal keypress events, we are done.</span><span class="WHIT">
2503 <span class='line'>2496</span> </span><span class="WHIT">        </span><span class="NAME">charCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">keyCode</span><span class="PUNC">;</span><span class="WHIT">
2504 <span class='line'>2497</span> </span><span class="WHIT">        </span><span class="NAME">char_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">String.fromCharCode</span><span class="PUNC">(</span><span class="NAME">keyCode</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2505 <span class='line'>2498</span> </span><span class="WHIT">      </span><span class="PUNC">}</span><span class="WHIT">
2506 <span class='line'>2499</span>
2507 <span class='line'>2500</span> </span><span class="WHIT">      </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">charCode_</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2508 <span class='line'>2501</span> </span><span class="WHIT">        </span><span class="KEYW">return</span><span class="PUNC">;</span><span class="WHIT">
2509 <span class='line'>2502</span> </span><span class="WHIT">      </span><span class="PUNC">}</span><span class="WHIT">
2510 <span class='line'>2503</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2511 <span class='line'>2504</span>
2512 <span class='line'>2505</span> </span><span class="WHIT">    </span><span class="COMM">/*
2513 <span class='line'>2506</span>      * Webkit and Konqueror do not provide a keyIdentifier in the keypress
2514 <span class='line'>2507</span>      * event, as per spec. However, in the unlikely case when the keyCode is
2515 <span class='line'>2508</span>      * missing, and the keyIdentifier is available, we use it.
2516 <span class='line'>2509</span>      *
2517 <span class='line'>2510</span>      * This property might be used when a synthetic keypress event is generated
2518 <span class='line'>2511</span>      * by the keydown event, and keyCode/charCode/which are all not available.
2519 <span class='line'>2512</span>      */</span><span class="WHIT">
2520 <span class='line'>2513</span>
2521 <span class='line'>2514</span> </span><span class="WHIT">    </span><span class="KEYW">var</span><span class="WHIT"> </span><span class="NAME">c</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">,</span><span class="WHIT">
2522 <span class='line'>2515</span> </span><span class="WHIT">        </span><span class="NAME">charCode</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="KEYW">null</span><span class="PUNC">,</span><span class="WHIT">
2523 <span class='line'>2516</span> </span><span class="WHIT">        </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">ev.keyIdentifier</span><span class="PUNC">;</span><span class="WHIT">
2524 <span class='line'>2517</span>
2525 <span class='line'>2518</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'Unidentified'</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">id</span><span class="WHIT"> </span><span class="PUNC">!==</span><span class="WHIT"> </span><span class="STRN">'U+0000'</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT">
2526 <span class='line'>2519</span> </span><span class="WHIT">        </span><span class="PUNC">(</span><span class="NAME">id.substr</span><span class="PUNC">(</span><span class="NUMB">0</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NUMB">2</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="STRN">'U+'</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">id.length</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="NUMB">1</span><span class="PUNC">)</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2527 <span class='line'>2520</span>
2528 <span class='line'>2521</span> </span><span class="WHIT">      </span><span class="COMM">// Characters in Konqueror...</span><span class="WHIT">
2529 <span class='line'>2522</span> </span><span class="WHIT">      </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">id.length</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="NUMB">1</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2530 <span class='line'>2523</span> </span><span class="WHIT">        </span><span class="NAME">charCode</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">id.charCodeAt</span><span class="PUNC">(</span><span class="NUMB">0</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2531 <span class='line'>2524</span> </span><span class="WHIT">        </span><span class="NAME">c</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">id</span><span class="PUNC">;</span><span class="WHIT">
2532 <span class='line'>2525</span>
2533 <span class='line'>2526</span> </span><span class="WHIT">      </span><span class="PUNC">}</span><span class="WHIT"> </span><span class="KEYW">else</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2534 <span class='line'>2527</span> </span><span class="WHIT">        </span><span class="COMM">// Webkit uses the 'U+XXXX' notation as per spec.</span><span class="WHIT">
2535 <span class='line'>2528</span> </span><span class="WHIT">        </span><span class="NAME">charCode</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">parseInt</span><span class="PUNC">(</span><span class="NAME">id.substr</span><span class="PUNC">(</span><span class="NUMB">2</span><span class="PUNC">)</span><span class="PUNC">,</span><span class="WHIT"> </span><span class="NUMB">16</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2536 <span class='line'>2529</span> </span><span class="WHIT">      </span><span class="PUNC">}</span><span class="WHIT">
2537 <span class='line'>2530</span>
2538 <span class='line'>2531</span> </span><span class="WHIT">      </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">charCode</span><span class="WHIT"> </span><span class="PUNC">==</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.Tab</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT">
2539 <span class='line'>2532</span> </span><span class="WHIT">          </span><span class="NAME">charCode</span><span class="WHIT"> </span><span class="PUNC">==</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.Enter</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT">
2540 <span class='line'>2533</span> </span><span class="WHIT">          </span><span class="NAME">charCode</span><span class="WHIT"> </span><span class="PUNC">>=</span><span class="WHIT"> </span><span class="NUMB">32</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">charCode</span><span class="WHIT"> </span><span class="PUNC">!=</span><span class="WHIT"> </span><span class="NUMB">127</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT">
2541 <span class='line'>2534</span> </span><span class="WHIT">          </span><span class="NAME">charCode</span><span class="WHIT"> </span><span class="PUNC">!=</span><span class="WHIT"> </span><span class="NAME">pwlib.dom.keyNames.NumLock</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2542 <span class='line'>2535</span>
2543 <span class='line'>2536</span> </span><span class="WHIT">        </span><span class="NAME">charCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">charCode</span><span class="PUNC">;</span><span class="WHIT">
2544 <span class='line'>2537</span> </span><span class="WHIT">        </span><span class="NAME">char_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">c</span><span class="WHIT"> </span><span class="PUNC">||</span><span class="WHIT"> </span><span class="NAME">String.fromCharCode</span><span class="PUNC">(</span><span class="NAME">charCode</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2545 <span class='line'>2538</span>
2546 <span class='line'>2539</span> </span><span class="WHIT">        </span><span class="KEYW">return</span><span class="PUNC">;</span><span class="WHIT">
2547 <span class='line'>2540</span> </span><span class="WHIT">      </span><span class="PUNC">}</span><span class="WHIT">
2548 <span class='line'>2541</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2549 <span class='line'>2542</span>
2550 <span class='line'>2543</span> </span><span class="WHIT">    </span><span class="COMM">// Try to use the key determined from the previous keydown event, if it </span><span class="WHIT">
2551 <span class='line'>2544</span> </span><span class="WHIT">    </span><span class="COMM">// holds a character.</span><span class="WHIT">
2552 <span class='line'>2545</span> </span><span class="WHIT">    </span><span class="KEYW">if</span><span class="WHIT"> </span><span class="PUNC">(</span><span class="NAME">key_</span><span class="WHIT"> </span><span class="PUNC">&&</span><span class="WHIT"> </span><span class="NAME">key_.length</span><span class="WHIT"> </span><span class="PUNC">===</span><span class="WHIT"> </span><span class="NUMB">1</span><span class="PUNC">)</span><span class="WHIT"> </span><span class="PUNC">{</span><span class="WHIT">
2553 <span class='line'>2546</span> </span><span class="WHIT">      </span><span class="NAME">charCode_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">key_.charCodeAt</span><span class="PUNC">(</span><span class="NUMB">0</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2554 <span class='line'>2547</span> </span><span class="WHIT">      </span><span class="NAME">char_</span><span class="WHIT"> </span><span class="PUNC">=</span><span class="WHIT"> </span><span class="NAME">key_</span><span class="PUNC">;</span><span class="WHIT">
2555 <span class='line'>2548</span> </span><span class="WHIT">    </span><span class="PUNC">}</span><span class="WHIT">
2556 <span class='line'>2549</span> </span><span class="WHIT">  </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
2557 <span class='line'>2550</span>
2558 <span class='line'>2551</span> </span><span class="WHIT">  </span><span class="NAME">this.attach</span><span class="PUNC">(</span><span class="PUNC">)</span><span class="PUNC">;</span><span class="WHIT">
2559 <span class='line'>2552</span> </span><span class="PUNC">}</span><span class="PUNC">;</span><span class="WHIT">
2560 <span class='line'>2553</span>
2561 <span class='line'>2554</span> </span><span class="COMM">// Check out the libmacrame project: http://code.google.com/p/libmacrame.</span><span class="WHIT">
2562 <span class='line'>2555</span>
2563 <span class='line'>2556</span> </span><span class="COMM">// vim:set spell spl=en fo=wan1croqlt tw=80 ts=2 sw=2 sts=2 sta et ai cin fenc=utf-8 ff=unix:</span><span class="WHIT">
2564 <span class='line'>2557</span>
2565 <span class='line'>2558</span> </span></pre></body></html>