CN (Codename One API)

java.lang.Object
- com.codename1.ui.CN1Constants
- - com.codename1.ui.CN

Direct Known Subclasses:

Font
```
public class CN
extends CN1Constants
```
This is a global context static class designed for static import, this class allows us to write more terse code. However, its chief purpose is simplification by hiding some of the more esoteric methods of these underlying classes and bringing to the front the commonly used important methods. This class includes code from Display, NetworkManager, Log and other important classes

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`BASELINE` Alignment to the baseline constraint
`static int`	`BOTTOM` Box-orientation constant used to specify the bottom of a box.
`static int`	`CENTER` Indicates a Component center alignment
`static int`	`CENTER_BEHAVIOR_CENTER` Defines the behavior of the component placed in the center position of the layout, places the component in the center of the space available to the center component.
`static int`	`CENTER_BEHAVIOR_CENTER_ABSOLUTE` Defines the behavior of the component placed in the center position of the layout, places the component in the center of the surrounding container
`static int`	`CENTER_BEHAVIOR_SCALE` Defines the behavior of the component placed in the center position of the layout, by default it is scaled to the available space
`static int`	`CENTER_BEHAVIOR_TOTAL_BELOW` The center component takes up the entire screens and the sides are automatically placed on top of it thus creating a layered effect
`static String`	`EAST` The east layout constraint (right of container).
`static int`	`FACE_MONOSPACE` Constant allowing us to author portable system fonts
`static int`	`FACE_PROPORTIONAL` Constant allowing us to author portable system fonts
`static int`	`FACE_SYSTEM` Constant allowing us to author portable system fonts
`static int`	`LEFT` Box-orientation constant used to specify the left side of a box.
`static String`	`NATIVE_ITALIC_BLACK` Constant for the italic black native font.
`static String`	`NATIVE_ITALIC_BOLD` Constant for the italic bold native font.
`static String`	`NATIVE_ITALIC_LIGHT` Constant for the italic light native font.
`static String`	`NATIVE_ITALIC_REGULAR` Constant for the italic regular native font.
`static String`	`NATIVE_ITALIC_THIN` Constant for the italic thin native font.
`static String`	`NATIVE_MAIN_BLACK` Constant for the main black native font.
`static String`	`NATIVE_MAIN_BOLD` Constant for the main bold native font.
`static String`	`NATIVE_MAIN_LIGHT` Constant for the main light native font.
`static String`	`NATIVE_MAIN_REGULAR` Constant for the main regular native font.
`static String`	`NATIVE_MAIN_THIN` Constant for the name of the main thin native font.
`static String`	`NORTH` The north layout constraint (top of container).
`static int`	`RIGHT` Box-orientation constant used to specify the right side of a box.
`static int`	`SIZE_LARGE` Constant allowing us to author portable system fonts
`static int`	`SIZE_MEDIUM` Constant allowing us to author portable system fonts
`static int`	`SIZE_SMALL` Constant allowing us to author portable system fonts
`static String`	`SOUTH` The south layout constraint (bottom of container).
`static int`	`STYLE_BOLD` Constant allowing us to author portable system fonts
`static int`	`STYLE_ITALIC` Constant allowing us to author portable system fonts
`static int`	`STYLE_PLAIN` Constant allowing us to author portable system fonts
`static int`	`STYLE_UNDERLINED` Constant allowing us to author portable system fonts
`static int`	`TOP` Box-orientation constant used to specify the top of a box.
`static String`	`WEST` The west layout constraint (left of container).

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static void`	`addDefaultHeader(String key, String value)` Adds a header to the global default headers, this header will be implicitly added to all requests going out from this point onwards.
`static void`	`addEdtErrorHandler(ActionListener e)` An error handler will receive an action event with the source exception from the EDT once an error handler is installed the default Codename One error dialog will no longer appear
`static void`	`addMessageListener(ActionListener<MessageEvent> l)` Adds a listener to receive messages from the native platform.
`static void`	`addNetworkErrorListener(ActionListener<NetworkEvent> e)` Adds a generic listener to a network error that is invoked before the exception is propagated.
`static void`	`addNetworkProgressListener(ActionListener<NetworkEvent> al)` Adds a listener to be notified when progress updates
`static void`	`addToQueue(ConnectionRequest request)` Adds the given network connection to the queue of execution
`static void`	`addToQueueAndWait(ConnectionRequest request)` Identical to add to queue but waits until the request is processed in the queue, this is useful for completely synchronous operations.
`static void`	`callSerially(Runnable r)` Causes the runnable to be invoked on the event dispatch thread.
`static void`	`callSeriallyAndWait(Runnable r)` Identical to callSerially with the added benefit of waiting for the Runnable method to complete.
`static void`	`callSeriallyAndWait(Runnable r, int timeout)` Identical to callSerially with the added benefit of waiting for the Runnable method to complete.
`static void`	`callSeriallyOnIdle(Runnable r)` Causes the runnable to be invoked on the event dispatch thread when the event dispatch thread is idle.
`static boolean`	`canDial()` Returns true if the device has dialing capabilities
`static Boolean`	`canExecute(String url)` Returns true if executing this URL should work, returns false if it will not and null if this is unknown.
`static boolean`	`canForceOrientation()` Returns true if the device allows forcing the orientation via code, feature phones do not allow this although some include a jad property allowing for this feature
`static boolean`	`canInstallOnHomescreen()` Checks to see if you can prompt the user to install the app on their homescreen.
`static Image`	`captureScreen()` Captures a screenshot of the screen.
`static void`	`clearStorage()` Deletes all the files in the application storage
`static void`	`clearStorageCache()` Storage is cached for faster access, however this might cause a problem with refreshing objects since they are not cloned.
`static int`	`convertToPixels(float dipCount)` Converts the dips count to pixels, dips are roughly 1mm in length.
`static int`	`convertToPixels(float value, byte unitType)` Converts from specified unit to pixels.
`static int`	`convertToPixels(float value, byte unitType, boolean horizontal)` Converts from specified unit to pixels.
`static int`	`convertToPixels(int dipCount, boolean horizontal)` Converts the dips count to pixels, dips are roughly 1mm in length.
`static Object`	`createSoftWeakRef(Object o)` Creates a soft/weak reference to an object that allows it to be collected yet caches it.
`static InputStream`	`createStorageInputStream(String name)` Creates an input stream to the given storage source file
`static OutputStream`	`createStorageOutputStream(String name)` Creates an output stream to the storage with the given name
`static Thread`	`createThread(Runnable r, String name)` Start a Codename One thread that supports crash protection and similar Codename One features.
`static void`	`delete(String file)` Deletes the specific file or empty directory.
`static void`	`deleteStorageFile(String name)` Deletes the given file name from the storage
`static void`	`deregisterPush()` Stop receiving push notifications to this client application
`static void`	`dial(String phoneNumber)` Opens the device Dialer application with the given phone number
`static void`	`execute(String url)` Executes the given URL on the native platform
`static boolean`	`existsInFileSystem(String file)` Indicates whether a file exists
`static boolean`	`existsInStorage(String name)` Returns true if the given storage file exists
`static void`	`exitApplication()` Exits the application...
`static boolean`	`exitFullScreen()` Try to exit full-screen mode if the platform supports it.
`static Object`	`extractHardRef(Object o)` Extracts the hard reference from the soft/weak reference given
`static void`	`flushStorageCache()` Flush the storage cache allowing implementations that cache storage objects to store
`static String`	`getAppHomePath()` The application home directory is a "safe place" to store files for this application in a portable way.
`static String`	`getCachesDir()` Returns a device specific directory designed for cache style files, or null if `hasCachesDir()` is false
`static Form`	`getCurrentForm()` Return the form currently displayed on the screen or null if no form is currently displayed.
`static int`	`getDeviceDensity()` Returns one of the density variables appropriate for this device, notice that density doesn't always correspond to resolution and an implementation might decide to change the density based on DPI constraints.
`static int`	`getDisplayHeight()` Return the height of the display
`static int`	`getDisplayWidth()` Return the width of the display
`static int`	`getDragStartPercentage()` This method allows us to manipulate the drag started detection logic.
`static long`	`getFileLastModifiedFile(String file)` Deprecated. this API requires additional privacy permissions on iOS and might cause problems with iOS submissions
`static long`	`getFileLength(String file)` Returns the length of the file
`static long`	`getFileSystemRootAvailableSpace(String root)` Returns the available space in the given root directory
`static String[]`	`getFileSystemRoots()` Returns the filesystem roots from which the structure of the file system can be traversed
`static long`	`getFileSystemRootSizeBytes(String root)` Returns the size of the given root directory
`static int`	`getFileSystemRootType(String root)` Returns the type of the root often by guessing
`static String`	`getPlatformName()` Returns a 2-3 letter code representing the platform name for the platform override
`static PluginSupport`	`getPluginSupport()` Returns the plugin support object for the current platform.
`static String`	`getProperty(String key, String defaultValue)` Returns the property from the underlying platform deployment or the default value if no deployment values are supported.
`static InputStream`	`getResourceAsStream(String resource)` This method is essentially equivalent to cls.getResourceAsStream(String) however some platforms might define unique ways in which to load resources within the implementation.
`static BrowserComponent`	`getSharedJavascriptContext()` Gets a reference to an application-wide shared Javascript context that can be used for running Javascript commands.
`static int`	`getSMSSupport()` Indicates the level of SMS support in the platform as one of: `CN1Constants.SMS_NOT_SUPPORTED` (for desktop, tablet etc.), `CN1Constants.SMS_SEAMLESS` (no UI interaction), `CN1Constants.SMS_INTERACTIVE` (with compose UI), `CN1Constants.SMS_BOTH`. The sample below demonstrates the use case for this property:
`static boolean`	`hasCachesDir()` Returns true if the device has a directory dedicated for "cache" files
`static boolean`	`hasCamera()` Returns true if the device has camera false otherwise.
`static void`	`invokeAndBlock(Runnable r)` Invokes runnable and blocks the current thread, if the current thread is the EDT it will still be blocked in a way that doesn't break event dispatch .
`static void`	`invokeWithoutBlocking(Runnable r)` Invokes a Runnable with blocking disabled.
`static <T> T`	`invokeWithoutBlockingWithResultSync(RunnableWithResultSync<T> r)` Invokes a RunnableWithResultSync with blocking disabled.
`static Boolean`	`isDarkMode()` Returns true if the platform is in dark mode, null is returned for unknown status
`static boolean`	`isDesktop()` Returns true if this is a desktop application
`static boolean`	`isDirectory(String file)` Indicates whether the given file is a directory
`static boolean`	`isEdt()` Returns true if we are currently in the event dispatch thread.
`static boolean`	`isEnableAsyncStackTraces()` Checks if async stack traces are enabled.
`static boolean`	`isFullScreenSupported()` Checks if this platform supports full-screen mode.
`static boolean`	`isHiddenFile(String file)` Indicates the hidden state of the file
`static boolean`	`isInFullScreenMode()` Checks if the app is currently running in full-screen mode.
`static boolean`	`isMinimized()` Indicates whether an application is minimized
`static boolean`	`isNativePickerTypeSupported(int pickerType)` Indicates whether the native picker dialog is supported for the given type which can include one of PICKER_TYPE_DATE_AND_TIME, PICKER_TYPE_TIME, PICKER_TYPE_DATE
`static boolean`	`isNativeShareSupported()` Indicates if the underlying platform supports sharing capabilities
`static boolean`	`isPortrait()` Returns true if the device is currently in portrait mode
`static boolean`	`isScreenSaverDisableSupported()` Checks if the device supports disabling the screen display from dimming, allowing the developer to keep the screen display on.
`static boolean`	`isSimulator()` Allows detecting development mode so debugging code and special cases can be used to simplify flow
`static boolean`	`isTablet()` Indicates whether the device is a tablet, notice that this is often a guess
`static void`	`killAndWait(ConnectionRequest request)` Kills the given request and waits until the request is killed if it is being processed by one of the threads.
`static String[]`	`listFiles(String directory)` Lists the files within the given directory, returns relative file names and not full file names.
`static String[]`	`listStorageEntries()` Lists the names of the storage files
`static void`	`lockOrientation(boolean portrait)` On devices that return true for canForceOrientation() this method can lock the device orientation either to portrait or landscape mode
`static void`	`log(String s)` Prints to the log
`static void`	`log(Throwable s)` Prints to the log
`static boolean`	`minimizeApplication()` Minimizes the current application if minimization is supported by the platform (may fail).
`static void`	`mkdir(String directory)` Creates the given directory
`static void`	`onCanInstallOnHomescreen(Runnable r)` A callback fired when you are allowed to prompt the user to install the app on their homescreen.
`static InputStream`	`openFileInputStream(String file)` Opens an input stream to the given file
`static OutputStream`	`openFileOutputStream(String file)` Opens an output stream to the given file
`static OutputStream`	`openFileOutputStream(String file, int offset)` Opens an output stream to the given file
`static void`	`openGallery(ActionListener response, int type)` Opens the device gallery to pick an image or a video. The method returns immediately and the response is sent asynchronously to the given ActionListener Object as the source value of the event (as a String)
`static void`	`postMessage(MessageEvent message)` Posts a message to the native platform.
`static boolean`	`promptInstallOnHomescreen()` Prompts the user to install this app on their homescreen.
`static Object`	`readObjectFromStorage(String name)` Reads the object from the storage, returns null if the object isn't there
`static void`	`registerPush()` Register to receive push notification, invoke this method once (ever) to receive push notifications.
`static void`	`removeEdtErrorHandler(ActionListener e)` An error handler will receive an action event with the source exception from the EDT once an error handler is installed the default Codename One error dialog will no longer appear
`static void`	`removeMessageListener(ActionListener<MessageEvent> l)` Removes a listener from receiving messages from the native platform.
`static void`	`removeNetworkErrorListener(ActionListener<NetworkEvent> e)` Removes the given error listener
`static void`	`removeNetworkProgressListener(ActionListener<NetworkEvent> al)` Adds a listener to be notified when progress updates
`static void`	`renameFile(String file, String newName)` Renames a file to the given name, expects the new name to be relative to the current directory
`static boolean`	`requestFullScreen()` Try to enter full-screen mode if the platform supports it.
`static void`	`restoreMinimizedApplication()` Restore the minimized application if minimization is supported by the platform
`static void`	`restoreToBookmark()` Runs the last bookmark that was set using `setBookmark(java.lang.Runnable)`
`static void`	`scheduleBackgroundTask(Runnable r)` Allows executing a background task in a separate low priority thread.
`static void`	`sendLog()` Sends the log to your email account
`static void`	`sendMessage(String subject, Message msg, String... recipients)` Send an email using the platform mail client. The code below demonstrates sending a simple message with attachments using the devices native email client:
`static void`	`sendSMS(String phoneNumber, String message)` Sends a SMS message to the given phone number
`static void`	`sendSMS(String phoneNumber, String message, boolean interactive)` Sends a SMS message to the given phone number, the code below demonstrates the logic of detecting platform behavior for sending SMS.
`static void`	`setBookmark(Runnable bookmark)` Sets a bookmark that can restore the app to a particular state.
`static void`	`setDarkMode(Boolean darkMode)` Override the default dark mode setting
`static void`	`setDragStartPercentage(int dragStartPercentage)` This method allows us to manipulate the drag started detection logic.
`static void`	`setEnableAsyncStackTraces(boolean enable)` Enables or disables async stack traces.
`static void`	`setHiddenFile(String file, boolean h)` Toggles the hidden state of the file
`static Timer`	`setInterval(int timeout, Runnable r)` Convenience method to schedule a task to run on the EDT after periodms repeating every periodms.
`static void`	`setProperty(String key, String value)` Sets a local property to the application, this method has no effect on the implementation code and only allows the user to override the logic of getProperty for internal application purposes.
`static void`	`setScreenSaverEnabled(boolean e)` If isScreenSaverDisableSupported() returns true calling this method will lock the screen display on
`static Timer`	`setTimeout(int timeout, Runnable r)` Convenience method to schedule a task to run on the EDT after timeoutms.
`static void`	`share(String text, String image, String mimeType)` Share the required information using the platform sharing services.
`static void`	`share(String text, String image, String mimeType, Rectangle sourceRect)` Share the required information using the platform sharing services.
`static Object`	`showNativePicker(int type, Component source, Object currentValue, Object data)` Shows a native modal dialog allowing us to perform the picking for the given type which can include one of PICKER_TYPE_DATE_AND_TIME, PICKER_TYPE_TIME, PICKER_TYPE_DATE
`static Thread`	`startThread(Runnable r, String name)` Deprecated. confusing name, use `createThread(java.lang.Runnable, java.lang.String)` instead
`static int`	`storageEntrySize(String name)` Returns the size in bytes of the given entry
`static void`	`unlockOrientation()` This is the reverse method for lock orientation allowing orientation lock to be disabled
`static void`	`updateNetworkThreadCount(int threadCount)` Sets the number of network threads and restarts the network threads
`static void`	`vibrate(int duration)` Vibrates the device for the given length of time, notice that this might ignore the time value completely on some OS's where this level of control isn't supported e.g.
`static boolean`	`writeObjectToStorage(String name, Object o)` Writes the given object to storage assuming it is an externalizable type or one of the supported types.

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - NATIVE_MAIN_THIN
```
public static final String NATIVE_MAIN_THIN
```
    Constant for the name of the main thin native font.
    
    See Also:
    
    Constant Field Values
  - NATIVE_MAIN_LIGHT
```
public static final String NATIVE_MAIN_LIGHT
```
    Constant for the main light native font.
    
    See Also:
    
    Constant Field Values
  - NATIVE_MAIN_REGULAR
```
public static final String NATIVE_MAIN_REGULAR
```
    Constant for the main regular native font.
    
    See Also:
    
    Constant Field Values
  - NATIVE_MAIN_BOLD
```
public static final String NATIVE_MAIN_BOLD
```
    Constant for the main bold native font.
    
    See Also:
    
    Constant Field Values
  - NATIVE_MAIN_BLACK
```
public static final String NATIVE_MAIN_BLACK
```
    Constant for the main black native font.
    
    See Also:
    
    Constant Field Values
  - NATIVE_ITALIC_THIN
```
public static final String NATIVE_ITALIC_THIN
```
    Constant for the italic thin native font.
    
    See Also:
    
    Constant Field Values
  - NATIVE_ITALIC_LIGHT
```
public static final String NATIVE_ITALIC_LIGHT
```
    Constant for the italic light native font.
    
    See Also:
    
    Constant Field Values
  - NATIVE_ITALIC_REGULAR
```
public static final String NATIVE_ITALIC_REGULAR
```
    Constant for the italic regular native font.
    
    See Also:
    
    Constant Field Values
  - NATIVE_ITALIC_BOLD
```
public static final String NATIVE_ITALIC_BOLD
```
    Constant for the italic bold native font.
    
    See Also:
    
    Constant Field Values
  - NATIVE_ITALIC_BLACK
```
public static final String NATIVE_ITALIC_BLACK
```
    Constant for the italic black native font.
    
    See Also:
    
    Constant Field Values
  - FACE_MONOSPACE
```
public static final int FACE_MONOSPACE
```
    Constant allowing us to author portable system fonts
    
    See Also:
    
    Constant Field Values
  - FACE_PROPORTIONAL
```
public static final int FACE_PROPORTIONAL
```
    Constant allowing us to author portable system fonts
    
    See Also:
    
    Constant Field Values
  - FACE_SYSTEM
```
public static final int FACE_SYSTEM
```
    Constant allowing us to author portable system fonts
    
    See Also:
    
    Constant Field Values
  - SIZE_LARGE
```
public static final int SIZE_LARGE
```
    Constant allowing us to author portable system fonts
    
    See Also:
    
    Constant Field Values
  - SIZE_MEDIUM
```
public static final int SIZE_MEDIUM
```
    Constant allowing us to author portable system fonts
    
    See Also:
    
    Constant Field Values
  - SIZE_SMALL
```
public static final int SIZE_SMALL
```
    Constant allowing us to author portable system fonts
    
    See Also:
    
    Constant Field Values
  - STYLE_BOLD
```
public static final int STYLE_BOLD
```
    Constant allowing us to author portable system fonts
    
    See Also:
    
    Constant Field Values
  - STYLE_ITALIC
```
public static final int STYLE_ITALIC
```
    Constant allowing us to author portable system fonts
    
    See Also:
    
    Constant Field Values
  - STYLE_UNDERLINED
```
public static final int STYLE_UNDERLINED
```
    Constant allowing us to author portable system fonts
    
    See Also:
    
    Constant Field Values
  - STYLE_PLAIN
```
public static final int STYLE_PLAIN
```
    Constant allowing us to author portable system fonts
    
    See Also:
    
    Constant Field Values
  - NORTH
```
public static final String NORTH
```
    The north layout constraint (top of container).
    
    See Also:
    
    Constant Field Values
  - SOUTH
```
public static final String SOUTH
```
    The south layout constraint (bottom of container).
    
    See Also:
    
    Constant Field Values
  - WEST
```
public static final String WEST
```
    The west layout constraint (left of container).
    
    See Also:
    
    Constant Field Values
  - EAST
```
public static final String EAST
```
    The east layout constraint (right of container).
    
    See Also:
    
    Constant Field Values
  - CENTER
```
public static final int CENTER
```
    Indicates a Component center alignment
    
    See Also:
    
    Constant Field Values
  - TOP
```
public static final int TOP
```
    Box-orientation constant used to specify the top of a box.
    
    See Also:
    
    Constant Field Values
  - LEFT
```
public static final int LEFT
```
    Box-orientation constant used to specify the left side of a box.
    
    See Also:
    
    Constant Field Values
  - BOTTOM
```
public static final int BOTTOM
```
    Box-orientation constant used to specify the bottom of a box.
    
    See Also:
    
    Constant Field Values
  - RIGHT
```
public static final int RIGHT
```
    Box-orientation constant used to specify the right side of a box.
    
    See Also:
    
    Constant Field Values
  - BASELINE
```
public static final int BASELINE
```
    Alignment to the baseline constraint
    
    See Also:
    
    Constant Field Values
  - CENTER_BEHAVIOR_SCALE
```
public static final int CENTER_BEHAVIOR_SCALE
```
    Defines the behavior of the component placed in the center position of the layout, by default it is scaled to the available space
    
    See Also:
    
    Constant Field Values
  - CENTER_BEHAVIOR_CENTER
```
public static final int CENTER_BEHAVIOR_CENTER
```
    Defines the behavior of the component placed in the center position of the layout, places the component in the center of the space available to the center component.
    
    See Also:
    
    Constant Field Values
  - CENTER_BEHAVIOR_CENTER_ABSOLUTE
```
public static final int CENTER_BEHAVIOR_CENTER_ABSOLUTE
```
    Defines the behavior of the component placed in the center position of the layout, places the component in the center of the surrounding container
    
    See Also:
    
    Constant Field Values
  - CENTER_BEHAVIOR_TOTAL_BELOW
```
public static final int CENTER_BEHAVIOR_TOTAL_BELOW
```
    The center component takes up the entire screens and the sides are automatically placed on top of it thus creating a layered effect
    
    See Also:
    
    Constant Field Values
- Method Detail
  - setBookmark
```
public static void setBookmark(Runnable bookmark)
```
    Sets a bookmark that can restore the app to a particular state. This takes a Runnable that will be run when restoreToBookmark() () } is called.
    The primary purpose of this feature is live code refresh.
    
    Parameters:
    
    bookmark - A Runnable that can be run to restore the app to a particular point.
    
    Since:
    
    8.0
  - restoreToBookmark
```
public static void restoreToBookmark()
```
    Runs the last bookmark that was set using setBookmark(java.lang.Runnable)
    
    Since:
    
    8.0
  - getDragStartPercentage
```
public static int getDragStartPercentage()
```
    This method allows us to manipulate the drag started detection logic. If the pointer was dragged for more than this percentage of the display size it is safe to assume that a drag is in progress.
    
    Returns:
    
    motion percentage
  - createSoftWeakRef
```
public static Object createSoftWeakRef(Object o)
```
    Creates a soft/weak reference to an object that allows it to be collected yet caches it. This method is in the porting layer since CLDC only includes weak references while some platforms include nothing at all and some include the superior soft references.
    
    Parameters:
    
    o - object to cache
    
    Returns:
    
    a caching object or null if caching isn't supported
  - extractHardRef
```
public static Object extractHardRef(Object o)
```
    Extracts the hard reference from the soft/weak reference given
    
    Parameters:
    
    o - the reference returned by createSoftWeakRef
    
    Returns:
    
    the original object submitted or null
  - isEnableAsyncStackTraces
```
public static boolean isEnableAsyncStackTraces()
```
    Checks if async stack traces are enabled. If enabled, the stack trace at the point of callSerially(java.lang.Runnable) calls will be recorded, and logged in the case that there is an uncaught exception.
    Currently this is only supported in the JavaSE/Simulator port.
    
    Returns:
    
    Whether async stack traces are enabled.
    
    Since:
    
    7.0
    
    See Also:
    
    setEnableAsyncStackTraces(boolean)
  - setEnableAsyncStackTraces
```
public static void setEnableAsyncStackTraces(boolean enable)
```
    Enables or disables async stack traces. If enabled, the stack trace at the point of callSerially(java.lang.Runnable) calls will be recorded, and logged in the case that there is an uncaught exception.
    Currently this is only supported in the JavaSE/Simulator port.
    
    Parameters:
    
    enable - True to enable async stack traces.
    
    Since:
    
    7.0
    
    See Also:
    
    isEnableAsyncStackTraces()
  - setDragStartPercentage
```
public static void setDragStartPercentage(int dragStartPercentage)
```
    This method allows us to manipulate the drag started detection logic. If the pointer was dragged for more than this percentage of the display size it is safe to assume that a drag is in progress.
    
    Parameters:
    
    dragStartPercentage - percentage of the screen required to initiate drag
  - vibrate
```
public static void vibrate(int duration)
```
    Vibrates the device for the given length of time, notice that this might ignore the time value completely on some OS's where this level of control isn't supported e.g. iOS see: https://github.com/codenameone/CodenameOne/issues/1904
    
    Parameters:
    
    duration - length of time to vibrate (might be ignored)
  - isEdt
```
public static boolean isEdt()
```
    Returns true if we are currently in the event dispatch thread. This is useful for generic code that can be used both with the EDT and outside of it.
    
    Returns:
    
    true if we are currently in the event dispatch thread; otherwise false
  - callSerially
```
public static void callSerially(Runnable r)
```
    Causes the runnable to be invoked on the event dispatch thread. This method returns immediately and will not wait for the serial call to occur
    
    Parameters:
    
    r - runnable (NOT A THREAD!) that will be invoked on the EDT serial to the paint and key handling events
  - callSeriallyOnIdle
```
public static void callSeriallyOnIdle(Runnable r)
```
    Causes the runnable to be invoked on the event dispatch thread when the event dispatch thread is idle. This method returns immediately and will not wait for the serial call to occur. Notice this method is identical to call serially but will perform the runnable only when the EDT is idle
    
    Parameters:
    
    r - runnable (NOT A THREAD!) that will be invoked on the EDT serial to the paint and key handling events
  - scheduleBackgroundTask
```
public static void scheduleBackgroundTask(Runnable r)
```
    Allows executing a background task in a separate low priority thread. Tasks are serialized so they don't overload the CPU.
    
    Parameters:
    
    r - the task to perform in the background
  - callSeriallyAndWait
```
public static void callSeriallyAndWait(Runnable r)
```
    Identical to callSerially with the added benefit of waiting for the Runnable method to complete.
    
    Parameters:
    
    r - runnable (NOT A THREAD!) that will be invoked on the EDT serial to the paint and key handling events
    
    Throws:
    
    IllegalStateException - if this method is invoked on the event dispatch thread (e.g. during paint or event handling).
  - callSeriallyAndWait
```
public static void callSeriallyAndWait(Runnable r,
                                       int timeout)
