Files | |
| file | configuration.h |
Typedefs | |
| typedef struct AConfiguration | AConfiguration |
| typedef struct AConfiguration AConfiguration |
AConfiguration is an opaque type used to get and set various subsystem configurations.
A AConfiguration pointer can be obtained using:
| anonymous enum |
Define flags and constants for various subsystem configurations.
| Enumerator | |
|---|---|
| ACONFIGURATION_ORIENTATION_ANY |
Orientation: not specified. |
| ACONFIGURATION_ORIENTATION_PORT |
Orientation: value corresponding to the port resource qualifier. |
| ACONFIGURATION_ORIENTATION_LAND |
Orientation: value corresponding to the land resource qualifier. |
| ACONFIGURATION_ORIENTATION_SQUARE |
|
| ACONFIGURATION_TOUCHSCREEN_ANY |
Touchscreen: not specified. |
| ACONFIGURATION_TOUCHSCREEN_NOTOUCH |
Touchscreen: value corresponding to the notouch resource qualifier. |
| ACONFIGURATION_TOUCHSCREEN_STYLUS |
|
| ACONFIGURATION_TOUCHSCREEN_FINGER |
Touchscreen: value corresponding to the finger resource qualifier. |
| ACONFIGURATION_DENSITY_DEFAULT |
Density: default density. |
| ACONFIGURATION_DENSITY_LOW |
Density: value corresponding to the ldpi resource qualifier. |
| ACONFIGURATION_DENSITY_MEDIUM |
Density: value corresponding to the mdpi resource qualifier. |
| ACONFIGURATION_DENSITY_TV |
Density: value corresponding to the tvdpi resource qualifier. |
| ACONFIGURATION_DENSITY_HIGH |
Density: value corresponding to the hdpi resource qualifier. |
| ACONFIGURATION_DENSITY_XHIGH |
Density: value corresponding to the xhdpi resource qualifier. |
| ACONFIGURATION_DENSITY_XXHIGH |
Density: value corresponding to the xxhdpi resource qualifier. |
| ACONFIGURATION_DENSITY_XXXHIGH |
Density: value corresponding to the xxxhdpi resource qualifier. |
| ACONFIGURATION_DENSITY_ANY |
Density: any density. |
| ACONFIGURATION_DENSITY_NONE |
Density: no density specified. |
| ACONFIGURATION_KEYBOARD_ANY |
Keyboard: not specified. |
| ACONFIGURATION_KEYBOARD_NOKEYS |
Keyboard: value corresponding to the nokeys resource qualifier. |
| ACONFIGURATION_KEYBOARD_QWERTY |
Keyboard: value corresponding to the qwerty resource qualifier. |
| ACONFIGURATION_KEYBOARD_12KEY |
Keyboard: value corresponding to the 12key resource qualifier. |
| ACONFIGURATION_NAVIGATION_ANY |
Navigation: not specified. |
| ACONFIGURATION_NAVIGATION_NONAV |
Navigation: value corresponding to the nonav resource qualifier. |
| ACONFIGURATION_NAVIGATION_DPAD |
Navigation: value corresponding to the dpad resource qualifier. |
| ACONFIGURATION_NAVIGATION_TRACKBALL |
Navigation: value corresponding to the trackball resource qualifier. |
| ACONFIGURATION_NAVIGATION_WHEEL |
Navigation: value corresponding to the wheel resource qualifier. |
| ACONFIGURATION_KEYSHIDDEN_ANY |
Keyboard availability: not specified. |
| ACONFIGURATION_KEYSHIDDEN_NO |
Keyboard availability: value corresponding to the keysexposed resource qualifier. |
| ACONFIGURATION_KEYSHIDDEN_YES |
Keyboard availability: value corresponding to the keyshidden resource qualifier. |
| ACONFIGURATION_KEYSHIDDEN_SOFT |
Keyboard availability: value corresponding to the keyssoft resource qualifier. |
| ACONFIGURATION_NAVHIDDEN_ANY |
Navigation availability: not specified. |
| ACONFIGURATION_NAVHIDDEN_NO |
Navigation availability: value corresponding to the navexposed resource qualifier. |
| ACONFIGURATION_NAVHIDDEN_YES |
Navigation availability: value corresponding to the navhidden resource qualifier. |
| ACONFIGURATION_SCREENSIZE_ANY |
Screen size: not specified. |
| ACONFIGURATION_SCREENSIZE_SMALL |
Screen size: value indicating the screen is at least approximately 320x426 dp units, corresponding to the small resource qualifier. |
| ACONFIGURATION_SCREENSIZE_NORMAL |
Screen size: value indicating the screen is at least approximately 320x470 dp units, corresponding to the normal resource qualifier. |
| ACONFIGURATION_SCREENSIZE_LARGE |
Screen size: value indicating the screen is at least approximately 480x640 dp units, corresponding to the large resource qualifier. |
| ACONFIGURATION_SCREENSIZE_XLARGE |
Screen size: value indicating the screen is at least approximately 720x960 dp units, corresponding to the xlarge resource qualifier. |
| ACONFIGURATION_SCREENLONG_ANY |
Screen layout: not specified. |
| ACONFIGURATION_SCREENLONG_NO |
Screen layout: value that corresponds to the notlong resource qualifier. |
| ACONFIGURATION_SCREENLONG_YES |
Screen layout: value that corresponds to the long resource qualifier. |
| ACONFIGURATION_UI_MODE_TYPE_ANY |
UI mode: not specified. |
| ACONFIGURATION_UI_MODE_TYPE_NORMAL |
UI mode: value that corresponds to no UI mode type resource qualifier specified. |
| ACONFIGURATION_UI_MODE_TYPE_DESK |
UI mode: value that corresponds to desk resource qualifier specified. |
| ACONFIGURATION_UI_MODE_TYPE_CAR |
UI mode: value that corresponds to car resource qualifier specified. |
| ACONFIGURATION_UI_MODE_TYPE_TELEVISION |
UI mode: value that corresponds to television resource qualifier specified. |
| ACONFIGURATION_UI_MODE_TYPE_APPLIANCE |
UI mode: value that corresponds to appliance resource qualifier specified. |
| ACONFIGURATION_UI_MODE_TYPE_WATCH |
UI mode: value that corresponds to watch resource qualifier specified. |
| ACONFIGURATION_UI_MODE_NIGHT_ANY |
UI night mode: not specified. |
| ACONFIGURATION_UI_MODE_NIGHT_NO |
UI night mode: value that corresponds to notnight resource qualifier specified. |
| ACONFIGURATION_UI_MODE_NIGHT_YES |
UI night mode: value that corresponds to night resource qualifier specified. |
| ACONFIGURATION_SCREEN_WIDTH_DP_ANY |
Screen width DPI: not specified. |
| ACONFIGURATION_SCREEN_HEIGHT_DP_ANY |
Screen height DPI: not specified. |
| ACONFIGURATION_SMALLEST_SCREEN_WIDTH_DP_ANY |
Smallest screen width DPI: not specified. |
| ACONFIGURATION_LAYOUTDIR_ANY |
Layout direction: not specified. |
| ACONFIGURATION_LAYOUTDIR_LTR |
Layout direction: value that corresponds to ldltr resource qualifier specified. |
| ACONFIGURATION_LAYOUTDIR_RTL |
Layout direction: value that corresponds to ldrtl resource qualifier specified. |
| ACONFIGURATION_MCC |
Bit mask for mcc configuration. |
| ACONFIGURATION_MNC |
Bit mask for mnc configuration. |
| ACONFIGURATION_LOCALE |
Bit mask for locale configuration. |
| ACONFIGURATION_TOUCHSCREEN |
Bit mask for touchscreen configuration. |
| ACONFIGURATION_KEYBOARD |
Bit mask for keyboard configuration. |
| ACONFIGURATION_KEYBOARD_HIDDEN |
Bit mask for keyboardHidden configuration. |
| ACONFIGURATION_NAVIGATION |
Bit mask for navigation configuration. |
| ACONFIGURATION_ORIENTATION |
Bit mask for orientation configuration. |
| ACONFIGURATION_DENSITY |
Bit mask for density configuration. |
| ACONFIGURATION_SCREEN_SIZE |
Bit mask for screen size configuration. |
| ACONFIGURATION_VERSION |
Bit mask for platform version configuration. |
| ACONFIGURATION_SCREEN_LAYOUT |
Bit mask for screen layout configuration. |
| ACONFIGURATION_UI_MODE |
Bit mask for ui mode configuration. |
| ACONFIGURATION_SMALLEST_SCREEN_SIZE |
Bit mask for smallest screen width configuration. |
| ACONFIGURATION_LAYOUTDIR |
Bit mask for layout direction configuration. |
| ACONFIGURATION_MNC_ZERO |
Constant used to to represent MNC (Mobile Network Code) zero. 0 cannot be used, since it is used to represent an undefined MNC. |
| void AConfiguration_copy | ( | AConfiguration * | dest, |
| AConfiguration * | src | ||
| ) |
Copy the contents of 'src' to 'dest'.
| void AConfiguration_delete | ( | AConfiguration * | config | ) |
Free an AConfiguration that was previously created with AConfiguration_new().
| int32_t AConfiguration_diff | ( | AConfiguration * | config1, |
| AConfiguration * | config2 | ||
| ) |
Perform a diff between two configurations. Returns a bit mask of ACONFIGURATION_* constants, each bit set meaning that configuration element is different between them.
| void AConfiguration_fromAssetManager | ( | AConfiguration * | out, |
| AAssetManager * | am | ||
| ) |
Create and return a new AConfiguration based on the current configuration in use in the given AAssetManager.
| void AConfiguration_getCountry | ( | AConfiguration * | config, |
| char * | outCountry | ||
| ) |
Return the current country code set in the configuration. The output will be filled with an array of two characters. They are not 0-terminated. If a country is not set, they will be 0.
| int32_t AConfiguration_getDensity | ( | AConfiguration * | config | ) |
Return the current ACONFIGURATION_DENSITY_* set in the configuration.
| int32_t AConfiguration_getKeyboard | ( | AConfiguration * | config | ) |
Return the current ACONFIGURATION_KEYBOARD_* set in the configuration.
| int32_t AConfiguration_getKeysHidden | ( | AConfiguration * | config | ) |
Return the current ACONFIGURATION_KEYSHIDDEN_* set in the configuration.
| void AConfiguration_getLanguage | ( | AConfiguration * | config, |
| char * | outLanguage | ||
| ) |
Return the current language code set in the configuration. The output will be filled with an array of two characters. They are not 0-terminated. If a language is not set, they will be 0.
| int32_t AConfiguration_getLayoutDirection | ( | AConfiguration * | config | ) |
Return the configuration's layout direction, or ACONFIGURATION_LAYOUTDIR_ANY if not set.
| int32_t AConfiguration_getMcc | ( | AConfiguration * | config | ) |
Return the current MCC set in the configuration. 0 if not set.
| int32_t AConfiguration_getMnc | ( | AConfiguration * | config | ) |
Return the current MNC set in the configuration. 0 if not set.
| int32_t AConfiguration_getNavHidden | ( | AConfiguration * | config | ) |
Return the current ACONFIGURATION_NAVHIDDEN_* set in the configuration.
| int32_t AConfiguration_getNavigation | ( | AConfiguration * | config | ) |
Return the current ACONFIGURATION_NAVIGATION_* set in the configuration.
| int32_t AConfiguration_getOrientation | ( | AConfiguration * | config | ) |
Return the current ACONFIGURATION_ORIENTATION_* set in the configuration.
| int32_t AConfiguration_getScreenHeightDp | ( | AConfiguration * | config | ) |
Return the current configuration screen height in dp units, or ACONFIGURATION_SCREEN_HEIGHT_DP_ANY if not set.
| int32_t AConfiguration_getScreenLong | ( | AConfiguration * | config | ) |
Return the current ACONFIGURATION_SCREENLONG_* set in the configuration.
| int32_t AConfiguration_getScreenSize | ( | AConfiguration * | config | ) |
Return the current ACONFIGURATION_SCREENSIZE_* set in the configuration.
| int32_t AConfiguration_getScreenWidthDp | ( | AConfiguration * | config | ) |
Return the current configuration screen width in dp units, or ACONFIGURATION_SCREEN_WIDTH_DP_ANY if not set.
| int32_t AConfiguration_getSdkVersion | ( | AConfiguration * | config | ) |
Return the current SDK (API) version set in the configuration.
| int32_t AConfiguration_getSmallestScreenWidthDp | ( | AConfiguration * | config | ) |
Return the configuration's smallest screen width in dp units, or ACONFIGURATION_SMALLEST_SCREEN_WIDTH_DP_ANY if not set.
| int32_t AConfiguration_getTouchscreen | ( | AConfiguration * | config | ) |
Return the current ACONFIGURATION_TOUCHSCREEN_* set in the configuration.
| int32_t AConfiguration_getUiModeNight | ( | AConfiguration * | config | ) |
Return the current ACONFIGURATION_UI_MODE_NIGHT_* set in the configuration.
| int32_t AConfiguration_getUiModeType | ( | AConfiguration * | config | ) |
Return the current ACONFIGURATION_UI_MODE_TYPE_* set in the configuration.
| int32_t AConfiguration_isBetterThan | ( | AConfiguration * | base, |
| AConfiguration * | test, | ||
| AConfiguration * | requested | ||
| ) |
Determine whether the configuration in 'test' is better than the existing configuration in 'base'. If 'requested' is non-NULL, this decision is based on the overall configuration given there. If it is NULL, this decision is simply based on which configuration is more specific. Returns non-0 if 'test' is better than 'base'.
This assumes you have already filtered the configurations with AConfiguration_match().
| int32_t AConfiguration_match | ( | AConfiguration * | base, |
| AConfiguration * | requested | ||
| ) |
Determine whether 'base' is a valid configuration for use within the environment 'requested'. Returns 0 if there are any values in 'base' that conflict with 'requested'. Returns 1 if it does not conflict.
| AConfiguration* AConfiguration_new | ( | ) |
Create a new AConfiguration, initialized with no values set.
| void AConfiguration_setCountry | ( | AConfiguration * | config, |
| const char * | country | ||
| ) |
Set the current country code in the configuration, from the first two characters in the string.
| void AConfiguration_setDensity | ( | AConfiguration * | config, |
| int32_t | density | ||
| ) |
Set the current density in the configuration.
| void AConfiguration_setKeyboard | ( | AConfiguration * | config, |
| int32_t | keyboard | ||
| ) |
Set the current keyboard in the configuration.
| void AConfiguration_setKeysHidden | ( | AConfiguration * | config, |
| int32_t | keysHidden | ||
| ) |
Set the current keys hidden in the configuration.
| void AConfiguration_setLanguage | ( | AConfiguration * | config, |
| const char * | language | ||
| ) |
Set the current language code in the configuration, from the first two characters in the string.
| void AConfiguration_setLayoutDirection | ( | AConfiguration * | config, |
| int32_t | value | ||
| ) |
Set the configuration's layout direction.
| void AConfiguration_setMcc | ( | AConfiguration * | config, |
| int32_t | mcc | ||
| ) |
Set the current MCC in the configuration. 0 to clear.
| void AConfiguration_setMnc | ( | AConfiguration * | config, |
| int32_t | mnc | ||
| ) |
Set the current MNC in the configuration. 0 to clear.
| void AConfiguration_setNavHidden | ( | AConfiguration * | config, |
| int32_t | navHidden | ||
| ) |
Set the current nav hidden in the configuration.
| void AConfiguration_setNavigation | ( | AConfiguration * | config, |
| int32_t | navigation | ||
| ) |
Set the current navigation in the configuration.
| void AConfiguration_setOrientation | ( | AConfiguration * | config, |
| int32_t | orientation | ||
| ) |
Set the current orientation in the configuration.
| void AConfiguration_setScreenHeightDp | ( | AConfiguration * | config, |
| int32_t | value | ||
| ) |
Set the configuration's current screen width in dp units.
| void AConfiguration_setScreenLong | ( | AConfiguration * | config, |
| int32_t | screenLong | ||
| ) |
Set the current screen long in the configuration.
| void AConfiguration_setScreenSize | ( | AConfiguration * | config, |
| int32_t | screenSize | ||
| ) |
Set the current screen size in the configuration.
| void AConfiguration_setScreenWidthDp | ( | AConfiguration * | config, |
| int32_t | value | ||
| ) |
Set the configuration's current screen width in dp units.
| void AConfiguration_setSdkVersion | ( | AConfiguration * | config, |
| int32_t | sdkVersion | ||
| ) |
Set the current SDK version in the configuration.
| void AConfiguration_setSmallestScreenWidthDp | ( | AConfiguration * | config, |
| int32_t | value | ||
| ) |
Set the configuration's smallest screen width in dp units.
| void AConfiguration_setTouchscreen | ( | AConfiguration * | config, |
| int32_t | touchscreen | ||
| ) |
Set the current touchscreen in the configuration.
| void AConfiguration_setUiModeNight | ( | AConfiguration * | config, |
| int32_t | uiModeNight | ||
| ) |
Set the current UI mode night in the configuration.
| void AConfiguration_setUiModeType | ( | AConfiguration * | config, |
| int32_t | uiModeType | ||
| ) |
Set the current UI mode type in the configuration.
NDK