| package android.content.res; |
| |
| import android.content.pm.ActivityInfo; |
| import android.os.Parcel; |
| import android.os.Parcelable; |
| |
| import java.util.Locale; |
| |
| /** |
| * This class describes all device configuration information that can |
| * impact the resources the application retrieves. This includes both |
| * user-specified configuration options (locale and scaling) as well |
| * as dynamic device configuration (various types of input devices). |
| */ |
| public final class Configuration implements Parcelable, Comparable<Configuration> { |
| /** |
| * Current user preference for the scaling factor for fonts, relative |
| * to the base density scaling. |
| */ |
| public float fontScale; |
| |
| /** |
| * IMSI MCC (Mobile Country Code). 0 if undefined. |
| */ |
| public int mcc; |
| |
| /** |
| * IMSI MNC (Mobile Network Code). 0 if undefined. |
| */ |
| public int mnc; |
| |
| /** |
| * Current user preference for the locale. |
| */ |
| public Locale locale; |
| |
| public static final int TOUCHSCREEN_UNDEFINED = 0; |
| public static final int TOUCHSCREEN_NOTOUCH = 1; |
| public static final int TOUCHSCREEN_STYLUS = 2; |
| public static final int TOUCHSCREEN_FINGER = 3; |
| |
| /** |
| * The kind of touch screen attached to the device. |
| * One of: {@link #TOUCHSCREEN_NOTOUCH}, {@link #TOUCHSCREEN_STYLUS}, |
| * {@link #TOUCHSCREEN_FINGER}. |
| */ |
| public int touchscreen; |
| |
| public static final int KEYBOARD_UNDEFINED = 0; |
| public static final int KEYBOARD_NOKEYS = 1; |
| public static final int KEYBOARD_QWERTY = 2; |
| public static final int KEYBOARD_12KEY = 3; |
| |
| /** |
| * The kind of keyboard attached to the device. |
| * One of: {@link #KEYBOARD_QWERTY}, {@link #KEYBOARD_12KEY}. |
| */ |
| public int keyboard; |
| |
| public static final int KEYBOARDHIDDEN_UNDEFINED = 0; |
| public static final int KEYBOARDHIDDEN_NO = 1; |
| public static final int KEYBOARDHIDDEN_YES = 2; |
| |
| /** |
| * A flag indicating whether the 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. |
| */ |
| public int keyboardHidden; |
| |
| public static final int NAVIGATION_UNDEFINED = 0; |
| public static final int NAVIGATION_NONAV = 1; |
| public static final int NAVIGATION_DPAD = 2; |
| public static final int NAVIGATION_TRACKBALL = 3; |
| public static final int NAVIGATION_WHEEL = 4; |
| |
| /** |
| * The kind of navigation method available on the device. |
| * One of: {@link #NAVIGATION_DPAD}, {@link #NAVIGATION_TRACKBALL}, |
| * {@link #NAVIGATION_WHEEL}. |
| */ |
| public int navigation; |
| |
| public static final int ORIENTATION_UNDEFINED = 0; |
| public static final int ORIENTATION_PORTRAIT = 1; |
| public static final int ORIENTATION_LANDSCAPE = 2; |
| public static final int ORIENTATION_SQUARE = 3; |
| |
| /** |
| * Overall orientation of the screen. May be one of |
| * {@link #ORIENTATION_LANDSCAPE}, {@link #ORIENTATION_PORTRAIT}, |
| * or {@link #ORIENTATION_SQUARE}. |
| */ |
| public int orientation; |
| |
| /** |
| * Construct an invalid Configuration. You must call {@link #setToDefaults} |
| * for this object to be valid. {@more} |
| */ |
| public Configuration() { |
| setToDefaults(); |
| } |
| |
| /** |
| * Makes a deep copy suitable for modification. |
| */ |
| public Configuration(Configuration o) { |
| fontScale = o.fontScale; |
| mcc = o.mcc; |
| mnc = o.mnc; |
| if (o.locale != null) { |
| locale = (Locale) o.locale.clone(); |
| } |
| touchscreen = o.touchscreen; |
| keyboard = o.keyboard; |
| keyboardHidden = o.keyboardHidden; |
| navigation = o.navigation; |
| orientation = o.orientation; |
| } |
| |
| public String toString() { |
| return "{ scale=" + fontScale + " imsi=" + mcc + "/" + mnc |
| + " locale=" + locale |
| + " touch=" + touchscreen + " key=" + keyboard + "/" |
| + keyboardHidden |
| + " nav=" + navigation + " orien=" + orientation + " }"; |
| } |
| |
| /** |
| * Set this object to the system defaults. |
| */ |
| public void setToDefaults() { |
| fontScale = 1; |
| mcc = mnc = 0; |
| locale = Locale.getDefault(); |
| touchscreen = TOUCHSCREEN_UNDEFINED; |
| keyboard = KEYBOARD_UNDEFINED; |
| keyboardHidden = KEYBOARDHIDDEN_UNDEFINED; |
| navigation = NAVIGATION_UNDEFINED; |
| orientation = ORIENTATION_UNDEFINED; |
| } |
| |
| /** {@hide} */ |
| @Deprecated public void makeDefault() { |
| setToDefaults(); |
| } |
| |
| /** |
| * Copy the fields from delta into this Configuration object, keeping |
| * track of which ones have changed. Any undefined fields in |
| * <var>delta</var> are ignored and not copied in to the current |
| * Configuration. |
| * @return Returns a bit mask of the changed fields, as per |
| * {@link #diff}. |
| */ |
| public int updateFrom(Configuration delta) { |
| int changed = 0; |
| if (delta.fontScale > 0 && fontScale != delta.fontScale) { |
| changed |= ActivityInfo.CONFIG_FONT_SCALE; |
| fontScale = delta.fontScale; |
| } |
| if (delta.mcc != 0 && mcc != delta.mcc) { |
| changed |= ActivityInfo.CONFIG_MCC; |
| mcc = delta.mcc; |
| } |
| if (delta.mnc != 0 && mnc != delta.mnc) { |
| changed |= ActivityInfo.CONFIG_MNC; |
| mnc = delta.mnc; |
| } |
| if (delta.locale != null |
| && (locale == null || !locale.equals(delta.locale))) { |
| changed |= ActivityInfo.CONFIG_LOCALE; |
| locale = delta.locale != null |
| ? (Locale) delta.locale.clone() : null; |
| } |
| if (delta.touchscreen != TOUCHSCREEN_UNDEFINED |
| && touchscreen != delta.touchscreen) { |
| changed |= ActivityInfo.CONFIG_TOUCHSCREEN; |
| touchscreen = delta.touchscreen; |
| } |
| if (delta.keyboard != KEYBOARD_UNDEFINED |
| && keyboard != delta.keyboard) { |
| changed |= ActivityInfo.CONFIG_KEYBOARD; |
| keyboard = delta.keyboard; |
| } |
| if (delta.keyboardHidden != KEYBOARDHIDDEN_UNDEFINED |
| && keyboardHidden != delta.keyboardHidden) { |
| changed |= ActivityInfo.CONFIG_KEYBOARD_HIDDEN; |
| keyboardHidden = delta.keyboardHidden; |
| } |
| if (delta.navigation != NAVIGATION_UNDEFINED |
| && navigation != delta.navigation) { |
| changed |= ActivityInfo.CONFIG_NAVIGATION; |
| navigation = delta.navigation; |
| } |
| if (delta.orientation != ORIENTATION_UNDEFINED |
| && orientation != delta.orientation) { |
| changed |= ActivityInfo.CONFIG_ORIENTATION; |
| orientation = delta.orientation; |
| } |
| |
| return changed; |
| } |
| |
| /** |
| * 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 <var>delta</var> are ignored. |
| * @return Returns a bit mask indicating which configuration |
| * values has changed, containing any combination of |
| * {@link android.content.pm.ActivityInfo#CONFIG_FONT_SCALE |
| * PackageManager.ActivityInfo.CONFIG_FONT_SCALE}, |
| * {@link android.content.pm.ActivityInfo#CONFIG_MCC |
| * PackageManager.ActivityInfo.CONFIG_MCC}, |
| * {@link android.content.pm.ActivityInfo#CONFIG_MNC |
| * PackageManager.ActivityInfo.CONFIG_MNC}, |
| * {@link android.content.pm.ActivityInfo#CONFIG_LOCALE |
| * PackageManager.ActivityInfo.CONFIG_LOCALE}, |
| * {@link android.content.pm.ActivityInfo#CONFIG_TOUCHSCREEN |
| * PackageManager.ActivityInfo.CONFIG_TOUCHSCREEN}, |
| * {@link android.content.pm.ActivityInfo#CONFIG_KEYBOARD |
| * PackageManager.ActivityInfo.CONFIG_KEYBOARD}, |
| * {@link android.content.pm.ActivityInfo#CONFIG_NAVIGATION |
| * PackageManager.ActivityInfo.CONFIG_NAVIGATION}, or |
| * {@link android.content.pm.ActivityInfo#CONFIG_ORIENTATION |
| * PackageManager.ActivityInfo.CONFIG_ORIENTATION}. |
| */ |
| public int diff(Configuration delta) { |
| int changed = 0; |
| if (delta.fontScale > 0 && fontScale != delta.fontScale) { |
| changed |= ActivityInfo.CONFIG_FONT_SCALE; |
| } |
| if (delta.mcc != 0 && mcc != delta.mcc) { |
| changed |= ActivityInfo.CONFIG_MCC; |
| } |
| if (delta.mnc != 0 && mnc != delta.mnc) { |
| changed |= ActivityInfo.CONFIG_MNC; |
| } |
| if (delta.locale != null |
| && (locale == null || !locale.equals(delta.locale))) { |
| changed |= ActivityInfo.CONFIG_LOCALE; |
| } |
| if (delta.touchscreen != TOUCHSCREEN_UNDEFINED |
| && touchscreen != delta.touchscreen) { |
| changed |= ActivityInfo.CONFIG_TOUCHSCREEN; |
| } |
| if (delta.keyboard != KEYBOARD_UNDEFINED |
| && keyboard != delta.keyboard) { |
| changed |= ActivityInfo.CONFIG_KEYBOARD; |
| } |
| if (delta.keyboardHidden != KEYBOARDHIDDEN_UNDEFINED |
| && keyboardHidden != delta.keyboardHidden) { |
| changed |= ActivityInfo.CONFIG_KEYBOARD_HIDDEN; |
| } |
| if (delta.navigation != NAVIGATION_UNDEFINED |
| && navigation != delta.navigation) { |
| changed |= ActivityInfo.CONFIG_NAVIGATION; |
| } |
| if (delta.orientation != ORIENTATION_UNDEFINED |
| && orientation != delta.orientation) { |
| changed |= ActivityInfo.CONFIG_ORIENTATION; |
| } |
| |
| return changed; |
| } |
| |
| /** |
| * Determine if a new resource needs to be loaded from the bit set of |
| * configuration changes returned by {@link #updateFrom(Configuration)}. |
| * |
| * @param configChanges The mask of changes configurations as returned by |
| * {@link #updateFrom(Configuration)}. |
| * @param interestingChanges The configuration changes that the resource |
| * can handled, as given in {@link android.util.TypedValue#changingConfigurations}. |
| * |
| * @return Return true if the resource needs to be loaded, else false. |
| */ |
| public static boolean needNewResources(int configChanges, int interestingChanges) { |
| return (configChanges & (interestingChanges|ActivityInfo.CONFIG_FONT_SCALE)) != 0; |
| } |
| |
| /** |
| * Parcelable methods |
| */ |
| public int describeContents() { |
| return 0; |
| } |
| |
| public void writeToParcel(Parcel dest, int flags) { |
| dest.writeFloat(fontScale); |
| dest.writeInt(mcc); |
| dest.writeInt(mnc); |
| if (locale == null) { |
| dest.writeInt(0); |
| } else { |
| dest.writeInt(1); |
| dest.writeString(locale.getLanguage()); |
| dest.writeString(locale.getCountry()); |
| dest.writeString(locale.getVariant()); |
| } |
| dest.writeInt(touchscreen); |
| dest.writeInt(keyboard); |
| dest.writeInt(keyboardHidden); |
| dest.writeInt(navigation); |
| dest.writeInt(orientation); |
| } |
| |
| public static final Parcelable.Creator<Configuration> CREATOR |
| = new Parcelable.Creator<Configuration>() { |
| public Configuration createFromParcel(Parcel source) { |
| return new Configuration(source); |
| } |
| |
| public Configuration[] newArray(int size) { |
| return new Configuration[size]; |
| } |
| }; |
| |
| /** |
| * Construct this Configuration object, reading from the Parcel. |
| */ |
| private Configuration(Parcel source) { |
| fontScale = source.readFloat(); |
| mcc = source.readInt(); |
| mnc = source.readInt(); |
| if (source.readInt() != 0) { |
| locale = new Locale(source.readString(), source.readString(), |
| source.readString()); |
| } |
| touchscreen = source.readInt(); |
| keyboard = source.readInt(); |
| keyboardHidden = source.readInt(); |
| navigation = source.readInt(); |
| orientation = source.readInt(); |
| } |
| |
| public int compareTo(Configuration that) { |
| int n; |
| float a = this.fontScale; |
| float b = that.fontScale; |
| if (a < b) return -1; |
| if (a > b) return 1; |
| n = this.mcc - that.mcc; |
| if (n != 0) return n; |
| n = this.mnc - that.mnc; |
| if (n != 0) return n; |
| n = this.locale.getLanguage().compareTo(that.locale.getLanguage()); |
| if (n != 0) return n; |
| n = this.locale.getCountry().compareTo(that.locale.getCountry()); |
| if (n != 0) return n; |
| n = this.locale.getVariant().compareTo(that.locale.getVariant()); |
| if (n != 0) return n; |
| n = this.touchscreen - that.touchscreen; |
| if (n != 0) return n; |
| n = this.keyboard - that.keyboard; |
| if (n != 0) return n; |
| n = this.keyboardHidden - that.keyboardHidden; |
| if (n != 0) return n; |
| n = this.navigation - that.navigation; |
| if (n != 0) return n; |
| n = this.orientation - that.orientation; |
| //if (n != 0) return n; |
| return n; |
| } |
| |
| public boolean equals(Configuration that) { |
| if (that == null) return false; |
| if (that == this) return true; |
| return this.compareTo(that) == 0; |
| } |
| |
| public boolean equals(Object that) { |
| try { |
| return equals((Configuration)that); |
| } catch (ClassCastException e) { |
| } |
| return false; |
| } |
| |
| public int hashCode() { |
| return ((int)this.fontScale) + this.mcc + this.mnc |
| + this.locale.hashCode() + this.touchscreen |
| + this.keyboard + this.keyboardHidden + this.navigation |
| + this.orientation; |
| } |
| } |