```
    Identical to callSerially with the added benefit of waiting for the Runnable method to complete.
    
    Parameters:
    
    r - runnable (NOT A THREAD!) that will be invoked on the EDT serial to the paint and key handling events
    
    timeout - timeout duration, on timeout the method just returns
    
    Throws:
    
    IllegalStateException - if this method is invoked on the event dispatch thread (e.g. during paint or event handling).
  - invokeAndBlock
```
public static void invokeAndBlock(Runnable r)
```
    Invokes runnable and blocks the current thread, if the current thread is the EDT it will still be blocked in a way that doesn't break event dispatch . Important: calling this method spawns a new thread that shouldn't access the UI!
    See this section in the developer guide for further information.
    
    Parameters:
    
    r - runnable (NOT A THREAD!) that will be invoked synchroniously by this method
  - invokeWithoutBlocking
```
public static void invokeWithoutBlocking(Runnable r)
```
    Invokes a Runnable with blocking disabled. If any attempt is made to block (i.e. call invokeAndBlock(java.lang.Runnable) from inside this Runnable, it will result in a BlockingDisallowedException being thrown.
    
    Parameters:
    
    r - Runnable to be run immediately.
    
    Throws:
    
    BlockingDisallowedException - If invokeAndBlock(java.lang.Runnable) is attempted anywhere in the Runnable.
    
    Since:
    
    7.0
  - invokeWithoutBlockingWithResultSync
```
public static <T> T invokeWithoutBlockingWithResultSync(RunnableWithResultSync<T> r)
```
    Invokes a RunnableWithResultSync with blocking disabled. If any attempt is made to block (i.e. call invokeAndBlock(java.lang.Runnable) from inside this Runnable, it will result in a BlockingDisallowedException being thrown.
    
    Parameters:
    
    r - Runnable to be run immediately.
    
    Throws:
    
    BlockingDisallowedException - If invokeAndBlock(java.lang.Runnable) is attempted anywhere in the Runnable.
    
    Since:
    
    7.0
  - minimizeApplication
```
public static boolean minimizeApplication()
```
    Minimizes the current application if minimization is supported by the platform (may fail). Returns false if minimization failed.
    
    Returns:
    
    false if minimization failed true if it succeeded or seems to be successful
  - isMinimized
```
public static boolean isMinimized()
```
    Indicates whether an application is minimized
    
    Returns:
    
    true if the application is minimized
  - restoreMinimizedApplication
```
public static void restoreMinimizedApplication()
```
    Restore the minimized application if minimization is supported by the platform
  - getCurrentForm
```
public static Form getCurrentForm()
```
    Return the form currently displayed on the screen or null if no form is currently displayed.
    
    Returns:
    
    the form currently displayed on the screen or null if no form is currently displayed
  - getDisplayWidth
```
public static int getDisplayWidth()
```
    Return the width of the display
    
    Returns:
    
    the width of the display
  - getDisplayHeight
```
public static int getDisplayHeight()
```
    Return the height of the display
    
    Returns:
    
    the height of the display
  - convertToPixels
```
public static int convertToPixels(int dipCount,
                                  boolean horizontal)
