Class Settings


  • public final class Settings
    extends java.lang.Object
    this class provides some preferences from the device configuration and other Vm settings. All settings are read-only, unless otherwise specified. Changing their values may cause the VM to crash.
    • Field Summary

      Fields 
      Modifier and Type Field Description
      static boolean abortedOnLastRun
      Field set to true if the program have aborted on last run.
      static java.lang.String activationId
      READ-ONLY unique identifier available for registered applications after the TotalCross VM is activated.
      Value defaults to "NOT AVAILABLE" when running on DEMO, and "NO ACTIVATION" when using the new licensing model.
      static java.lang.String activationKey
      The activation key used during deploy
      static java.lang.String activationServerNamespace
      Set it at the application's static initializer.
      static java.lang.String activationServerURI
      Set it at the application's static initializer.
      static boolean allowBackup
      Apps that target Android 6.0 (API level 23) or higher automatically participate in Auto Backup.
      static byte Android
      Deprecated.
      Use ANDROID_UI instead
      static java.lang.String ANDROID
      Underlying platform is Android.
      static java.lang.String ANDROID_ID
      On Android it has the value of Settings.Secure.ANDROID_ID.
      static byte ANDROID_UI
      Defines an Android user interface style.
      static java.lang.String appCategory
      Deprecated.
      No longer used.
      static java.lang.String appDescription
      Deprecated.
      static java.lang.String applicationId
      The application's ID.
      static java.lang.String appLocation
      Deprecated.
      No longer used.
      static java.lang.String appPackageIdentifier
      Deprecated.
      static java.lang.String appPackagePublisher
      Deprecated.
      static java.lang.String appPath
      The path from where the application is running from.
      static Hashtable appProps
      Some properties you may want to use in the application.
      static java.lang.String appSecretKey
      Application defined secret key.
      static java.lang.String appSettings
      Application defined settings.
      static byte[] appSettingsBin
      Application defined settings, stored as a byte array.
      static java.lang.String appVersion
      Set it at the application's static initializer.
      static java.lang.String BLACKBERRY
      Dumb field to keep compilation compatibility with TC 1
      static java.lang.String bugreportEmail
      An email that will be used to send bug reports when an unhandled exception is caught on your application.
      static java.lang.String bugreportUser
      Set this to the username of your application to be able to filter at the bug report service.
      static int buildNumber
      Current build number for the TotalCross SDK.
      static int chunksCreated
      Number of memory chunks (blocks of memory that store Objects) created.
      static boolean circularNavigation
      Set to false to disable the default circular navigation when using the arrows: it will stop at the first or the last item.
      static int CLOSE_BUTTON
      To be used in the closeButtonType.
      static int closeButtonType
      Set it at the application's static initializer.
      static java.lang.String companyContact
      Deprecated.
      static java.lang.String companyInfo
      Set it at the application's static initializer; should not contain spaces.
      static IVirtualKeyboard customKeyboard  
      static java.lang.String dataPath
      Specifies the directory where pdbs should be read/written.
      static byte DATE_DMY
      Constant used in dateFormat: day month year
      static byte DATE_MDY
      Constant used in dateFormat: month day year
      static byte DATE_YMD
      Constant used in dateFormat: year month day
      static byte dateFormat
      Can be one of the following constants: DATE_MDY, DATE_DMY, DATE_YMD; where m = month, d = day and y = year
      static char dateSeparator
      The date char separator.
      static boolean daylightSavings
      Deprecated.
      Use daylightSavingsMinutes
      static int daylightSavingsMinutes
      Daylight savings minutes to add; will be 0 when not in daylight savings.
      static boolean debugEvents
      Set to true to debug all events that are received at Window._postEvent.
      static char decimalSeparator
      The decimal separator for numbers
      static int deviceFontHeight
      The size in pixels of the device's system font.
      static java.lang.String deviceId
      Field that represents a device id that can be used to identify the device's name.
      static int deviceRobotSpecialKey
      Makes the generation of user interface tests much easier by using the built-in User Interface Robot.
      static boolean disableScreenRotation
      Set to true to disable screen rotation.
      static boolean dontCloseApplication
      Deprecated.
      Not used in any platform
      static boolean enableVirtualKeyboard
      Set to false to disable the virtual keyboard on all Edits and MultiEdits at once
      static boolean enableWindowTransitionEffects
      Set to true to enable the transition effects when a window is shown and hidden.
      static java.lang.String esn
      Field that represents the smartphone ESN (if this device is a CDMA smartphone) or null if there's none.
      static boolean fadeOtherWindows
      Default fadeOtherWindows value used in the totalcross.ui.dialog windows.
      static boolean fingerTouch
      Defines platforms that the touchscreen is used MOSTLY with the finger.
      static byte Flat
      Deprecated.
      Use FLAT_UI instead
      static byte FLAT_UI
      Defines a FLAT user interface style, like the ones used in Pocket PC 2003.
      static java.lang.String fullScreenPlatforms
      Set this to a list of platforms that will set the fullscreen mode.
      static int gcCount
      Number of times that the GC ran.
      static int gcTime
      How much time the GC took in all runs.
      static boolean geographicalFocus
      When directional keys are used to change focus, the next control to receive focus will be determined based on their physical location on the screen.
      static byte Holo
      Deprecated.
      Use HOLO_UI instead
      static byte HOLO_UI
      Defines an Holo user interface style.
      static java.lang.String iccid
      Field that represents the serial number of the GSM chip or null if there's none.
      static java.lang.String imei
      Field that represents the smartphone IMEI (if this device is a GSM, UMTS or IDEN smartphone), or null if there's none.
      static java.lang.String[] imeis
      Field that represents the smartphone IMEIs; used in phones with more than one line.
      static Time iosCertDate
      The due date of the iOS certificate.
      static java.lang.String iosCFBundleIdentifier
      Set it at the application's static initializer.
      static java.lang.String IPAD
      Underlying platform is iPad.
      static java.lang.String IPHONE
      Underlying platform is iPhone.
      static boolean is24Hour
      True if the time format is 24 hour format or if it is the AM/PM format
      static boolean isFullScreen
      Set it at the application's static initializer.
      static boolean isMinimized
      Dumb field to keep compilation compatibility with TC 1
      static boolean isOpenGL
      Returns true if this is an open gl platform (IOS or Android).
      static java.lang.String JAVA
      Underlying platform is Java.
      static boolean keyboardFocusTraversable
      Defines if the arrow keys will be used to change the focus using the keyboard.
      static boolean keypadOnly
      Dumb field to keep compilation compatibility with TC 1
      static int lastInteractionTime
      Time when the user last interacted with the device using the keyboard, pen, trackball, etc.
      static java.lang.String lineNumber
      Returns the line number of the device.
      static java.lang.String LINUX
      Underlying platform is Linux.
      static java.lang.String macAddress
      Deprecated.
      due to provide users with greater data protection
      static byte Material
      Defines an user interface style.
      static byte MATERIAL_UI
      Defines an user interface style.
      static int minimalUpdateInterval
      Minimal interval between two Update events
      static int MINIMIZE_BUTTON
      To be used in the closeButtonType.
      static boolean moveCursorToEndOnFocus
      Set to true to put the cursor at the end of the Edit and MultiEdit when focus was set to the control (default is at the end).
      static boolean multipleInstances
      Setting this field to true allows the execution of multiple instances of the same application.
      static int NO_BUTTON
      To be used in the closeButtonType.
      static int nvfsVolume
      Dumb field to keep compilation compatibility with TC 1
      static boolean onJavaSE
      Field that defines if running in Java Standard Edition (ie, in Eclipse or java in your desktop or even on an applet in a browser) instead of a handheld device.
      static boolean optimizeScroll
      Set to false to disable the scroll optimization using images.
      static int optionalBackspaceKey
      An optional value for the backspace key.
      static byte PalmOS
      Deprecated.
      Use Flat, Vista or Android.
      static java.lang.String PALMOS
      Dumb field to keep compilation compatibility with TC 1
      static java.lang.String platform
      Field that returns the current platform name.
      static java.lang.String POCKETPC
      Underlying platform is Pocket PC.
      static java.lang.String pushTokenAndroid
      Deprecated.
      static boolean resizableWindow
      Set to true to make the program's window resizable in Windows and desktop.
      static java.lang.String romSerialNumber
      Field that represents the ROM serial number for this device.
      static int romVersion
      Field that returns the ROM version of the device, like 0x02000000 or 0x03010000.
      static int screenBPP
      Field that represents if the device supports color.
      static double screenDensity
      The logical density of the display, used as a scaling factor for density independent pixels (dp) and scaleable pixels (sp).
      static int screenHeight
      Field that represents the device's screen height
      static int screenHeightInDPI
      Field that represents the device's screen vertical pixels density, in dots per inch (DPI).
      static int screenWidth
      Field that represents the device's screen width
      static int screenWidthInDPI
      Field that represents the device's screen horizontal pixels density, in dots per inch (DPI).
      static int scrollDistanceOnMouseWheelMove
      Set to 0 to disable the automatic scroll of the ScrollContainer under the mouse position when the mouse wheel changes.
      static boolean sendPressEventOnChange
      Set to true to post a PRESSED event when an item is programatically selected or changed.
      static boolean showDebugTimestamp
      Set to false to don't display the timestamp before each Vm.debug output.
      static boolean showDesktopMessages
      Set to false to hide all messages that are sent to the console when running at the desktop.
      static boolean showMemoryMessagesAtExit
      Set this flag to false (default is true) to don't display the memory errors when the program exits.
      static boolean showMousePosition
      Shows the mouse position in the Window's title when running as Java SE application.
      static boolean showSecrets
      Deprecated.
      This was only used in Palm OS, which is now unsupported
      static boolean showUIErrors
      Set to false to disable UI positional errors that are shown in Java SE
      static int SIPBottomLimit
      The limit that will make the Soft Input Panel be placed at bottom.
      static char thousandsSeparator
      The thousands separator for numbers
      static char timeSeparator
      The time char separator
      static int timeZone
      Deprecated.
      Use timeZoneMinutes
      static int timeZoneMinutes
      Timezone in minutes.
      static java.lang.String timeZoneStr
      Textual description of the time zone currently used by the device.
      static int touchTolerance
      Defines a touch tolerance to find the closest control.
      static boolean uiAdjustmentsBasedOnFontHeight
      Set to true to make the extra adjustment values used in the relative positioning be a percentage of the control's font height.
      static byte uiStyle
      Field that stores the current user interface style.
      static boolean unmovableSIP
      Set to true to move an Edit or MultiEdit to the top of the screen if the application is running in a platform that does not support moving the Soft Input Panel to the top.
      static boolean useNewFont
      Dumb field to keep compilation compatibility with TC 1
      static java.lang.String userName
      Field that returns the username of the user running the Virtual Machine.
      static int version
      Field that represents the version of the TotalCross Virtual Machine.
      static java.lang.String versionStr
      Field that represents the version in a string form, like "1.36".
      static boolean vibrateMessageBox
      Set to true to enable the vibration when a MessageBox appears on screen (only on device).
      static boolean virtualKeyboard
      True if this handheld has a virtual keyboard, I.E., like the soft input panel in windows ce devices or in the Tungsten T|X.
      static byte Vista
      Deprecated.
      Use VISTA_UI instead
      static byte VISTA_UI
      Defines a Windows Vista user interface style.
      static java.lang.String vmPath
      The main path used to derive tempPath and appPath and also to store TotalCross global files.
      static byte weekStart
      The week day start.
      static java.lang.String WIN32
      Underlying platform is desktop Windows.
      static byte WinCE
      Deprecated.
      Use Flat, Vista or Android.
      static int windowFont
      Deprecated.
      Use at the application's constructor: if (Settings.platform.equals(Settings.WIN32)) setDefaultFont(Font.getFont(false,NN)); where NN is the desired font size
      static int WINDOWFONT_12
      Used in the windowFont field; sets the size to 12.
      static int WINDOWFONT_DEFAULT
      Used in the windowFont field; sets the size to the one defined by user.
      static java.lang.String WINDOWSCE
      Underlying platform is Windows CE.
      static int windowSize
      Defines the window size when running in a desktop computer (the default is 240x320).
      static int WINDOWSIZE_320X480
      Used in the windowSize field.
      static int WINDOWSIZE_480X640
      Used in the windowSize field.
      static int WINDOWSIZE_600X800
      Used in the windowSize field.
      static java.lang.String WINDOWSMOBILE
      Underlying platform is Windows Mobile.
      static java.lang.String WINDOWSPHONE
      Deprecated. 
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static java.lang.String appBuildNumber()
      Returns the application's build number.
      static int getAnimationMaximumFps()  
      static java.lang.String getUniqueId()
      Returns an id from the mobile device (Android and iOS) that should be persistent on reinstall.
      static boolean isIOS()
      Returns true if this is an iPad or an iPhone.
      static boolean isLandscape()
      Returns true if the device is currently in landscale (screenWidth > screenHeight).
      static boolean isWindowsCE()
      Returns true if the current platform is Windows Mobile or Windows Phone.
      static boolean isWindowsDevice()
      Returns true if the current platform is Windows Mobile or Windows Phone.
      static void refresh()
      Refresh some fields thay may have been updated since the program started.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • version

        public static int version
        Field that represents the version of the TotalCross Virtual Machine. The major version is base 100. For example, version 1.0 has value 100. version 4 has a version value of 400. A beta 0.81 VM will have version 81.
      • versionStr

        public static java.lang.String versionStr
        Field that represents the version in a string form, like "1.36". Only digits and dot is allowed or an exception will be throws during tc.Deploy.
      • buildNumber

        public static int buildNumber
        Current build number for the TotalCross SDK.
        Since:
        TotalCross 1.53
      • appProps

        public static Hashtable appProps
        Some properties you may want to use in the application. The file format must be:
         property=value<enter>
         
        This file must be named tcapp.prop and it is searched from the current folder up to the root folder. To have a build number be incremented by tc.Deploy, just create the file somewhere in a parent folder from where you run tc.Deploy for your application. The file will be inserted into the application's tcz and you will be able to retrieve the build number using Settings.appBuildNumber(). Note that the properties are always read-only and you can add other values to be used in your application.
        Since:
        TotalCross 3.1
      • dateFormat

        public static byte dateFormat
        Can be one of the following constants: DATE_MDY, DATE_DMY, DATE_YMD; where m = month, d = day and y = year
        See Also:
        DATE_DMY, DATE_MDY, DATE_YMD
      • dateSeparator

        public static char dateSeparator
        The date char separator.
      • weekStart

        public static byte weekStart
        The week day start. 0 = Sunday, 6 = Saturday
      • is24Hour

        public static boolean is24Hour
        True if the time format is 24 hour format or if it is the AM/PM format
      • timeSeparator

        public static char timeSeparator
        The time char separator
      • thousandsSeparator

        public static char thousandsSeparator
        The thousands separator for numbers
      • decimalSeparator

        public static char decimalSeparator
        The decimal separator for numbers
      • screenWidth

        public static int screenWidth
        Field that represents the device's screen width
      • screenHeight

        public static int screenHeight
        Field that represents the device's screen height
      • screenWidthInDPI

        public static int screenWidthInDPI
        Field that represents the device's screen horizontal pixels density, in dots per inch (DPI). Note that this value can be incorrect in many devices.
      • screenHeightInDPI

        public static int screenHeightInDPI
        Field that represents the device's screen vertical pixels density, in dots per inch (DPI). Note that this value can be incorrect in many devices.
      • screenBPP

        public static int screenBPP
        Field that represents if the device supports color. /** Field that represents the screen's number of bits per pixel.
        Since:
        TotalCross 1.0
      • onJavaSE

        public static boolean onJavaSE
        Field that defines if running in Java Standard Edition (ie, in Eclipse or java in your desktop or even on an applet in a browser) instead of a handheld device.
      • romVersion

        public static int romVersion
        Field that returns the ROM version of the device, like 0x02000000 or 0x03010000. For Android, returns the version in decimal number (E.G.: 3.16 is returned as 316).
      • JAVA

        public static final java.lang.String JAVA
        Underlying platform is Java. To be used with the platform member.
        See Also:
        Constant Field Values
      • WINDOWSCE

        public static final java.lang.String WINDOWSCE
        Underlying platform is Windows CE. To be used with the platform member.
        See Also:
        Constant Field Values
      • POCKETPC

        public static final java.lang.String POCKETPC
        Underlying platform is Pocket PC. To be used with the platform member.
        See Also:
        Constant Field Values
      • WINDOWSMOBILE

        public static final java.lang.String WINDOWSMOBILE
        Underlying platform is Windows Mobile. To be used with the platform member.
        See Also:
        Constant Field Values
      • WIN32

        public static final java.lang.String WIN32
        Underlying platform is desktop Windows. To be used with the platform member.
        See Also:
        Constant Field Values
      • WINDOWSPHONE

        @Deprecated
        public static final java.lang.String WINDOWSPHONE
        Deprecated.
        Underlying platform is Windows Phone. To be used with the platform member.
        See Also:
        Constant Field Values
      • LINUX

        public static final java.lang.String LINUX
        Underlying platform is Linux. To be used with the platform member.
        See Also:
        Constant Field Values
      • IPHONE

        public static final java.lang.String IPHONE
        Underlying platform is iPhone. To be used with the platform member.
        See Also:
        Constant Field Values
      • ANDROID

        public static final java.lang.String ANDROID
        Underlying platform is Android. To be used with the platform member.
        See Also:
        Constant Field Values
      • IPAD

        public static final java.lang.String IPAD
        Underlying platform is iPad. To be used with the platform member.
        See Also:
        Constant Field Values
      • userName

        public static java.lang.String userName
        Field that returns the username of the user running the Virtual Machine. Because of Java's security model, this method will return null when called in a Java applet. This method will also return null under most WinCE devices (that will be fixed in a future release). In Windows 32, this will return the currently logged in user.
      • appSettingsBin

        public static byte[] appSettingsBin
        Application defined settings, stored as a byte array. If you set the value of this app to something other than null, the VM will save it when exiting and load it when restarting. Under PalmOS, the value is stored in the unsaved preferences database, which is not backed up during hot-sync. Use this to save small amount of data, up to 2 or 4 kb maximum. At desktop, a file named settings4crtr.pdb stores the appSettingsBin for the current running TotalCross programs. Here's a sample of how to use it:
          if (Settings.appSettingsBin == null)
          {
             add(new Label("empty"),CENTER,CENTER);
             ByteArrayStream bas = new ByteArrayStream(100);
             DataStream ds = new DataStream(bas);
             ds.writeDouble(1234.567);
             Settings.appSettingsBin = bas.getCopy();
          }
          else
          {
             ByteArrayStream bas = new ByteArrayStream(Settings.appSettingsBin);
             DataStream ds = new DataStream(bas);
             double d = ds.readDouble();
             add(new Label("d = "+Convert.toString(d,3)),CENTER,CENTER);
             Settings.appSettingsBin = null;
          }
         
        This property is saved only at application's exit; you can force an update by calling Settings.refresh().
        See Also:
        refresh()
      • appSettings

        public static java.lang.String appSettings
        Application defined settings. If you set the value of this app to something other than null, the VM will save it when exiting and load it when restarting. Under PalmOS, the value is stored in the unsaved preferences database, which is not backed up during hot-sync. Use this to save small strings, up to 2 or 4 kb maximum. At desktop, a file named settings4crtr.pdb stores the appSettings for the current running TotalCross programs. This property is saved only at application's exit; you can force an update by calling Settings.refresh().
        See Also:
        refresh()
      • appSecretKey

        public static java.lang.String appSecretKey
        Application defined secret key. If you set the value of this app to something other than null, the VM will save it when exiting and load it when restarting. Under PalmOS, the value is stored in the saved preferences database, which is backed up during hotsync. Use this to save small strings, up to 2 or 4 kb maximum. At desktop, a file named settings4crtr.pdb stores the appSettings for the current running TotalCross programs. The String is stored in the saved preferences with a creator id different of your application's (but calculated based in it), so it will never be deleted and will be restored even after a hard-reset.

        In Windows CE, the key is stored in the registry. This property is saved only at application's exit; you can force an update by calling Settings.refresh().

        See Also:
        refresh()
      • applicationId

        public static java.lang.String applicationId
        The application's ID. MUST BE CHANGED IN THE STATIC INITIALIZER! Used by the deployer and by the virtual machine. In Palm OS, all data created is assigned to an application id. So when a program is uninstalled, all of its data is also removed from device. In Android, when the single package option is passed to tc.Deploy (/p), the application's package is changed to totalcross.app<application id>. It must have 4 letters or digits, and the first character must be a letter.
      • WinCE

        @Deprecated
        public static final byte WinCE
        Deprecated.
        Use Flat, Vista or Android. This user interface does not work on TotalCross 2.
        Defines a Windows CE user interface style. Used in the uiStyle member.
        See Also:
        MainWindow.setUIStyle(byte), Constant Field Values
      • PalmOS

        @Deprecated
        public static final byte PalmOS
        Deprecated.
        Use Flat, Vista or Android. This user interface does not work on TotalCross 2.
        Defines a PalmOS user interface style. Used in the uiStyle member.
        See Also:
        MainWindow.setUIStyle(byte), Constant Field Values
      • Flat

        @Deprecated
        public static final byte Flat
        Deprecated.
        Use FLAT_UI instead
        Defines a FLAT user interface style, like the ones used in Pocket PC 2003. Used in the uiStyle member.
        See Also:
        MainWindow.setUIStyle(byte), Constant Field Values
      • DATE_MDY

        public static final byte DATE_MDY
        Constant used in dateFormat: month day year
        See Also:
        Constant Field Values
      • DATE_DMY

        public static final byte DATE_DMY
        Constant used in dateFormat: day month year
        See Also:
        Constant Field Values
      • DATE_YMD

        public static final byte DATE_YMD
        Constant used in dateFormat: year month day
        See Also:
        Constant Field Values
      • daylightSavings

        @Deprecated
        public static boolean daylightSavings
        Deprecated.
        Use daylightSavingsMinutes
        Field that represents if the device is in daylight savings mode.
        Since:
        SuperWaba 3.4
      • daylightSavingsMinutes

        public static int daylightSavingsMinutes
        Daylight savings minutes to add; will be 0 when not in daylight savings. To compute the difference to GMT+0, use:
         int dif = Settings.timeZoneMinutes + Settings.daylightSavingsMinutes;
         int hours = dif / 60;
         int minutes = Math.abs(dif % 60);
         
        Since:
        TotalCross 2.0
      • timeZone

        @Deprecated
        public static int timeZone
        Deprecated.
        Use timeZoneMinutes
        Field that represents the timezone used for this device. This is the number of hours away from GMT (E.g.: for Brazil it will return -3).
        Since:
        SuperWaba 3.4
      • timeZoneMinutes

        public static int timeZoneMinutes
        Timezone in minutes. Some countries have a timezone difference in minutes, like Iran with 3:30. In this example, timeZoneMinutes will be 210. To compute the difference to GMT+0, use:
         int dif = Settings.timeZoneMinutes + Settings.daylightSavingsMinutes;
         int hours = dif / 60;
         int minutes = Math.abs(dif % 60);
         
        Since:
        TotalCross 2.0
      • virtualKeyboard

        public static boolean virtualKeyboard
        True if this handheld has a virtual keyboard, I.E., like the soft input panel in windows ce devices or in the Tungsten T|X.
      • dataPath

        public static java.lang.String dataPath
        Specifies the directory where pdbs should be read/written. Used in desktop when:
        1. Running under Win32 VM. Can be specified anywhere.
        2. Running under JDK, as application (java.exe). Can also be specified with the /dataPath commandline parameter.
        Some warnings:
        • If this member is not null, any paths specified for the file are replaced by this path.
        • Slashes are normalized by the vm.
        • The path existence is not verified on Win32.
        • Changing this member also changes the place where local libraries are loaded (global libraries are loaded when the VM starts, before the app is initialized). So, before loading any library, change this member back to null (unless the library is also in the dataPath).
        • The system ensures that the datapath ends with a slash, if you don't put one.
        Since:
        SuperWaba 4.11 (Win32) and 2.0beta4 (JDK)
      • romSerialNumber

        public static java.lang.String romSerialNumber
        Field that represents the ROM serial number for this device. Important!: don't rely only on this information to uniquely identify a device! Its very easy to change this number, and it won't be available in all devices. It will contain null if unavailable, such as in Windows CE 2.11 devices, Palm OS < 3.0, and even some Palm OS 5 devices, like Treo 6xx.

        Note: this was correctly tested; you can ensure that your Palm OS device has or not a serial number pressing App/Info/Version: the serial number will appear in the top; if nothing appears, it means that the device doesn't has a serial number. If it appears but nothing is returned from here, it means that the device has a non-standard function that retrieves the serial number, and thus we don't support it. In Android 3.0 or greater it will return the serial number; in Android 1.x and 2.x will return a consistent number that MAY be the same across resets, but has no relation to the real serial number.

        Since:
        SuperWaba 4.21
        See Also:
        imei, iccid
      • macAddress

        @Deprecated
        public static java.lang.String macAddress
        Deprecated.
        due to provide users with greater data protection
        The macAddress currently in use. Currently works only on Android.
      • showSecrets

        @Deprecated
        public static boolean showSecrets
        Deprecated.
        This was only used in Palm OS, which is now unsupported
        Field that represents if the PDA has a password and the user choosen to hide the secret records (via the Apps/Security/Current Privacy). Returns true in all other cases. Specific for Palm OS (Windows CE does not let the user hide records). This can be used to let the Operating System do the login for a program that requires privacy.
        Since:
        SuperWaba 4.21
      • keyboardFocusTraversable

        public static boolean keyboardFocusTraversable
        Defines if the arrow keys will be used to change the focus using the keyboard. Note that some controls will behave differently. It will be true for pen less devices, and it may be changed if your application wants to use navigation keys to change the focus between the controls.
        Since:
        SuperWaba 5.5
      • deviceId

        public static java.lang.String deviceId
        Field that represents a device id that can be used to identify the device's name. For Palm OS devices, see: http://www.mobilegeographics.com/dev/devices.php and http://homepage.mac.com/alvinmok/palm/codenames.html. For Pocket PC devices, it will return the device's name. For Win32 VM, it will return the computer name. For iPod & iPhone devices, values are : "i386" on simulator, "iPod1,1" on iPod Touch, "iPhone1,1" on iPhone, "iPhone1,2" on iPhone 3G, and "iPhone2,1" on iPhone 3GS, as listed in the "Model identifier" row at http://en.wikipedia.org/w/index.php?title=List_of_iPhone_and_iPod_Touch_models&oldid=319641529 If the device can't be identified, it will contain null.
      • vmPath

        public static java.lang.String vmPath
        The main path used to derive tempPath and appPath and also to store TotalCross global files. This is a read-only property: changing it will have no effect.
        Since:
        TotalCross 1.0
      • appPath

        public static java.lang.String appPath
        The path from where the application is running from. In Palm OS devices, it will be null. This is the default location where the PDBFiles are created. This is a read-only property: changing it will have no effect.
        Since:
        SuperWaba 5.81
        See Also:
        dataPath
      • NO_BUTTON

        public static final int NO_BUTTON
        To be used in the closeButtonType. Will remove the x/ok button from screen on Windows CE devices. In Windows 32, the X button will still be visible, but clicking on it will not close the application; instead, the SpcialKeys.MENU key event will be sent to the application.
        See Also:
        Constant Field Values
      • CLOSE_BUTTON

        public static final int CLOSE_BUTTON
        To be used in the closeButtonType. An OK button is placed, and the application is closed when its pressed.
        See Also:
        Constant Field Values
      • MINIMIZE_BUTTON

        public static final int MINIMIZE_BUTTON
        To be used in the closeButtonType. A X button is placed, and the application is minimized when its pressed.
        See Also:
        Constant Field Values
      • closeButtonType

        public static int closeButtonType
        Set it at the application's static initializer. If set to MINIMIZE_BUTTON, replaces the ok button in Windows CE devices, which closes the application, by the x one, which just minimizes the application. The ok closes the application, and the x minimizes it. By default, it is CLOSE_BUTTON, which closes the application.
        Since:
        TotalCross 1.11
        See Also:
        CLOSE_BUTTON, MINIMIZE_BUTTON, NO_BUTTON
      • isFullScreen

        public static boolean isFullScreen
        Set it at the application's static initializer. Makes the application full screen. Only a simple assignment to true is supported; you cannot check the platform nor any other attribute of this class because the static initializer is called BEFORE this class have its fields set. Also, some platforms set it at Deploying time. Note that Android applications have problems with the keyboard when its fullscreen.
        Since:
        TotalCross 1.0
        See Also:
        fullScreenPlatforms
      • fullScreenPlatforms

        public static java.lang.String fullScreenPlatforms
        Set this to a list of platforms that will set the fullscreen mode. If this member is null, all platforms will have full screen set to the isFullScreen member. Here's a sample, to use full screen on windows devices (but not windows desktop):
         static
              {
                 Settings.isFullScreen = true;
                 Settings.fullScreenPlatforms = Settings.WINDOWSCE+","+Settings.WINDOWSMOBILE;
              }
         
        You can use any separator. The only platform that does not work with this is JAVA. You must provide a String like the one above, concatenating the platform Strings in a single line. Using a StringBuffer or anything else may result in incorrect results.
        Since:
        TotalCross 1.2
        See Also:
        isFullScreen
      • appVersion

        public static java.lang.String appVersion
        Set it at the application's static initializer. Defines the current application's version, which will be applied to the pdbs. If you turn on automatic build number increment (with appProps) and the appVersion ends with a dot, during deploy the build number will be appended to the appVersion. For example, if appVersion is "2." and the current build number is 103, deploy will change the appVersion to "2.103" during deploy. To see the version that will appear, use at your application's constructo: Settings.appVersion += Settings.appBuildNumber();
        Since:
        TotalCross 1.0
      • companyInfo

        public static java.lang.String companyInfo
        Set it at the application's static initializer; should not contain spaces. Defines the company's information, which is used in iOS and Windows CE. In iOS is used to form the bundle suffix id.
        Since:
        TotalCross 1.0
      • companyContact

        @Deprecated
        public static java.lang.String companyContact
        Deprecated.
        Set it at the application's static initializer. Defines the user's or company's contact email, which was used in WP8.
        Since:
        TotalCross 1.0
      • appDescription

        @Deprecated
        public static java.lang.String appDescription
        Deprecated.
        Set it at the application's static initializer. Defines the application's description, which was used in WP8.
        Since:
        TotalCross 1.0
      • appPackageIdentifier

        @Deprecated
        public static java.lang.String appPackageIdentifier
        Deprecated.
        Set it at the application's static initializer. Defines the application's package identifier, which was used in WP8.
      • appPackagePublisher

        @Deprecated
        public static java.lang.String appPackagePublisher
        Deprecated.
        Set it at the application's static initializer. Defines the application's package publisher, which was used in WP8.
      • iosCFBundleIdentifier

        public static java.lang.String iosCFBundleIdentifier
        Set it at the application's static initializer. Defines the application's package id, which is used in iOS.
      • appLocation

        @Deprecated
        public static java.lang.String appLocation
        Deprecated.
        No longer used.
        Since:
        TotalCross 1.0
      • appCategory

        @Deprecated
        public static java.lang.String appCategory
        Deprecated.
        No longer used.
        Since:
        TotalCross 1.0
      • activationServerURI

        public static java.lang.String activationServerURI
        Set it at the application's static initializer. Specifies a URI to a WebService to be used by the VM activation process.
        See the TotalCross Companion for more information about this feature.
        Since:
        TotalCross 1.15
      • activationServerNamespace

        public static java.lang.String activationServerNamespace
        Set it at the application's static initializer. Specifies a namespace for the WebService provided by the user.
        See the TotalCross Companion for more information about this feature.
        Since:
        TotalCross 1.15
      • showDesktopMessages

        public static boolean showDesktopMessages
        Set to false to hide all messages that are sent to the console when running at the desktop. Note that doing so may hide important messages! Do it with caution.
        Since:
        TotalCross 1.0
      • imei

        public static java.lang.String imei
        Field that represents the smartphone IMEI (if this device is a GSM, UMTS or IDEN smartphone), or null if there's none.
        Since:
        TotalCross 1.0
      • imeis

        public static java.lang.String[] imeis
        Field that represents the smartphone IMEIs; used in phones with more than one line.
        Since:
        TotalCross 1.0
      • esn

        public static java.lang.String esn
        Field that represents the smartphone ESN (if this device is a CDMA smartphone) or null if there's none.
        Since:
        TotalCross 1.0
      • iccid

        public static java.lang.String iccid
        Field that represents the serial number of the GSM chip or null if there's none. Works for Windows Mobile and Android.
        Since:
        TotalCross 1.27
      • dontCloseApplication

        @Deprecated
        public static boolean dontCloseApplication
        Deprecated.
        Not used in any platform
        If set to true, the application will ignore the event "Close application" issued by the operating system. This is specially useful to avoid that an incoming call exits the application on Palm OS. You must provide a way to terminate the application by calling the exit method.
        Since:
        TotalCross 1.0
        See Also:
        MainWindow.exit(int)
      • geographicalFocus

        public static boolean geographicalFocus
        When directional keys are used to change focus, the next control to receive focus will be determined based on their physical location on the screen. Also, when geographicalFocus is true, the highlight/action key model will not be used. Instead, controls will be highlighted and given focus immediately.
      • multipleInstances

        public static boolean multipleInstances
        Setting this field to true allows the execution of multiple instances of the same application. When the application is started, it first checks if there is a running instance of the same application. If so, the running instance is moved to the foreground and the starting application exits. This only works for Win32 and WinCE.
        Since:
        TotalCross 1.0
      • circularNavigation

        public static boolean circularNavigation
        Set to false to disable the default circular navigation when using the arrows: it will stop at the first or the last item. It applies to: ListBox, MenuBar, ComboBoxEditable, Grid, MenuBarDropDown.
        Since:
        TotalCross 1.13
      • gcCount

        public static int gcCount
        Number of times that the GC ran. Updated by the VM during the application execution.
        Since:
        TotalCross 1.14
      • gcTime

        public static int gcTime
        How much time the GC took in all runs. Updated by the VM during the application execution.
        Since:
        TotalCross 1.14
      • chunksCreated

        public static int chunksCreated
        Number of memory chunks (blocks of memory that store Objects) created. Updated by the VM during the application execution.
        Since:
        TotalCross 1.14
      • lastInteractionTime

        public static int lastInteractionTime
        Time when the user last interacted with the device using the keyboard, pen, trackball, etc.
        Since:
        TotalCross 1.14
      • showMemoryMessagesAtExit

        public static boolean showMemoryMessagesAtExit
        Set this flag to false (default is true) to don't display the memory errors when the program exits. The possible errors are:
        • Memory error: out of memory when allocating
        • Memory leak: memory was not freed properly
        It is highly recommended that you keep this flag on while debugging your programs, but you may not want to let it on when deploying your application to your costumers.
        Note that the log messages will still be dumped to the console.
        Since:
        TotalCross 1.14
      • showMousePosition

        public static boolean showMousePosition
        Shows the mouse position in the Window's title when running as Java SE application. This greatly helps the creation of UIRobot's user interface unit tests (using absolute coordinates to simulate the events).
        Since:
        TotalCross 1.15
      • deviceRobotSpecialKey

        public static int deviceRobotSpecialKey
        Makes the generation of user interface tests much easier by using the built-in User Interface Robot.
        • To enable it at device, you must assign a special key that will open the interface.
        • To enable it at desktop (Java SE), you must press control+1.
        For example, if you want to set the SpecialKeys.FIND to be the one that will open the UIRobot, do:
         Vm.interceptSpecialKeys(new int[]{SpecialKeys.FIND});
         Settings.deviceRobotSpecialKey = SpecialKeys.FIND;
         
        Since:
        TotalCross 1.3
      • showDebugTimestamp

        public static boolean showDebugTimestamp
        Set to false to don't display the timestamp before each Vm.debug output.
        Since:
        TotalCross 1.15
      • timeZoneStr

        public static java.lang.String timeZoneStr
        Textual description of the time zone currently used by the device. This value is completely platform dependent, and may be localized for the platform current settings.
        Since:
        TotalCross 1.15
      • fingerTouch

        public static boolean fingerTouch
        Defines platforms that the touchscreen is used MOSTLY with the finger. We say mostly because there are special pens that can be used with iPhone; however, we consider this an exception, not the rule. Currently this value is true for iPhone and Android platforms.

        When fingerTouch is true, all controls that can scroll, like ListBox, Grid, ScrollContainer, MultiEdit, etc, will have the flick and drag enabled and the ScrollBar will be replaced by the ScrollPosition.
        Since:
        TotalCross 1.2
      • touchTolerance

        public static int touchTolerance
        Defines a touch tolerance to find the closest control. Used in fingerTouch devices. You can disable it setting this property to 0.
        Since:
        TotalCross 1.2
      • fadeOtherWindows

        public static boolean fadeOtherWindows
        Default fadeOtherWindows value used in the totalcross.ui.dialog windows.
        Since:
        TotalCross 1.2
      • debugEvents

        public static boolean debugEvents
        Set to true to debug all events that are received at Window._postEvent.
      • activationId

        public static java.lang.String activationId
        READ-ONLY unique identifier available for registered applications after the TotalCross VM is activated.
        Value defaults to "NOT AVAILABLE" when running on DEMO, and "NO ACTIVATION" when using the new licensing model.
        Since:
        TotalCross 1.25
      • vibrateMessageBox

        public static boolean vibrateMessageBox
        Set to true to enable the vibration when a MessageBox appears on screen (only on device).
        Since:
        TotalCross 1.22
      • disableScreenRotation

        public static boolean disableScreenRotation
        Set to true to disable screen rotation. Works only in JavaSE. If you need this feature on the device, override the screenResized method in your MainWindow and add something like:
              public void screenResized()
              {
                 if (Settings.isLandscape())
                 {
                    // make sure that the MessageBox takes the whole screen
                    MessageBox mb = new MessageBox("Attention","This program must be run in portrait mode.\nPlease rotate the device.",null)
                    {
                       public void setRect(int x, int y, int w, int h)
                       {
                          super.setRect(x,y,Settings.screenWidth,Settings.screenHeight);
                       }
                    };
                    mb.transitionEffect = TRANSITION_NONE;
                    mb.popupNonBlocking();
                    while (Settings.isLandscape())
                       pumpEvents();
                    mb.unpop();
                 }
                 else super.screenResized();
              }
         
        Since:
        TotalCross 1.27
      • unmovableSIP

        public static boolean unmovableSIP
        Set to true to move an Edit or MultiEdit to the top of the screen if the application is running in a platform that does not support moving the Soft Input Panel to the top. Otherwise, the SIP (Soft Input Panel) will be placed on top of the Edit. You must set this in the MainWindow's constructor, never in the static block.
        Since:
        TotalCross 1.3
        See Also:
        SIPBottomLimit, UIColors.shiftScreenColor
      • deviceFontHeight

        public static int deviceFontHeight
        The size in pixels of the device's system font.
      • moveCursorToEndOnFocus

        public static boolean moveCursorToEndOnFocus
        Set to true to put the cursor at the end of the Edit and MultiEdit when focus was set to the control (default is at the end).
        Since:
        TotalCross 1.3
      • SIPBottomLimit

        public static int SIPBottomLimit
        The limit that will make the Soft Input Panel be placed at bottom. If the control's absolute rect is < this value, the SIP will stay at the bottom of the screen (otherwise, it will be moved to the top). Before TotalCross 1.3, this value used to be the half of the screen, but since in some new Windows Mobile the SIP is very tall (specially in landscape mode), we added this field so you can change it if desired. For example, to set to 5 times the font's height, do:
         Settings.SIPBottomLimit = 5 * fmH;
         
        Setting it to -1 (default value) will use half the current screen height. This field is used in Windows CE devices only.
        Since:
        TotalCross 1.3
      • uiAdjustmentsBasedOnFontHeight

        public static boolean uiAdjustmentsBasedOnFontHeight
        Set to true to make the extra adjustment values used in the relative positioning be a percentage of the control's font height. In modern devices, a single pixel can have different sizes in inches (or, in other words, the devices have different screen densities). So, something like PREFERRED+4 in a 320x480 device with 160 DPI (DIPS PER INCH - or pixels per inch) will have the half size of a device with the same resolution but 320 DPI. Since the font sizes change according to the DPI and not the resolution, its good to change the relative positioning to use a percentage of the font's height instead of absolute pixels. By setting this flag to true will make the adjustment a PERCENTAGE of the font's height. So, you can use something like PREFERRED+50 (50% of font's height), SAME+150 (150% of font's height), and so on. It is possible to disable the adjustment for a single Control, Container or Window, using Control.uiAdjustmentsBasedOnFontHeightIsSupported.
        See Also:
        Control.uiAdjustmentsBasedOnFontHeightIsSupported
      • sendPressEventOnChange

        public static boolean sendPressEventOnChange
        Set to true to post a PRESSED event when an item is programatically selected or changed. Works with the following controls: Edit, MultiEdit, Check, Radio, ComboBox, ListBox, SpinList. Usually this event only occurs when the user selects an item, not when you call setSelectedItem/Index
        Since:
        TotalCross 1.5
      • resizableWindow

        public static boolean resizableWindow
        Set to true to make the program's window resizable in Windows and desktop.
        Since:
        TotalCross 1.53
      • WINDOWSIZE_320X480

        public static final int WINDOWSIZE_320X480
        Used in the windowSize field.
        See Also:
        Constant Field Values
      • WINDOWSIZE_480X640

        public static final int WINDOWSIZE_480X640
        Used in the windowSize field.
        See Also:
        Constant Field Values
      • WINDOWSIZE_600X800

        public static final int WINDOWSIZE_600X800
        Used in the windowSize field.
        See Also:
        Constant Field Values
      • windowSize

        public static int windowSize
        Defines the window size when running in a desktop computer (the default is 240x320). Must be set in the static initializer. If used, the window will be centered on screen with the given resolution.
        Since:
        TotalCross 1.53
        See Also:
        WINDOWSIZE_320X480, WINDOWSIZE_480X640, WINDOWSIZE_600X800, resizableWindow
      • WINDOWFONT_12

        public static final int WINDOWFONT_12
        Used in the windowFont field; sets the size to 12.
        See Also:
        Constant Field Values
      • WINDOWFONT_DEFAULT

        public static final int WINDOWFONT_DEFAULT
        Used in the windowFont field; sets the size to the one defined by user.
        See Also:
        Constant Field Values
      • windowFont

        @Deprecated
        public static int windowFont
        Deprecated.
        Use at the application's constructor: if (Settings.platform.equals(Settings.WIN32)) setDefaultFont(Font.getFont(false,NN)); where NN is the desired font size
        Defines the window font size when running in a desktop computer. Must be set in the static initializer.
        Since:
        TotalCross 1.53
        See Also:
        WINDOWFONT_12, WINDOWFONT_DEFAULT, windowSize, resizableWindow
      • lineNumber

        public static java.lang.String lineNumber
        Returns the line number of the device. Note that if the phone is off it may return null. It can be null also if the device uses a non-standard API. Works only on Android, since iOS does not allow to get it programatically. For dual-sim devices, returns only the first line number.
        Since:
        TotalCross 1.7 / 2.0
      • isOpenGL

        public static boolean isOpenGL
        Returns true if this is an open gl platform (IOS or Android).
        Since:
        TotalCross 1.68
      • optionalBackspaceKey

        public static int optionalBackspaceKey
        An optional value for the backspace key. Android 4.4.2 has a bug that prevents the backspace from working well; this bug is fixed in 4.4.3. The workaround is to define a unused key that will work as the backspace one. Defaults to the î key, used only if romVersion is 442.
      • optimizeScroll

        public static boolean optimizeScroll
        Set to false to disable the scroll optimization using images. This optimization greatly improves performance but uses more memory.
      • PALMOS

        public static java.lang.String PALMOS
        Dumb field to keep compilation compatibility with TC 1
      • BLACKBERRY

        public static java.lang.String BLACKBERRY
        Dumb field to keep compilation compatibility with TC 1
      • nvfsVolume

        public static int nvfsVolume
        Dumb field to keep compilation compatibility with TC 1
      • useNewFont

        public static boolean useNewFont
        Dumb field to keep compilation compatibility with TC 1
      • isMinimized

        public static boolean isMinimized
        Dumb field to keep compilation compatibility with TC 1
      • keypadOnly

        public static boolean keypadOnly
        Dumb field to keep compilation compatibility with TC 1
      • scrollDistanceOnMouseWheelMove

        public static int scrollDistanceOnMouseWheelMove
        Set to 0 to disable the automatic scroll of the ScrollContainer under the mouse position when the mouse wheel changes.
      • bugreportEmail

        public static java.lang.String bugreportEmail
        An email that will be used to send bug reports when an unhandled exception is caught on your application. Note that you may receive dozens of emails per day. The bug report is sent after an application crash if, and only if, the application is called within 3 minutes after the crash, otherwise, Android may roll out the logs. Note that we always receive a copy of the same message, even if you don't set this email, so we will be aware of the problems. The bug report takes from 5 to 20 seconds to be generated and sent from application's startup time, so if your application crashes too early, the report will halt the exit process until its effectively sent, and a black screen will appear in the meanwhile. You must set this in your application's static initializer, preferrably at the first line. E.G.:
         static
         {
            Settings.bugreportEmail = "bugreports@mycompany.com";
            ...
         }
         
        Currently this is supported only on Android.
        Since:
        TotalCross 3.1
      • bugreportUser

        public static java.lang.String bugreportUser
        Set this to the username of your application to be able to filter at the bug report service. IMPORTANT: this must be assigned by your application at the constructor of the application, or it will be ignored in the crash report, because this one is sent very early.
        Since:
        TotalCross 3.1
      • activationKey

        public static java.lang.String activationKey
        The activation key used during deploy
      • pushTokenAndroid

        @Deprecated
        public static java.lang.String pushTokenAndroid
        Deprecated.
        No longer used; put the 'google-services.json' so that the deploy will send it to the app, and it will
      • iosCertDate

        public static Time iosCertDate
        The due date of the iOS certificate. You can use it to inform your costumers when its time to update the software.
      • abortedOnLastRun

        public static boolean abortedOnLastRun
        Field set to true if the program have aborted on last run.
      • enableVirtualKeyboard

        public static boolean enableVirtualKeyboard
        Set to false to disable the virtual keyboard on all Edits and MultiEdits at once
        Since:
        TotalCross 4.0
      • showUIErrors

        public static boolean showUIErrors
        Set to false to disable UI positional errors that are shown in Java SE
      • ANDROID_ID

        public static final java.lang.String ANDROID_ID
        On Android it has the value of Settings.Secure.ANDROID_ID. Refer to the Android documentation for more details about this identifier: https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID
      • screenDensity

        public static double screenDensity
        The logical density of the display, used as a scaling factor for density independent pixels (dp) and scaleable pixels (sp). On WinCE based devices the screen density is set to 0.75 if the largest screen component (width or height) is smaller than 240 pixels. https://material.io/guidelines/layout/units-measurements.htm
      • minimalUpdateInterval

        public static final int minimalUpdateInterval
        Minimal interval between two Update events
        See Also:
        Constant Field Values
      • allowBackup

        public static boolean allowBackup
        Apps that target Android 6.0 (API level 23) or higher automatically participate in Auto Backup. Set this value to enable or disable backup. The default value is true but to make your intentions clear, we recommend explicitly setting the attribute. You can disable backups by setting allowBackup to false. You might want to do this if your app can recreate its state through some other mechanism or if your app deals with sensitive information that Android shouldn't back up.
    • Method Detail

      • appBuildNumber

        public static java.lang.String appBuildNumber()
        Returns the application's build number. You can make tc.Deploy use this automatically by making the appVersion end with a dot. For example:
         static
         {
            Settings.appVersion = "2.1."; // leading dot
         }
         // then at the application's constructor:
         Settings.appVersion += Settings.appBuildNumber();
         
        This way, when you run tc.Deploy, it will update the appVersion to include the build number in all platforms.
        Since:
        TotalCross 3.1
        See Also:
        appProps
      • isWindowsDevice

        public static boolean isWindowsDevice()
        Returns true if the current platform is Windows Mobile or Windows Phone. Note that Windows Desktop (aka WIN32) returns false.
      • isWindowsCE

        public static boolean isWindowsCE()
        Returns true if the current platform is Windows Mobile or Windows Phone. Note that Windows Desktop (aka WIN32) returns false.
      • isIOS

        public static boolean isIOS()
        Returns true if this is an iPad or an iPhone.
        Since:
        TotalCross 1.53
      • refresh

        public static void refresh()
        Refresh some fields thay may have been updated since the program started. The currently refreshed fields are:
        • daylightSavings
        • timeZone
        • timeZoneStr
        Also saves the appSettings properties, which otherwise is saved only at program's end.
        Since:
        TotalCross 1.15
      • isLandscape

        public static boolean isLandscape()
        Returns true if the device is currently in landscale (screenWidth > screenHeight).
      • getUniqueId

        public static java.lang.String getUniqueId()
        Returns an id from the mobile device (Android and iOS) that should be persistent on reinstall.
        • Android - Uses UUID with MediaDrm to generate an ID.
        • iOS - Retrieves value from UIDevice.identifierForVendor (https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor)
      • getAnimationMaximumFps

        public static int getAnimationMaximumFps()