/**
 * @author Mark Cassar - CasaSoft
 * @version 1.0.0 
 * @lastmodified 05/08/07
 */

if (!com) var com = new Object();
if (!com.CS) com.CS = new Object();
if (!com.CS.General) com.CS.General = new Object();
if (!com.CS.General.Key) com.CS.General.Key = new Object();

//REQUIREMENTS
if (!Class) throw new Error("com.CS.General.Key: Please include Class com.CS.defineClass");
//------------


com.CS.General.Key = Class({
	name: "Key",
	statics: {
		/**
		 * Begins to capture the keyboard. 
		 * @param {Object} functionHandler The function to call with one parameter 'keyCode'
		 * @param {Object} scope (Optional) Where to handle the onkeydown event.   Defaults to 'document';
		 */
		captureKey : function(functionHandler, scope) {
			
			if (!scope) {
				scope = document;
			}
			scope.onkeydown = function(e) {
				var keyCode;
				if (e) {
					keyCode = e.keyCode;
				}
				else if (event) {
					keyCode = event.keyCode;
				}
				
				functionHandler(keyCode);
			}
		}
	}
});