```
    Converts the dips count to pixels, dips are roughly 1mm in length. This is a very rough estimate and not to be relied upon
    
    Parameters:
    
    dipCount - the dips that we will convert to pixels
    
    horizontal - indicates pixels in the horizontal plane
    
    Returns:
    
    value in pixels
  - convertToPixels
```
public static int convertToPixels(float value,
                                  byte unitType,
                                  boolean horizontal)
```
    Converts from specified unit to pixels.
    
    Parameters:
    
    value - The value to convert, expressed in unitType.
    
    unitType - The unit type. One of Style.UNIT_TYPE_DIPS, Style.UNIT_TYPE_PIXELS, Style.UNIT_TYPE_REM, Style.UNIT_TYPE_SCREEN_PERCENTAGE, Style.UNIT_TYPE_VH, Style.UNIT_TYPE_VW, Style.UNIT_TYPE_VMIN, Style.UNIT_TYPE_VMAX
    
    horizontal - Whether screen percentage units should be based on horitonzal or vertical percentage.
    
    Returns:
    
    The value converted to pixels.
    
    Since:
    
    8.0
  - convertToPixels
```
public static int convertToPixels(float value,
                                  byte unitType)
```
    Converts from specified unit to pixels.
    
    Parameters:
    
    value - The value to convert, expressed in unitType.
    
    unitType - The unit type. One of Style.UNIT_TYPE_DIPS, Style.UNIT_TYPE_PIXELS, Style.UNIT_TYPE_REM, Style.UNIT_TYPE_SCREEN_PERCENTAGE, Style.UNIT_TYPE_VH, Style.UNIT_TYPE_VW, Style.UNIT_TYPE_VMIN, Style.UNIT_TYPE_VMAX
    
    Returns:
    
    The value converted to pixels.
    
    Since:
    
    8.0
  - convertToPixels
```
public static int convertToPixels(float dipCount)
```
    Converts the dips count to pixels, dips are roughly 1mm in length. This is a very rough estimate and not to be relied upon. This version of the method assumes square pixels which is pretty much the norm.
    
    Parameters:
    
    dipCount - the dips that we will convert to pixels
    
    Returns:
    
    value in pixels
  - getResourceAsStream
```
public static InputStream getResourceAsStream(String resource)
```
    This method is essentially equivalent to cls.getResourceAsStream(String) however some platforms might define unique ways in which to load resources within the implementation.
    
    Parameters:
    
    resource - relative/absolute URL based on the Java convention
    
    Returns:
    
    input stream for the resource or null if not found
  - addEdtErrorHandler
```
public static void addEdtErrorHandler(ActionListener e)
```
    An error handler will receive an action event with the source exception from the EDT once an error handler is installed the default Codename One error dialog will no longer appear
    
    Parameters:
    
    e - listener receiving the errors
  - removeEdtErrorHandler
```
public static void removeEdtErrorHandler(ActionListener e)
```
    An error handler will receive an action event with the source exception from the EDT once an error handler is installed the default Codename One error dialog will no longer appear
    
    Parameters:
    
    e - listener receiving the errors
  - exitApplication
```
public static void exitApplication()
```
    Exits the application...
  - getProperty
```
public static String getProperty(String key,
                                 String defaultValue)
