diff -r c9394af976fe -r 914d053d42b1 org.symbian.tools.wrttools/libraries/core/widget.js --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/org.symbian.tools.wrttools/libraries/core/widget.js Wed Mar 03 09:56:03 2010 -0800 @@ -0,0 +1,178 @@ +/** + * Copyright (c) 2009-2010 Symbian Foundation and/or its subsidiary(-ies). + * All rights reserved. + * This component and the accompanying materials are made available + * under the terms of the License "Eclipse Public License v1.0" + * which accompanies this distribution, and is available + * at the URL "http://www.eclipse.org/legal/epl-v10.html". + * + * Initial Contributors: + * Symbian Foundation - initial contribution. + * Contributors: + */ + +/** + * Property widget + * @type Widget + * @memberOf Window + */ +Window.prototype.widget = new Widget(); + +/** + * Property device + * @type Device + * @memberOf Window + */ +Window.prototype.device = new Device(); + +/** + * Property menu + * @type Menu + * @memberOf Window + */ +Window.prototype.menu = new Menu(); + +function Widget() {}; +Widget.prototype = new Object(); +Widget.prototype.widget = new Widget(); + +/** + * identifier is a read-only property of the widget object. + * It is the unique string identifier that identifies a widget + * after it has been installed into a device. The string returned + * is the value of the Identifier key defined in the widget + * property list file (info.plist). + */ +Widget.prototype.identifier = ""; + +/** + * isrotationsupported is a read-only property that returns a + * Boolean value determining if the device supports landscape and + * portrait screen orientations. If the value is true, the + * device supports both landscape and portrait screen orientations. + */ +Widget.prototype.isrotationsupported = new Boolean(); + +/** + * Allows the definition of a function to be called + * when a Widget.is displayed + * @param {Void} + * onshow() + * @return {Void} + */ +Widget.prototype.onshow = new Object(); + +/** + * Allows the definition of a function to be called + * when a Widget.sent into the background (hidden) + * @param {Void} + * onhide() + * @return {Void} + */ +Widget.prototype.onhide = new Object(); + +/** + * Launches the browser with the specified url + * @param {String} url + * openURL() + * @return {Void} + */ +Widget.prototype.openURL = function(url){}; + +/** + * Returns previously stored preference associated with the specified key + * @param {String} Key preference value to be fetch + * preferenceForKey() + * @return {String} Value + */ +Widget.prototype.preferenceForKey = function(key) {return "";}; + + +/** + * Stores the key associated with the specified preference + * @param {String} Preference value to be stored + * @param {String} Key Preference value associated to + * setPreferenceForKey() + * @return {Void} + */ +Widget.prototype.setPreferenceForKey = function(preference, key){}; + +/** + * Toggle between Tabbed navigation mode or Cursor mode + * @param {Boolean} Value + * setNavigationEnabled() + * @return {Void} + */ +Widget.prototype.setNavigationEnabled = function(navigationMode) {}; + +/** + * Toggle between Tabbed navigation mode or Cursor mode + * @param {Boolean} Value + * setNavigationType() + * @return {Void} + */ +Widget.prototype.setNavigationType = function(navigationMode) {}; + +/** + * Open S0-Application identified by UID along with the specified params + * @param {Integer} Uid hexadecimal value to a specified application + * @param {String} Value + * openApplication() + * @return {Void} + */ +Widget.prototype.openApplication = function(Uid, param) {}; + +/** + * Prepares the Widget.to do transition to specified transitionState + * @param {String} Value Transition state + * prepareForTransition() + * @return {Void} + */ +Widget.prototype.prepareForTransition = function(transitionMode){}; + +/** + * Does the animation to make the transition between the specified transitionState + * @param {Void} + * performTransition() + * @return {Void} + */ +Widget.prototype.performTransition = function(){}; + +/** + * Set the preferred screen orientation to landscape. + * The display will flip if the phone display orientation + * is portrait and the phone supports landscape mode. + * @param {Void} + * setDisplayLandscape() + * @return {Void} + */ +Widget.prototype.setDisplayLandscape = function(){}; + +/** + * Set the preferred screen orientation to portrait. + * The display will flip if the phone display orientation + * is landscape and the phone supports portrait mode. + * @param {Void} + * setDisplayPortrait() + * @return {Void} + */ +Widget.prototype.setDisplayPortrait = function(){}; + +/** + * device object. entry point to device service API (SAPI) + */ +function Device() {} +Device.prototype = new Object(); +Device.prototype.device = new Device(); + +/** + * device API public method + * + * @method + * @param {string} provider Name of service provider, eg, "Service.Calendar" + * @param {string} Interface Name of interface, eg, "IDataSource" + * @return {Object} service object + */ +Device.prototype.getServiceObject = function(provider, Interface) { + return new Object(); +}; \ No newline at end of file