Difference between revisions of "Application"
From GiderosMobile
(----) |
|||
| (25 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
| − | |||
<!-- GIDEROSOBJ:Application --> | <!-- GIDEROSOBJ:Application --> | ||
| − | + | '''Supported platforms:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]][[File:Platform html5.png]][[File:Platform winrt.png]][[File:Platform win32.png]][[File:Platform linux.png]]<br/> | |
| − | '''Supported platforms:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]][[File:Platform html5.png]][[File:Platform winrt.png]][[File:Platform win32.png]]<br/> | ||
'''Available since:''' Gideros 2011.6<br/> | '''Available since:''' Gideros 2011.6<br/> | ||
| − | '''Inherits from:''' [[Object]]<br/> | + | '''Inherits from:''' [[Object|Object]]<br/> |
=== Description === | === Description === | ||
| − | + | The Application class contains the common functions that are available to the current application. | |
| − | + | ||
| − | + | There is a global variable '''''application''''' of type Application to access these functions. | |
{|- | {|- | ||
| style="width: 50%; vertical-align:top;"| | | style="width: 50%; vertical-align:top;"| | ||
| − | |||
=== Methods === | === Methods === | ||
| − | [[Application:canOpenUrl]] '' | + | [[Application:applyStyles]] ''applies pending style changes immediately''<br/><!--GIDEROSMTD:Application:applyStyles() applies pending style changes immediately--> |
| − | [[Application:configureFrustum]] '' | + | [[Application:canOpenUrl]] ''tests if it is possible to open provided url''<br/><!--GIDEROSMTD:Application:canOpenUrl(url) tests if it is possible to open provided url--> |
| − | [[Application:exit]] ''terminates the application''<br/> | + | [[Application:checkPermission]] ''checks android permission''<br/><!--GIDEROSMTD:Application:checkPermission(permission) checks android permission--> |
| − | [[Application:get]] ''returns state of desktop setting''<br/> | + | [[Application:configureFrustum]] ''configures the projection for 3D perspective''<br/><!--GIDEROSMTD:Application:configureFrustum(fov,farplane) configures the projection for 3D perspective--> |
| − | [[Application:getApiVersion]] ''returns the API version''<br/> | + | [[Application:enableDrawInfo]] ''shows or hides Gideros info layer''<br/><!--GIDEROSMTD:Application:enableDrawInfo(color) shows or hides Gideros info layer--> |
| − | [[Application:getAppId]] ''returns the app id or bundle id''<br/> | + | [[Application:enableOnDemandDraw]] ''enable or disable on-demand rendering''<br/><!--GIDEROSMTD:Application:enableOnDemandDraw(enable) enable or disable on-demand rendering--> |
| − | [[Application:getBackgroundColor]] ''returns the background color in hexadecimal format''<br/> | + | [[Application:exit]] ''terminates the application''<br/><!--GIDEROSMTD:Application:exit() terminates the application--> |
| − | [[Application:getContentHeight]] ''returns content height''<br/> | + | [[Application:get]] ''returns state of desktop setting''<br/><!--GIDEROSMTD:Application:get(setting) returns state of desktop setting--> |
| − | [[Application:getContentWidth]] ''returns content width''<br/> | + | [[Application:getApiVersion]] ''returns the API version''<br/><!--GIDEROSMTD:Application:getApiVersion() returns the API version--> |
| − | [[Application:getDeviceHeight]] ''returns the physical height of the device | + | [[Application:getAppId]] ''returns the app id or bundle id''<br/><!--GIDEROSMTD:Application:getAppId() returns the app id or bundle id--> |
| − | [[Application:getDeviceWidth]] ''returns the physical width of the device | + | [[Application:getBackgroundColor]] ''returns the background color''<br/><!--GIDEROSMTD:Application:getBackgroundColor() returns the background color in hexadecimal format--> |
| − | [[Application:getDeviceInfo]] ''returns information about device''<br/> | + | [[Application:getClipboard]] ''returns content of the clipboard''<br/><!--GIDEROSMTD:Application:getClipboard() returns content of the clipboard--> |
| − | [[Application:getDeviceOrientation]] '' | + | [[Application:getContentHeight]] ''returns content height''<br/><!--GIDEROSMTD:Application:getContentHeight() returns content height--> |
| − | [[Application:getDeviceSafeArea]] ''returns the safe display area bounds''<br/> | + | [[Application:getContentWidth]] ''returns content width''<br/><!--GIDEROSMTD:Application:getContentWidth() returns content width--> |
| − | [[Application:getFps]] ''returns the frame rate of the application''<br/> | + | [[Application:getDeviceHeight]] ''returns the physical height of the device''<br/><!--GIDEROSMTD:Application:getDeviceHeight() returns the physical height of the device in pixels--> |
| − | [[Application:getKeyboardModifiers]] ''returns the current keyboard modifiers''<br/> | + | [[Application:getDeviceWidth]] ''returns the physical width of the device''<br/><!--GIDEROSMTD:Application:getDeviceWidth() returns the physical width of the device in pixels--> |
| − | [[Application:getLanguage]] ''returns the user language''<br/> | + | [[Application:getDeviceInfo]] ''returns information about device''<br/><!--GIDEROSMTD:Application:getDeviceInfo() returns information about device--> |
| − | [[Application:getLocale]] ''returns the device locale''<br/> | + | [[Application:getDeviceName]] ''returns the device name''<br/><!--GIDEROSMTD:Application:getDeviceName() returns the device name--> |
| − | [[Application:getLogicalBounds]] ''returns the physical screen bounds in logical space''<br/> | + | [[Application:getDeviceOrientation]] ''gets the device orientation''<br/><!--GIDEROSMTD:Application:getDeviceOrientation() gets the device orientation--> |
| − | [[Application:getLogicalHeight]] ''returns the logical height of the application''<br/> | + | [[Application:getDeviceSafeArea]] ''returns the safe display area bounds''<br/><!--GIDEROSMTD:Application:getDeviceSafeArea(logical) returns the safe display area bounds--> |
| − | [[Application:getLogicalWidth]] ''returns the logical width of the application''<br/> | + | [[Application:getFps]] ''returns the frame rate of the application''<br/><!--GIDEROSMTD:Application:getFps() returns the frame rate of the application--> |
| − | [[Application:getLogicalScaleX]] ''returns the scaling of automatic screen scaling on the x-axis''<br/> | + | [[Application:getKeyboardModifiers]] ''returns the current keyboard modifiers''<br/><!--GIDEROSMTD:Application:getKeyboardModifiers() returns the current keyboard modifiers--> |
| − | [[Application:getLogicalScaleY]] ''returns the scaling of automatic screen scaling on the y-axis''<br/> | + | [[Application:getLanguage]] ''returns the user language''<br/><!--GIDEROSMTD:Application:getLanguage() returns the user language--> |
| − | [[Application:getLogicalTranslateX]] ''returns the translation of automatic screen scaling on the x-axis''<br/> | + | [[Application:getLocale]] ''returns the device locale''<br/><!--GIDEROSMTD:Application:getLocale() returns the device locale--> |
| − | [[Application:getLogicalTranslateY]] ''returns the translation of automatic screen scaling on the y-axis''<br/> | + | [[Application:getLogicalBounds]] ''returns the physical screen bounds in logical space''<br/><!--GIDEROSMTD:Application:getLogicalBounds() returns the physical screen bounds in logical space--> |
| − | [[Application:getOrientation]] ''returns the orientation of the application''<br/> | + | [[Application:getLogicalHeight]] ''returns the logical height of the application''<br/><!--GIDEROSMTD:Application:getLogicalHeight() returns the logical height of the application--> |
| − | [[Application:getScaleMode]] ''returns the automatic scale mode of the application''<br/> | + | [[Application:getLogicalWidth]] ''returns the logical width of the application''<br/><!--GIDEROSMTD:Application:getLogicalWidth() returns the logical width of the application --> |
| − | [[Application:getScreenDensity]] ''returns the screen density in pixels per inch''<br/> | + | [[Application:getLogicalScaleX]] ''returns the scaling of automatic screen scaling on the x-axis''<br/><!--GIDEROSMTD:Application:getLogicalScaleX() returns the scaling of automatic screen scaling on the x-axis--> |
| − | [[Application:getTextureMemoryUsage]] ''returns the texture memory usage in Kbytes''<br/> | + | [[Application:getLogicalScaleY]] ''returns the scaling of automatic screen scaling on the y-axis''<br/><!--GIDEROSMTD:Application:getLogicalScaleY() returns the scaling of automatic screen scaling on the y-axis--> |
| − | [[Application:isPlayerMode]] '' | + | [[Application:getLogicalTranslateX]] ''returns the translation of automatic screen scaling on the x-axis''<br/><!--GIDEROSMTD:Application:getLogicalTranslateX() returns the translation of automatic screen scaling on the x-axis--> |
| − | [[Application:openUrl]] ''opens the given URL in the appropriate application''<br/> | + | [[Application:getLogicalTranslateY]] ''returns the translation of automatic screen scaling on the y-axis''<br/><!--GIDEROSMTD:Application:getLogicalTranslateY() returns the translation of automatic screen scaling on the y-axis--> |
| − | [[Application:set]] ''sets state of desktop settings''<br/> | + | [[Application:getNativePath]] ''returns the system path for a given resource''<br/><!--GIDEROSMTD:Application:getNativePath(path) returns the system path for a given resource--> |
| − | [[Application:setBackgroundColor]] ''sets the background color in hexadecimal format''<br/> | + | [[Application:getOrientation]] ''returns the orientation of the application''<br/><!--GIDEROSMTD:Application:getOrientation() returns the orientation of the application--> |
| − | [[Application:setFps]] ''sets the frame rate of the application''<br/> | + | [[Application:getProjectProperties]] ''returns the project properties'' '''new'''<br/><!--GIDEROSMTD:Application:getProjectProperties() returns the project properties--> |
| − | [[Application:setFullScreen]] '' | + | [[Application:getScaleMode]] ''returns the automatic scale mode of the application''<br/><!--GIDEROSMTD:Application:getScaleMode() returns the automatic scale mode of the application--> |
| − | [[Application:setKeepAwake]] ''enables/disables screen dimming and device sleeping''<br/> | + | [[Application:getScreenDensity]] ''returns the screen density in pixels per inch''<br/><!--GIDEROSMTD:Application:getScreenDensity() returns the screen density in pixels per inch--> |
| − | [[Application:setKeyboardVisibility]] <br/> | + | [[Application:getTextureMemoryUsage]] ''returns the texture memory usage in Kbytes''<br/><!--GIDEROSMTD:Application:getTextureMemoryUsage() returns the texture memory usage in Kbytes--> |
| − | [[Application:setLogicalDimensions]] ''sets the logical dimensions of the application''<br/> | + | [[Application:isPlayerMode]] ''checks if app runs on player''<br/><!--GIDEROSMTD:Application:isPlayerMode() checks if app runs on player--> |
| − | [[Application:setOrientation]] ''sets the orientation of the application''<br/> | + | [[Application:openUrl]] ''opens the given URL in the appropriate application''<br/><!--GIDEROSMTD:Application:openUrl(url) opens the given URL in the appropriate application--> |
| − | [[Application:setScaleMode]] ''sets the automatic scale mode of the application''<br/> | + | [[Application:requestPermissions]] ''requests an android permission''<br/><!--GIDEROSMTD:Application:requestPermissions({permissions}) requests one or more android permission(s)--> |
| − | [[Application:setWindowSize]] '' | + | [[Application:set]] ''sets state of desktop settings''<br/><!--GIDEROSMTD:Application:set(setting, values) sets state of desktop settings--> |
| − | [[Application:vibrate]] ''vibrates the device''<br/> | + | [[Application:setBackgroundColor]] ''sets the background color''<br/><!--GIDEROSMTD:Application:setBackgroundColor(color) sets the background color in hexadecimal format--> |
| + | [[Application:setClipboard]] ''stores data to the clipboard''<br/><!--GIDEROSMTD:Application:setClipboard(string) stores data to the clipboard--> | ||
| + | [[Application:setEventMerging]] ''allows merging of touch/mouse move events''<br/><!--GIDEROSMTD:Application:setEventMerging(bool) allows merging of touch/mouse move events--> | ||
| + | [[Application:setFps]] ''sets the frame rate of the application''<br/><!--GIDEROSMTD:Application:setFps(fps) sets the frame rate of the application--> | ||
| + | [[Application:setFullScreen]] ''full screen or window mode''<br/><!--GIDEROSMTD:Application:setFullScreen(fullscreen) full screen or window mode--> | ||
| + | [[Application:setKeepAwake]] ''enables/disables screen dimming and device sleeping''<br/><!--GIDEROSMTD:Application:setKeepAwake(keepAwake) enables/disables screen dimming and device sleeping--> | ||
| + | [[Application:setKeyboardVisibility]] ''sets the keyboard visibility''<br/><!--GIDEROSMTD:Application:setKeyboardVisibility(visible) sets the keyboard visibility--> | ||
| + | [[Application:setLogicalDimensions]] ''sets the logical dimensions of the application''<br/><!--GIDEROSMTD:Application:setLogicalDimensions(width,height) sets the logical dimensions of the application--> | ||
| + | [[Application:setOrientation]] ''sets the orientation of the application''<br/><!--GIDEROSMTD:Application:setOrientation(orientation) sets the orientation of the application--> | ||
| + | [[Application:setScaleMode]] ''sets the automatic scale mode of the application''<br/><!--GIDEROSMTD:Application:setScaleMode(scaleMode) sets the automatic scale mode of the application--> | ||
| + | [[Application:setTextInput]] ''sets the IME of the android keyboard''<br/><!--GIDEROSMTD:Application:setTextInput(type,buffer,selstart,selend,label,actionLabel,hintText) sets the IME of the android keyboard--> | ||
| + | [[Application:setWindowSize]] ''sets desktop window to a specific size''<br/><!--GIDEROSMTD:Application:setWindowSize(width,height) sets desktop window to a specific size--> | ||
| + | [[Application:vibrate]] ''vibrates the device''<br/><!--GIDEROSMTD:Application:vibrate(ms) vibrates the device--> | ||
| style="width: 50%; vertical-align:top;"| | | style="width: 50%; vertical-align:top;"| | ||
| − | |||
=== Events === | === Events === | ||
| − | [[Event.APPLICATION_START]]<br/> | + | [[Event.APPLICATION_START]]<br/> |
| − | [[Event.APPLICATION_RESIZE]]<br/ | + | [[Event.APPLICATION_RESIZE]]<br/> |
| − | + | [[Event.APPLICATION_SUSPEND]]<br/> | |
| − | [[Event.APPLICATION_SUSPEND]]<br/> | + | [[Event.APPLICATION_EXIT]]<br/> |
| − | [[Event.APPLICATION_EXIT]]<br/> | ||
[[Event.APPLICATION_RESUME]]<br/> | [[Event.APPLICATION_RESUME]]<br/> | ||
| + | [[Event.APPLICATION_PERMISSION]] '''new'''<br/> | ||
| + | === Constants === | ||
| + | [[Application.CONSTANTS|Application.LANDSCAPE_LEFT]]<br/><!--GIDEROSCST:Application.LANDSCAPE_LEFT landscapeLeft--> | ||
| + | [[Application.CONSTANTS|Application.LANDSCAPE_RIGHT]]<br/><!--GIDEROSCST:Application.LANDSCAPE_RIGHT landscapeRight--> | ||
| + | [[Application.CONSTANTS|Application.PORTRAIT]]<br/><!--GIDEROSCST:Application.PORTRAIT portrait--> | ||
| + | [[Application.CONSTANTS|Application.PORTRAIT_UPSIDE_DOWN]]<br/><!--GIDEROSCST:Application.PORTRAIT_UPSIDE_DOWN portraitUpsideDown--> | ||
| − | + | [[Application.CONSTANTS|Application.CENTER]]<br/><!--GIDEROSCST:Application.CENTER center--> | |
| − | [[Application. | + | [[Application.CONSTANTS|Application.CROP]]<br/><!--GIDEROSCST:Application.CROP crop--> |
| − | [[Application. | + | [[Application.CONSTANTS|Application.FIT_HEIGHT]]<br/><!--GIDEROSCST:Application.FIT_HEIGHT fitHeight--> |
| − | [[Application. | + | [[Application.CONSTANTS|Application.FIT_WIDTH]]<br/><!--GIDEROSCST:Application.FIT_WIDTH fitWidth--> |
| − | [[Application. | + | [[Application.CONSTANTS|Application.LETTERBOX]]<br/><!--GIDEROSCST:Application.LETTERBOX letterbox--> |
| + | [[Application.CONSTANTS|Application.NO_SCALE]]<br/><!--GIDEROSCST:Application.NO_SCALE noScale--> | ||
| + | [[Application.CONSTANTS|Application.PIXEL_PERFECT]]<br/><!--GIDEROSCST:Application.PIXEL_PERFECT pixelPerfect--> | ||
| + | [[Application.CONSTANTS|Application.STRETCH]]<br/><!--GIDEROSCST:Application.STRETCH stretch--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_CLASS_NONE]]<br/><!--GIDEROSCST:Application.TEXTINPUT_CLASS_NONE 0--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_CLASS_TEXT]]<br/><!--GIDEROSCST:Application.TEXTINPUT_CLASS_TEXT 1--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_CLASS_NUMBER]]<br/><!--GIDEROSCST:Application.TEXTINPUT_CLASS_NUMBER 2--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_CLASS_PHONE]]<br/><!--GIDEROSCST:Application.TEXTINPUT_CLASS_PHONE 3--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_CLASS_DATE]]<br/><!--GIDEROSCST:Application.TEXTINPUT_CLASS_DATE 4--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_TVARIANT_URI]]<br/><!--GIDEROSCST:Application.TEXTINPUT_TVARIANT_URI 0x10--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_TVARIANT_EMAIL]]<br/><!--GIDEROSCST:Application.TEXTINPUT_TVARIANT_EMAIL 0x20--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_TVARIANT_PASSWORD]]<br/><!--GIDEROSCST:Application.TEXTINPUT_TVARIANT_PASSWORD 0x80--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_DVARIANT_DATE]]<br/><!--GIDEROSCST:Application.TEXTINPUT_DVARIANT_DATE 0x10--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_DVARIANT_TIME]]<br/><!--GIDEROSCST:Application.TEXTINPUT_DVARIANT_TIME 0x20--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_NVARIANT_PASSWORD]]<br/><!--GIDEROSCST:Application.TEXTINPUT_NVARIANT_PASSWORD 0x10--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_TFLAG_CAPCHARACTERS]]<br/><!--GIDEROSCST:Application.TEXTINPUT_TFLAG_CAPCHARACTERS 0x1000--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_TFLAG_CAPWORDS]]<br/><!--GIDEROSCST:Application.TEXTINPUT_TFLAG_CAPWORDS 0x2000--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_TFLAG_CAPSENTENCES]]<br/><!--GIDEROSCST:Application.TEXTINPUT_TFLAG_CAPSENTENCES 0x4000--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_TFLAG_AUTOCORRECT]]<br/><!--GIDEROSCST:Application.TEXTINPUT_TFLAG_AUTOCORRECT 0x8000--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_TFLAG_MULTILINE]]<br/><!--GIDEROSCST:Application.TEXTINPUT_TFLAG_MULTILINE 0x20000--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_NFLAG_SIGNED]]<br/><!--GIDEROSCST:Application.TEXTINPUT_NFLAG_SIGNED 0x1000--> | ||
| + | [[Application.CONSTANTS|Application.TEXTINPUT_NFLAG_DECIMAL]]<br/><!--GIDEROSCST:Application.TEXTINPUT_NFLAG_DECIMAL 0x2000--> | ||
|} | |} | ||
| − | + | {{GIDEROS IMPORTANT LINKS}} | |
| − | |||
| − | {{ | ||
| − | |||
| − | |||
| − | |||
Latest revision as of 04:52, 8 November 2024
Supported platforms: 
Available since: Gideros 2011.6
Inherits from: Object
Description
The Application class contains the common functions that are available to the current application.
There is a global variable application of type Application to access these functions.