```
    Returns the property from the underlying platform deployment or the default value if no deployment values are supported. This is equivalent to the getAppProperty from the jad file.
    The implementation should be responsible for the following keys to return reasonable valid values for the application:
    1. AppName
    2. User-Agent
    3. AppVersion
    4. Platform - Similar to microedition.platform
    5. OS - returns what is the underlying platform e.g. - iOS, Android, RIM, SE...
    6. OSVer - OS version when available as a user readable string (not necessarily a number e.g: 3.2.1).
    Parameters:
    
    key - the key of the property
    
    defaultValue - a default return value
    
    Returns:
    
    the value of the property
  - setProperty
```
public static void setProperty(String key,
                               String value)
```
    Sets a local property to the application, this method has no effect on the implementation code and only allows the user to override the logic of getProperty for internal application purposes.
    
    Parameters:
    
    key - key the key of the property
    
    value - the value of the property
  - canExecute
```
public static Boolean canExecute(String url)
```
    Returns true if executing this URL should work, returns false if it will not and null if this is unknown.
    
    Parameters:
    
    url - the url that would be executed
    
    Returns:
    
    true if executing this URL should work, returns false if it will not and null if this is unknown
  - execute
```
public static void execute(String url)
```
    Executes the given URL on the native platform
    
    Parameters:
    
    url - the url to execute
  - getDeviceDensity
```
public static int getDeviceDensity()
```
    Returns one of the density variables appropriate for this device, notice that density doesn't always correspond to resolution and an implementation might decide to change the density based on DPI constraints.
    
    Returns:
    
    one of the DENSITY constants of Display
  - isPortrait
```
public static boolean isPortrait()
```
    Returns true if the device is currently in portrait mode
    
    Returns:
    
    true if the device is in portrait mode
  - requestFullScreen
```
public static boolean requestFullScreen()
```
    Try to enter full-screen mode if the platform supports it.
    Currently only desktop and Javascript builds support full-screen mode; And Javascript only supports this on certain browsers. See the MDN Fullscreen API docs for a list of browsers that support full-screen.
    
    When running in the simulator, full-screen is only supported for the desktop skin.
    
    Returns:
    
    true on success. This will also return true if the app is already running in full-screen mode. It will return false if the app fails to enter full-screen mode.
    
    Since:
    
    6.0
    
    See Also:
    
    exitFullScreen(), isInFullScreenMode(), isFullScreenSupported()
  - exitFullScreen
```
public static boolean exitFullScreen()
```
    Try to exit full-screen mode if the platform supports it.
    Currently only desktop and Javascript builds support full-screen mode; And Javascript only supports this on certain browsers. See the MDN Fullscreen API docs for a list of browsers that support full-screen.
    
    When running in the simulator, full-screen is only supported for the desktop skin.
    
    Returns:
    
    true on success. This will also return true if the app is already NOT in full-screen mode. It will return false if the app fails to exit full-screen mode.
    
    Since:
    
    6.0
    
    See Also:
    
    requestFullScreen(), isInFullScreenMode(), isFullScreenSupported()
  - isInFullScreenMode
```
public static boolean isInFullScreenMode()
```
    Checks if the app is currently running in full-screen mode.
    
    Returns:
    
    true if the app is currently in full-screen mode.
    
    Since:
    
    6.0
    
    See Also:
    
    requestFullScreen(), exitFullScreen(), isFullScreenSupported()
  - isFullScreenSupported
```
public static boolean isFullScreenSupported()
```
    Checks if this platform supports full-screen mode. If full-screen mode is supported, you can use the requestFullScreen(), exitFullScreen(), and isInFullScreenMode() methods to enter and exit full-screen - and query the current state.
    Currently only desktop and Javascript builds support full-screen mode; And Javascript only supports this on certain browsers. See the MDN Fullscreen API docs for a list of browsers that support full-screen.
    
    When running in the simulator, full-screen is only supported for the desktop skin.
    
    Returns:
    
    true if Full-screen mode is supported on this platform.
    
    Since:
    
    6.0
    
    See Also:
    
    requestFullScreen(), exitFullScreen(), isInFullScreenMode()
  - canForceOrientation
```
public static boolean canForceOrientation()
```
    Returns true if the device allows forcing the orientation via code, feature phones do not allow this although some include a jad property allowing for this feature
    
    Returns:
    
    true if lockOrientation would work
  - lockOrientation
```
public static void lockOrientation(boolean portrait)
```
    On devices that return true for canForceOrientation() this method can lock the device orientation either to portrait or landscape mode
    
    Parameters:
    
    portrait - true to lock to portrait mode, false to lock to landscape mode
  - unlockOrientation
```
public static void unlockOrientation()
```
    This is the reverse method for lock orientation allowing orientation lock to be disabled
  - isTablet
```
public static boolean isTablet()
```
    Indicates whether the device is a tablet, notice that this is often a guess
    
    Returns:
    
    true if the device is assumed to be a tablet
  - isDesktop
```
public static boolean isDesktop()
```
    Returns true if this is a desktop application
    
    Returns:
    
    true if this is a desktop application
  - canDial
```
public static boolean canDial()
```
    Returns true if the device has dialing capabilities
    
    Returns:
    
    false if it cannot dial
  - isDarkMode
```
public static Boolean isDarkMode()
```
    Returns true if the platform is in dark mode, null is returned for unknown status
    
    Returns:
    
    true in case of dark mode
  - setDarkMode
```
public static void setDarkMode(Boolean darkMode)
```
    Override the default dark mode setting
    
    Parameters:
    
    darkMode - can be set to null to reset to platform default
  - openGallery
```
public static void openGallery(ActionListener response,
                               int type)
