Configuration

Default value for densityDpi indicating that no width has been specified.

Constant for hardKeyboardHidden , value corresponding to the physical keyboard being exposed.

Constant for hardKeyboardHidden : a value indicating that no value has been set.

Constant for hardKeyboardHidden , value corresponding to the physical keyboard being hidden.

Constant for keyboardHidden , value corresponding to the keysexposed resource qualifier.

Constant for keyboardHidden : a value indicating that no value has been set.

Constant for keyboardHidden , value corresponding to the keyshidden resource qualifier.

Constant for keyboard , value corresponding to the 12key resource qualifier.

Constant for keyboard , value corresponding to the nokeys resource qualifier.

Constant for keyboard , value corresponding to the qwerty resource qualifier.

Constant for keyboard : a value indicating that no value has been set.

Constant used to to represent MNC (Mobile Network Code) zero. 0 cannot be used, since it is used to represent an undefined MNC.

Constant for navigationHidden , value corresponding to the navexposed resource qualifier.

Constant for navigationHidden : a value indicating that no value has been set.

Constant for navigationHidden , value corresponding to the navhidden resource qualifier.

Constant for navigation , value corresponding to the dpad resource qualifier.

Constant for navigation , value corresponding to the nonav resource qualifier.

Constant for navigation , value corresponding to the trackball resource qualifier.

Constant for navigation : a value indicating that no value has been set.

Constant for navigation , value corresponding to the wheel resource qualifier.

Constant for orientation , value corresponding to the land resource qualifier.

Constant for orientation , value corresponding to the port resource qualifier.

Constant for orientation : a value indicating that no value has been set.

Constant for screenLayout : a SCREENLAYOUT_LAYOUTDIR_MASK value indicating that a layout dir has been set to LTR.

Constant for screenLayout : bits that encode the layout direction.

Constant for screenLayout : a SCREENLAYOUT_LAYOUTDIR_MASK value indicating that a layout dir has been set to RTL.

Constant for screenLayout : bits shift to get the layout direction.

Constant for screenLayout : a SCREENLAYOUT_LAYOUTDIR_MASK value indicating that no layout dir has been set.

Constant for screenLayout : bits that encode the aspect ratio.

Constant for screenLayout : a SCREENLAYOUT_LONG_MASK value that corresponds to the notlong resource qualifier.

Constant for screenLayout : a SCREENLAYOUT_LONG_MASK value indicating that no size has been set.

Constant for screenLayout : a SCREENLAYOUT_LONG_MASK value that corresponds to the long resource qualifier.

Constant for screenLayout : a SCREENLAYOUT_SIZE_MASK value indicating the screen is at least approximately 480x640 dp units, corresponds to the large resource qualifier. See Supporting Multiple Screens for more information.

Constant for screenLayout : bits that encode the size.

Constant for screenLayout : a SCREENLAYOUT_SIZE_MASK value indicating the screen is at least approximately 320x470 dp units, corresponds to the normal resource qualifier. See Supporting Multiple Screens for more information.

Constant for screenLayout : a SCREENLAYOUT_SIZE_MASK value indicating the screen is at least approximately 320x426 dp units, corresponds to the small resource qualifier. See Supporting Multiple Screens for more information.

Constant for screenLayout : a SCREENLAYOUT_SIZE_MASK value indicating that no size has been set.

Constant for screenLayout : a SCREENLAYOUT_SIZE_MASK value indicating the screen is at least approximately 720x960 dp units, corresponds to the xlarge resource qualifier. See Supporting Multiple Screens for more information.

Constant for screenLayout : a value indicating that screenLayout is undefined

Default value for screenHeightDp indicating that no width has been specified.

Default value for screenWidthDp indicating that no width has been specified.

Default value for smallestScreenWidthDp indicating that no width has been specified.

Constant for touchscreen , value corresponding to the finger resource qualifier.

Constant for touchscreen , value corresponding to the notouch resource qualifier.

Constant for touchscreen : a value indicating that no value has been set.

Constant for uiMode : bits that encode the night mode.

Constant for uiMode : a UI_MODE_NIGHT_MASK value that corresponds to the notnight resource qualifier.

Constant for uiMode : a UI_MODE_NIGHT_MASK value indicating that no mode type has been set.

Constant for uiMode : a UI_MODE_NIGHT_MASK value that corresponds to the night resource qualifier.

Constant for uiMode : a UI_MODE_TYPE_MASK value that corresponds to the appliance resource qualifier.

Constant for uiMode : a UI_MODE_TYPE_MASK value that corresponds to the car resource qualifier.

Constant for uiMode : a UI_MODE_TYPE_MASK value that corresponds to the desk resource qualifier.

Constant for uiMode : bits that encode the mode type.

Constant for uiMode : a UI_MODE_TYPE_MASK value that corresponds to no UI mode resource qualifier specified.

Constant for uiMode : a UI_MODE_TYPE_MASK value that corresponds to the television resource qualifier.

Constant for uiMode : a UI_MODE_TYPE_MASK value indicating that no mode type has been set.

Constant for uiMode : a UI_MODE_TYPE_MASK value that corresponds to the watch resource qualifier.

The target screen density being rendered to, corresponding to density resource qualifier. Set to DENSITY_DPI_UNDEFINED if no density is specified.

Current user preference for the scaling factor for fonts, relative to the base density scaling.

A flag indicating whether the hard keyboard has been hidden. This will be set on a device with a mechanism to hide the keyboard from the user, when that mechanism is closed. One of: HARDKEYBOARDHIDDEN_NO , HARDKEYBOARDHIDDEN_YES .