```
    Opens the device gallery to pick an image or a video.
    The method returns immediately and the response is sent asynchronously to the given ActionListener Object as the source value of the event (as a String)
    
    E.g. within the callback action performed call you can use this code: String path = (String) evt.getSource();.
    A more detailed sample of picking a video file can be seen here:
    
    Parameters:
    
    response - a callback Object to retrieve the file path
    
    type - one of the following CN1Constants.GALLERY_IMAGE, CN1Constants.GALLERY_VIDEO, CN1Constants.GALLERY_ALL
    
    Throws:
    
    RuntimeException - if this feature failed or unsupported on the platform
  - getPlatformName
```
public static String getPlatformName()
```
    Returns a 2-3 letter code representing the platform name for the platform override
    
    Returns:
    
    the name of the platform e.g. ios, rim, win, and, me, HTML5
  - dial
```
public static void dial(String phoneNumber)
```
    Opens the device Dialer application with the given phone number
    
    Parameters:
    
    phoneNumber -
  - getSMSSupport
```
public static int getSMSSupport()
```
    Indicates the level of SMS support in the platform as one of: CN1Constants.SMS_NOT_SUPPORTED (for desktop, tablet etc.), CN1Constants.SMS_SEAMLESS (no UI interaction), CN1Constants.SMS_INTERACTIVE (with compose UI), CN1Constants.SMS_BOTH.
    The sample below demonstrates the use case for this property:
    
    Returns:
    
    one of the SMS_* values
  - sendSMS
```
public static void sendSMS(String phoneNumber,
                           String message)
                    throws IOException
```
    Sends a SMS message to the given phone number
    
    Parameters:
    
    phoneNumber - to send the sms
    
    message - the content of the sms
    
    Throws:
    
    IOException
  - sendSMS
```
public static void sendSMS(String phoneNumber,
                           String message,
                           boolean interactive)
                    throws IOException
```
    Sends a SMS message to the given phone number, the code below demonstrates the logic of detecting platform behavior for sending SMS.
    
    Parameters:
    
    phoneNumber - to send the sms
    
    message - the content of the sms
    
    interactive - indicates the SMS should show a UI or should not show a UI if applicable see getSMSSupport
    
    Throws:
    
    IOException
    
    See Also:
    
    getSMSSupport()
  - share
```
public static void share(String text,
                         String image,
                         String mimeType)
```
    Share the required information using the platform sharing services. a Sharing service can be: mail, sms, facebook, twitter,... This method is implemented if isNativeShareSupported() returned true for a specific platform.
    Since 6.0, there is native sharing support in the Javascript port using the navigator.share API. Currently (2019) this is only supported on Chrome for Android, and will only work if the app is accessed over https:.
    
    Parameters:
    
    text - String to share.
    
    image - file path to the image or null
    
    mimeType - type of the image or null if no image to share
  - isNativeShareSupported
```
public static boolean isNativeShareSupported()
```
    Indicates if the underlying platform supports sharing capabilities
    Since 6.0, there is native sharing support in the Javascript port using the navigator.share API. Currently (2019) this is only supported on Chrome for Android, and will only work if the app is accessed over https:.
    
    Returns:
    
    true if the underlying platform handles share.
  - share
```
public static void share(String text,
                         String image,
                         String mimeType,
                         Rectangle sourceRect)
```
    Share the required information using the platform sharing services. a Sharing service can be: mail, sms, facebook, twitter,... This method is implemented if isNativeShareSupported() returned true for a specific platform.
    
    Parameters:
    
    text - String to share.
    
    image - file path to the image or null
    
    mimeType - type of the image or null if no image to share
    
    sourceRect - The source rectangle of the button that originated the share request. This is used on some platforms to provide a hint as to where the share dialog overlay should pop up. Particularly, on the iPad with iOS 8 and higher.
  - registerPush
```
public static void registerPush()
```
    Register to receive push notification, invoke this method once (ever) to receive push notifications.
  - deregisterPush
```
public static void deregisterPush()
```
    Stop receiving push notifications to this client application
  - createThread
```
public static Thread createThread(Runnable r,
                                  String name)
```
    Start a Codename One thread that supports crash protection and similar Codename One features.
    
    Parameters:
    
    r - runnable to run, NOTICE the thread MUST be explicitly started!
    
    name - the name for the thread
    
    Returns:
    
    a thread instance which must be explicitly started!
  - startThread
```
public static Thread startThread(Runnable r,
                                 String name)
```
    Deprecated. confusing name, use createThread(java.lang.Runnable, java.lang.String) instead
    
    Start a Codename One thread that supports crash protection and similar Codename One features.
    
    Parameters:
    
    r - runnable to run, NOTICE the thread MUST be explicitly started!
    
    name - the name for the thread
    
    Returns:
    
    a thread instance which must be explicitly started!
  - isScreenSaverDisableSupported
```
public static boolean isScreenSaverDisableSupported()
```
    Checks if the device supports disabling the screen display from dimming, allowing the developer to keep the screen display on.
  - setScreenSaverEnabled
```
public static void setScreenSaverEnabled(boolean e)
```
    If isScreenSaverDisableSupported() returns true calling this method will lock the screen display on
    
    Parameters:
    
    e - when set to true the screen saver will work as usual and when set to false the screen will not turn off automatically
  - hasCamera
```
public static boolean hasCamera()
```
    Returns true if the device has camera false otherwise.
  - isNativePickerTypeSupported
```
public static boolean isNativePickerTypeSupported(int pickerType)
```
    Indicates whether the native picker dialog is supported for the given type which can include one of PICKER_TYPE_DATE_AND_TIME, PICKER_TYPE_TIME, PICKER_TYPE_DATE
    
    Parameters:
    
    pickerType - the picker type constant
    
    Returns:
    
    true if the native platform supports this picker type
  - showNativePicker
```
public static Object showNativePicker(int type,
                                      Component source,
                                      Object currentValue,
                                      Object data)
```
    Shows a native modal dialog allowing us to perform the picking for the given type which can include one of PICKER_TYPE_DATE_AND_TIME, PICKER_TYPE_TIME, PICKER_TYPE_DATE
    
    Parameters:
    
    type - the picker type constant
    
    source - the source component (optional) the native dialog will be placed in relation to this component if applicable
    
    currentValue - the currently selected value
    
    data - additional meta data specific to the picker type when applicable
    
    Returns:
    
    the value from the picker or null if the operation was canceled.
  - log
```
public static void log(String s)
```
    Prints to the log
    
    Parameters:
    
    s - the string
  - log
```
public static void log(Throwable s)
```
    Prints to the log
    
    Parameters:
    
    s - the exception
  - sendLog
```
public static void sendLog()
```
    Sends the log to your email account
  - sendMessage
```
public static void sendMessage(String subject,
                               Message msg,
                               String... recipients)
```
    Send an email using the platform mail client.
    The code below demonstrates sending a simple message with attachments using the devices native email client:
    
    Parameters:
    
    subject - e-mail subject
    
    msg - the Message to send
    
    recipients - array of e-mail addresses
  - isSimulator
```
public static boolean isSimulator()
```
    Allows detecting development mode so debugging code and special cases can be used to simplify flow
    
    Returns:
    
    true if we are running in the simulator, false otherwise
  - addDefaultHeader
```
public static void addDefaultHeader(String key,
                                    String value)