The kind of keyboard attached to the device. One of: KEYBOARD_NOKEYS , KEYBOARD_QWERTY , KEYBOARD_12KEY .

A flag indicating whether any keyboard is available. Unlike hardKeyboardHidden , this also takes into account a soft keyboard, so if the hard keyboard is hidden but there is soft keyboard available, it will be set to NO. Value is one of: KEYBOARDHIDDEN_NO , KEYBOARDHIDDEN_YES .

Current user preference for the locale, corresponding to locale resource qualifier.

IMSI MCC (Mobile Country Code), corresponding to mcc resource qualifier. 0 if undefined.

IMSI MNC (Mobile Network Code), corresponding to mnc resource qualifier. 0 if undefined. Note that the actual MNC may be 0; in order to check for this use the MNC_ZERO symbol.

The kind of navigation method available on the device. One of: NAVIGATION_NONAV , NAVIGATION_DPAD , NAVIGATION_TRACKBALL , NAVIGATION_WHEEL .

A flag indicating whether any 5-way or DPAD navigation available. This will be set on a device with a mechanism to hide the navigation controls from the user, when that mechanism is closed. One of: NAVIGATIONHIDDEN_NO , NAVIGATIONHIDDEN_YES .

Overall orientation of the screen. May be one of ORIENTATION_LANDSCAPE , ORIENTATION_PORTRAIT .

The current height of the available screen space, in dp units, corresponding to screen height resource qualifier. Set to SCREEN_HEIGHT_DP_UNDEFINED if no height is specified.

Bit mask of overall layout of the screen. Currently there are two fields:

The SCREENLAYOUT_SIZE_MASK bits define the overall size of the screen. They may be one of SCREENLAYOUT_SIZE_SMALL , SCREENLAYOUT_SIZE_NORMAL , SCREENLAYOUT_SIZE_LARGE , or SCREENLAYOUT_SIZE_XLARGE .

The SCREENLAYOUT_LONG_MASK defines whether the screen is wider/taller than normal. They may be one of SCREENLAYOUT_LONG_NO or SCREENLAYOUT_LONG_YES .

The SCREENLAYOUT_LAYOUTDIR_MASK defines whether the screen layout is either LTR or RTL. They may be one of SCREENLAYOUT_LAYOUTDIR_LTR or SCREENLAYOUT_LAYOUTDIR_RTL .

See Supporting Multiple Screens for more information.

The current width of the available screen space, in dp units, corresponding to screen width resource qualifier. Set to SCREEN_WIDTH_DP_UNDEFINED if no width is specified.

The smallest screen size an application will see in normal operation, corresponding to smallest screen width resource qualifier. This is the smallest value of both screenWidthDp and screenHeightDp in both portrait and landscape. Set to SMALLEST_SCREEN_WIDTH_DP_UNDEFINED if no width is specified.

The kind of touch screen attached to the device. One of: TOUCHSCREEN_NOTOUCH , TOUCHSCREEN_FINGER .

Bit mask of the ui mode. Currently there are two fields:

The UI_MODE_TYPE_MASK bits define the overall ui mode of the device. They may be one of UI_MODE_TYPE_UNDEFINED , UI_MODE_TYPE_NORMAL , UI_MODE_TYPE_DESK , UI_MODE_TYPE_CAR , UI_MODE_TYPE_TELEVISION , UI_MODE_TYPE_APPLIANCE , or UI_MODE_TYPE_WATCH .

The UI_MODE_NIGHT_MASK defines whether the screen is in a special mode. They may be one of UI_MODE_NIGHT_UNDEFINED , UI_MODE_NIGHT_NO or UI_MODE_NIGHT_YES .

Construct an invalid Configuration. You must call setToDefaults() for this object to be valid.

Makes a deep copy suitable for modification.

Parcelable methods

Return a bit mask of the differences between this Configuration object and the given one. Does not change the values of either. Any undefined fields in delta are ignored.

Compares this instance with the specified object and indicates if they are equal. In order to be equal, o must represent the same object as this instance using a class-specific comparison. The general contract is that this comparison should be reflexive, symmetric, and transitive. Also, no object reference other than null is equal to null.

The default implementation returns true only if this == o . See Writing a correct equals method if you intend implementing your own equals method.

The general contract for the equals and hashCode() methods is that if equals returns true for any two objects, then hashCode() must return the same value for these objects. This means that subclasses of Object usually override either both methods or neither of them.

Return the layout direction. Will be either LAYOUT_DIRECTION_LTR or LAYOUT_DIRECTION_RTL .

Returns an integer hash code for this object. By contract, any two objects for which equals(Object) returns true must return the same hash code value. This means that subclasses of Object usually override both methods or neither method.

Note that hash values must not change over time unless information used in equals comparisons also changes.

See Writing a correct hashCode method if you intend implementing your own hashCode method.

Check if the Configuration's current screenLayout is at least the given size.

Determine if a new resource needs to be loaded from the bit set of configuration changes returned by updateFrom(Configuration) .

Set the layout direction from the Locale.

Set the locale. This is the preferred way for setting up the locale (instead of using the direct accessor). This will also set the userLocale and layout direction according to the locale.

Set this object to the system defaults.

Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:

          getClass().getName() + '@' + Integer.toHexString(hashCode())
         

See Writing a useful toString method if you intend implementing your own toString method.

Copy the fields from delta into this Configuration object, keeping track of which ones have changed. Any undefined fields in delta are ignored and not copied in to the current Configuration.

Flatten this object in to a Parcel.