```
    Adds a header to the global default headers, this header will be implicitly added to all requests going out from this point onwards. The main use case for this is for authentication information communication via the header.
    
    Parameters:
    
    key - the key of the header
    
    value - the value of the header
  - addToQueueAndWait
```
public static void addToQueueAndWait(ConnectionRequest request)
```
    Identical to add to queue but waits until the request is processed in the queue, this is useful for completely synchronous operations.
    
    Parameters:
    
    request - the request object to add
  - addToQueue
```
public static void addToQueue(ConnectionRequest request)
```
    Adds the given network connection to the queue of execution
    
    Parameters:
    
    request - network request for execution
  - killAndWait
```
public static void killAndWait(ConnectionRequest request)
```
    Kills the given request and waits until the request is killed if it is being processed by one of the threads. This method must not be invoked from a network thread!
    
    Parameters:
    
    request -
  - addNetworkErrorListener
```
public static void addNetworkErrorListener(ActionListener<NetworkEvent> e)
```
    Adds a generic listener to a network error that is invoked before the exception is propagated. Note that this handles also server error codes by default! You can change this default behavior setting to false ConnectionRequest.setHandleErrorCodesInGlobalErrorHandler(boolean). Consume the event in order to prevent it from propagating further.
    
    Parameters:
    
    e - callback will be invoked with the Exception as the source object
  - removeNetworkErrorListener
```
public static void removeNetworkErrorListener(ActionListener<NetworkEvent> e)
```
    Removes the given error listener
    
    Parameters:
    
    e - callback to remove
  - addNetworkProgressListener
```
public static void addNetworkProgressListener(ActionListener<NetworkEvent> al)
```
    Adds a listener to be notified when progress updates
    
    Parameters:
    
    al - action listener
  - removeNetworkProgressListener
```
public static void removeNetworkProgressListener(ActionListener<NetworkEvent> al)
```
    Adds a listener to be notified when progress updates
    
    Parameters:
    
    al - action listener
  - updateNetworkThreadCount
```
public static void updateNetworkThreadCount(int threadCount)
```
    Sets the number of network threads and restarts the network threads
    
    Parameters:
    
    threadCount - the new number of threads
  - clearStorageCache
```
public static void clearStorageCache()
```
    Storage is cached for faster access, however this might cause a problem with refreshing objects since they are not cloned. Clearing the cache allows to actually reload from the storage file.
  - flushStorageCache
```
public static void flushStorageCache()
```
    Flush the storage cache allowing implementations that cache storage objects to store
  - deleteStorageFile
```
public static void deleteStorageFile(String name)
```
    Deletes the given file name from the storage
    
    Parameters:
    
    name - the name of the storage file
  - clearStorage
```
public static void clearStorage()
```
    Deletes all the files in the application storage
  - createStorageOutputStream
```
public static OutputStream createStorageOutputStream(String name)
                                              throws IOException
```
    Creates an output stream to the storage with the given name
    
    Parameters:
    
    name - the storage file name
    
    Returns:
    
    an output stream of limited capacity
    
    Throws:
    
    IOException
  - createStorageInputStream
```
public static InputStream createStorageInputStream(String name)
                                            throws IOException
```
    Creates an input stream to the given storage source file
    
    Parameters:
    
    name - the name of the source file
    
    Returns:
    
    the input stream
    
    Throws:
    
    IOException
  - existsInStorage
```
public static boolean existsInStorage(String name)
```
    Returns true if the given storage file exists
    
    Parameters:
    
    name - the storage file name
    
    Returns:
    
    true if it exists
  - listStorageEntries
```
public static String[] listStorageEntries()
```
    Lists the names of the storage files
    
    Returns:
    
    the names of all the storage files
  - storageEntrySize
```
public static int storageEntrySize(String name)
```
    Returns the size in bytes of the given entry
    
    Parameters:
    
    name - the name of the entry
    
    Returns:
    
    the size in bytes
  - writeObjectToStorage
```
public static boolean writeObjectToStorage(String name,
                                           Object o)
```
    Writes the given object to storage assuming it is an externalizable type or one of the supported types.
    
    The sample below demonstrates the usage and registration of the Externalizable interface:
    
    Parameters:
    
    name - store name
    
    o - object to store
    
    Returns:
    
    true for success, false for failure
  - readObjectFromStorage
```
public static Object readObjectFromStorage(String name)
```
    Reads the object from the storage, returns null if the object isn't there
    
    The sample below demonstrates the usage and registration of the Externalizable interface:
    
    Parameters:
    
    name - name of the store
    
    Returns:
    
    object stored under that name
  - getFileSystemRoots
```
public static String[] getFileSystemRoots()
```
    Returns the filesystem roots from which the structure of the file system can be traversed
    
    Returns:
    
    the roots of the filesystem
  - getFileSystemRootType
```
public static int getFileSystemRootType(String root)
```
    Returns the type of the root often by guessing
    
    Parameters:
    
    root - the root whose type we are checking
    
    Returns:
    
    one of the type constants above
  - listFiles
```
public static String[] listFiles(String directory)
                          throws IOException
```
    Lists the files within the given directory, returns relative file names and not full file names.
    
    Parameters:
    
    directory - the directory in which files should be listed
    
    Returns:
    
    array of file names
    
    Throws:
    
    IOException
  - getFileSystemRootSizeBytes
```
public static long getFileSystemRootSizeBytes(String root)
```
    Returns the size of the given root directory
    
    Parameters:
    
    root - the root directory in the filesystem
    
    Returns:
    
    the byte size of the directory
  - getFileSystemRootAvailableSpace
```
public static long getFileSystemRootAvailableSpace(String root)
```
    Returns the available space in the given root directory
    
    Parameters:
    
    root - the root directory in the filesystem
    
    Returns:
    
    the bytes available in the directory
  - mkdir
```
public static void mkdir(String directory)
```
    Creates the given directory
    
    Parameters:
    
    directory - the directory name to create
  - delete
```
public static void delete(String file)
```
    Deletes the specific file or empty directory.
    
    Parameters:
    
    file - file or empty directory to delete
  - existsInFileSystem
```
public static boolean existsInFileSystem(String file)
```
    Indicates whether a file exists
    
    Parameters:
    
    file - the file to check
    
    Returns:
    
    true if the file exists and false otherwise
  - isHiddenFile
```
public static boolean isHiddenFile(String file)
```
    Indicates the hidden state of the file
    
    Parameters:
    
    file - file
    
    Returns:
    
    true for a hidden file
  - setHiddenFile
```
public static void setHiddenFile(String file,
                                 boolean h)
```
    Toggles the hidden state of the file
    
    Parameters:
    
    file - file
    
    h - hidden state
  - renameFile
```
public static void renameFile(String file,
                              String newName)
```
    Renames a file to the given name, expects the new name to be relative to the current directory
    
    Parameters:
    
    file - absolute file name
    
    newName - relative new name
  - getFileLength
```
public static long getFileLength(String file)
```
    Returns the length of the file
    
    Parameters:
    
    file - file
    
    Returns:
    
    length of said file
  - getFileLastModifiedFile
```
public static long getFileLastModifiedFile(String file)
```
    Deprecated. this API requires additional privacy permissions on iOS and might cause problems with iOS submissions
    
    Returns the time that the file denoted by this abstract pathname was last modified.
    
    Returns:
    
    A long value representing the time the file was last modified, measured in milliseconds
  - isDirectory
```
public static boolean isDirectory(String file)
```
    Indicates whether the given file is a directory
    
    Parameters:
    
    file - file
    
    Returns:
    
    true if its a directory
  - openFileOutputStream
```
public static OutputStream openFileOutputStream(String file)
                                         throws IOException
```
    Opens an output stream to the given file
    
    Parameters:
    
    file - the file
    
    Returns:
    
    the output stream
    
    Throws:
    
    IOException
  - openFileInputStream
```
public static InputStream openFileInputStream(String file)
                                       throws IOException
```
    Opens an input stream to the given file
    
    Parameters:
    
    file - the file
    
    Returns:
    
    the input stream
    
    Throws:
    
    IOException
  - openFileOutputStream
```
public static OutputStream openFileOutputStream(String file,
                                                int offset)
                                         throws IOException
```
    Opens an output stream to the given file
    
    Parameters:
    
    file - the file
    
    offset - position in the file
    
    Returns:
    
    the output stream
    
    Throws:
    
    IOException
  - getAppHomePath
```
public static String getAppHomePath()
```
    The application home directory is a "safe place" to store files for this application in a portable way. On some platforms such as Android & iOS this path may be visible only to the application itself, other apps won't have permission to access this path.
    The sample below uses the app home directory to save a file so we can share it using the ShareButton:
    
    Returns:
    
    a writable directory that represent the application home directory
  - hasCachesDir
```
public static boolean hasCachesDir()
```
    Returns true if the device has a directory dedicated for "cache" files
    
    Returns:
    
    true if a caches style directory exists in this device type
  - getCachesDir
```
public static String getCachesDir()
```
    Returns a device specific directory designed for cache style files, or null if hasCachesDir() is false
    
    Returns:
    
    file URL or null
  - canInstallOnHomescreen
```
public static boolean canInstallOnHomescreen()
```
    Checks to see if you can prompt the user to install the app on their homescreen. This is only relevant for the Javascript port with PWAs. This is not a "static" property, as it only returns true if the app is in a state that allows you to prompt the user. E.g. if you have previously prompted the user and they have declined, then this will return false.
    Best practice is to use onCanInstallOnHomescreen(java.lang.Runnable) to be notified when you are allowed to prompt the user for installation. Then call promptInstallOnHomescreen() inside that method - or sometime after.
    
    Example
```
 
 onCanInstallOnHomescreen(()->{
      if (canInstallOnHomescreen()) {
           if (promptInstallOnHomescreen()) {
               // User accepted installation
           } else {
               // user rejected installation
           }
      }
 });
 
```
    https://developers.google.com/web/fundamentals/app-install-banners/
    Returns:
    
    True if you are able to prompt the user to install the app on their homescreen.
    
    Since:
    
    6.0
    
    See Also:
    
    promptInstallOnHomescreen(), onCanInstallOnHomescreen(java.lang.Runnable)
  - promptInstallOnHomescreen
```
public static boolean promptInstallOnHomescreen()
```
    Prompts the user to install this app on their homescreen. This is only relevant in the javascript port.
    
    Returns:
    
    The result of the user prompt. true if the user accepts the installation, false if they reject it.
    
    Since:
    
    6.0
    
    See Also:
    
    canInstallOnHomescreen(), onCanInstallOnHomescreen(java.lang.Runnable)
  - onCanInstallOnHomescreen
```
public static void onCanInstallOnHomescreen(Runnable r)
```
    A callback fired when you are allowed to prompt the user to install the app on their homescreen. Only relevant in the javascript port.
    
    Parameters:
    
    r - Runnable that will be run when/if you are permitted to prompt the user to install the app on their homescreen.
    
    Since:
    
    6.0
  - captureScreen
```
public static Image captureScreen()
```
    Captures a screenshot of the screen.
    
    Returns:
    
    An image of the screen, or null if it fails.
    
    Since:
    
    7.0
  - addMessageListener
```
public static void addMessageListener(ActionListener<MessageEvent> l)
```
    Adds a listener to receive messages from the native platform. This is a mechanism to communicate between the app and the native platform. Currently the Javascript port is the only port to use this mechanism.
    In the Javascript port, javascript can send messages to the CN1 app by calling window.dispatchEvent(new CustomEvent('cn1inbox', {detail:'The message', code: SOMEINTEGER}));
    
    Parameters:
    
    l - The listener.
    
    Since:
    
    7.0
  - removeMessageListener
```
public static void removeMessageListener(ActionListener<MessageEvent> l)
```
    Removes a listener from receiving messages from the native platform. This is a mechanism to communicate between the app and the native platform. Currently the Javascript port is the only port to use this mechanism.
    
    Parameters:
    
    l - The listener.
    
    Since:
    
    7.0
  - postMessage
```
public static void postMessage(MessageEvent message)
```
    Posts a message to the native platform. This is a mechanism to communicate between the app and the native platform. Currently the Javascript port is the only port to use this mechanism.
    In the Javascript port these messages can be received in Javascript by adding an event listener for 'cn1outbox' events to the 'window' object. The message is contained in the event data "detail" key. And the code in the 'code' key.
    
    Parameters:
    
    message - The message to send to the native platform.
    
    Since:
    
    7.0
  - setTimeout
```
public static Timer setTimeout(int timeout,
                               Runnable r)
```
    Convenience method to schedule a task to run on the EDT after timeoutms.
    
    Parameters:
    
    timeout - The timeout in milliseconds.
    
    r - The task to run.
    
    Returns:
    
    The Timer object that can be used to cancel the task.
    
    Since:
    
    7.0
    
    See Also:
    
    setInterval(int, java.lang.Runnable)
  - setInterval
```
public static Timer setInterval(int timeout,
                                Runnable r)
```
    Convenience method to schedule a task to run on the EDT after periodms repeating every periodms.
    
    Parameters:
    
    timeout - The delay and repeat in milliseconds.
    
    r - The runnable to run on the EDT.
    
    Returns:
    
    The timer object which can be used to cancel the task.
    
    Since:
    
    7.0
    
    See Also:
    
    setTimeout(int, java.lang.Runnable)
  - getSharedJavascriptContext
```
public static BrowserComponent getSharedJavascriptContext()
```
    Gets a reference to an application-wide shared Javascript context that can be used for running Javascript commands. When running in the Javascript port, this Javascript context will be the same context in which the application itself is running, so it gives you the ability to interact with the browser and DOM directly using the familiar BrowserComponent API.
    When running on other platforms, this shared context will be an off-screen browser component.
    
    Sample code allowing user to execute arbitrary Javascript code inside the shared context:
    
    Returns:
    
    A shared BrowserComponent
    
    Since:
    
    7.0
  - getPluginSupport
```
public static PluginSupport getPluginSupport()
```
    Returns the plugin support object for the current platform. Use this object for registering plugins.
    
    Returns:
    
    The plugin support object.
    
    Since:
    
    8.0

Class CN

Field Summary

Fields inherited from class com.codename1.ui.CN1Constants

Method Summary

Methods inherited from class java.lang.Object

Field Detail

NATIVE_MAIN_THIN

NATIVE_MAIN_LIGHT

NATIVE_MAIN_REGULAR

NATIVE_MAIN_BOLD

NATIVE_MAIN_BLACK

NATIVE_ITALIC_THIN

NATIVE_ITALIC_LIGHT

NATIVE_ITALIC_REGULAR

NATIVE_ITALIC_BOLD

NATIVE_ITALIC_BLACK

FACE_MONOSPACE

FACE_PROPORTIONAL

FACE_SYSTEM

SIZE_LARGE

SIZE_MEDIUM

SIZE_SMALL

STYLE_BOLD

STYLE_ITALIC

STYLE_UNDERLINED

STYLE_PLAIN

NORTH

SOUTH

WEST

EAST

CENTER

TOP

LEFT

BOTTOM

RIGHT

BASELINE

CENTER_BEHAVIOR_SCALE

CENTER_BEHAVIOR_CENTER

CENTER_BEHAVIOR_CENTER_ABSOLUTE

CENTER_BEHAVIOR_TOTAL_BELOW

Method Detail

setBookmark

restoreToBookmark

getDragStartPercentage

createSoftWeakRef

extractHardRef

isEnableAsyncStackTraces

setEnableAsyncStackTraces

setDragStartPercentage

vibrate

isEdt

callSerially

callSeriallyOnIdle

scheduleBackgroundTask

callSeriallyAndWait

callSeriallyAndWait

invokeAndBlock

invokeWithoutBlocking

invokeWithoutBlockingWithResultSync

minimizeApplication

isMinimized

restoreMinimizedApplication

getCurrentForm

getDisplayWidth

getDisplayHeight

convertToPixels

convertToPixels

convertToPixels

convertToPixels

getResourceAsStream

addEdtErrorHandler

removeEdtErrorHandler

exitApplication

getProperty

setProperty

canExecute

execute

getDeviceDensity

isPortrait

requestFullScreen