Configuration

Summary

Enumerations

Anonymous Enum 24{   ACONFIGURATION_ORIENTATION_ANY = 0x0000,   ACONFIGURATION_ORIENTATION_PORT = 0x0001,   ACONFIGURATION_ORIENTATION_LAND = 0x0002,   ACONFIGURATION_ORIENTATION_SQUARE = 0x0003,   ACONFIGURATION_TOUCHSCREEN_ANY = 0x0000,   ACONFIGURATION_TOUCHSCREEN_NOTOUCH = 0x0001,   ACONFIGURATION_TOUCHSCREEN_STYLUS = 0x0002,   ACONFIGURATION_TOUCHSCREEN_FINGER = 0x0003,   ACONFIGURATION_DENSITY_DEFAULT = 0,   ACONFIGURATION_DENSITY_LOW = 120,   ACONFIGURATION_DENSITY_MEDIUM = 160,   ACONFIGURATION_DENSITY_TV = 213,   ACONFIGURATION_DENSITY_HIGH = 240,   ACONFIGURATION_DENSITY_XHIGH = 320,   ACONFIGURATION_DENSITY_XXHIGH = 480,   ACONFIGURATION_DENSITY_XXXHIGH = 640,   ACONFIGURATION_DENSITY_ANY = 0xfffe,   ACONFIGURATION_DENSITY_NONE = 0xffff,   ACONFIGURATION_KEYBOARD_ANY = 0x0000,   ACONFIGURATION_KEYBOARD_NOKEYS = 0x0001,   ACONFIGURATION_KEYBOARD_QWERTY = 0x0002,   ACONFIGURATION_KEYBOARD_12KEY = 0x0003,   ACONFIGURATION_NAVIGATION_ANY = 0x0000,   ACONFIGURATION_NAVIGATION_NONAV = 0x0001,   ACONFIGURATION_NAVIGATION_DPAD = 0x0002,   ACONFIGURATION_NAVIGATION_TRACKBALL = 0x0003,   ACONFIGURATION_NAVIGATION_WHEEL = 0x0004,   ACONFIGURATION_KEYSHIDDEN_ANY = 0x0000,   ACONFIGURATION_KEYSHIDDEN_NO = 0x0001,   ACONFIGURATION_KEYSHIDDEN_YES = 0x0002,   ACONFIGURATION_KEYSHIDDEN_SOFT = 0x0003,   ACONFIGURATION_NAVHIDDEN_ANY = 0x0000,   ACONFIGURATION_NAVHIDDEN_NO = 0x0001,   ACONFIGURATION_NAVHIDDEN_YES = 0x0002,   ACONFIGURATION_SCREENSIZE_ANY = 0x00,   ACONFIGURATION_SCREENSIZE_SMALL = 0x01,   ACONFIGURATION_SCREENSIZE_NORMAL = 0x02,   ACONFIGURATION_SCREENSIZE_LARGE = 0x03,   ACONFIGURATION_SCREENSIZE_XLARGE = 0x04,   ACONFIGURATION_SCREENLONG_ANY = 0x00,   ACONFIGURATION_SCREENLONG_NO = 0x1,   ACONFIGURATION_SCREENLONG_YES = 0x2,   ACONFIGURATION_SCREENROUND_ANY = 0x00,   ACONFIGURATION_SCREENROUND_NO = 0x1,   ACONFIGURATION_SCREENROUND_YES = 0x2,   ACONFIGURATION_WIDE_COLOR_GAMUT_ANY = 0x00,   ACONFIGURATION_WIDE_COLOR_GAMUT_NO = 0x1,   ACONFIGURATION_WIDE_COLOR_GAMUT_YES = 0x2,   ACONFIGURATION_HDR_ANY = 0x00,   ACONFIGURATION_HDR_NO = 0x1,   ACONFIGURATION_HDR_YES = 0x2,   ACONFIGURATION_UI_MODE_TYPE_ANY = 0x00,   ACONFIGURATION_UI_MODE_TYPE_NORMAL = 0x01,   ACONFIGURATION_UI_MODE_TYPE_DESK = 0x02,   ACONFIGURATION_UI_MODE_TYPE_CAR = 0x03,   ACONFIGURATION_UI_MODE_TYPE_TELEVISION = 0x04,   ACONFIGURATION_UI_MODE_TYPE_APPLIANCE = 0x05,   ACONFIGURATION_UI_MODE_TYPE_WATCH = 0x06,   ACONFIGURATION_UI_MODE_TYPE_VR_HEADSET = 0x07,   ACONFIGURATION_UI_MODE_NIGHT_ANY = 0x00,   ACONFIGURATION_UI_MODE_NIGHT_NO = 0x1,   ACONFIGURATION_UI_MODE_NIGHT_YES = 0x2,   ACONFIGURATION_SCREEN_WIDTH_DP_ANY = 0x0000,   ACONFIGURATION_SCREEN_HEIGHT_DP_ANY = 0x0000,   ACONFIGURATION_SMALLEST_SCREEN_WIDTH_DP_ANY = 0x0000,   ACONFIGURATION_LAYOUTDIR_ANY = 0x00,   ACONFIGURATION_LAYOUTDIR_LTR = 0x01,   ACONFIGURATION_LAYOUTDIR_RTL = 0x02,   ACONFIGURATION_MCC = 0x0001,   ACONFIGURATION_MNC = 0x0002,   ACONFIGURATION_LOCALE = 0x0004,   ACONFIGURATION_TOUCHSCREEN = 0x0008,   ACONFIGURATION_KEYBOARD = 0x0010,   ACONFIGURATION_KEYBOARD_HIDDEN = 0x0020,   ACONFIGURATION_NAVIGATION = 0x0040,   ACONFIGURATION_ORIENTATION = 0x0080,   ACONFIGURATION_DENSITY = 0x0100,   ACONFIGURATION_SCREEN_SIZE = 0x0200,   ACONFIGURATION_VERSION = 0x0400,   ACONFIGURATION_SCREEN_LAYOUT = 0x0800,   ACONFIGURATION_UI_MODE = 0x1000,   ACONFIGURATION_SMALLEST_SCREEN_SIZE = 0x2000,   ACONFIGURATION_LAYOUTDIR = 0x4000,   ACONFIGURATION_SCREEN_ROUND = 0x8000,   ACONFIGURATION_COLOR_MODE = 0x10000,   ACONFIGURATION_GRAMMATICAL_GENDER = 0x20000,   ACONFIGURATION_MNC_ZERO = 0xffff,   ACONFIGURATION_GRAMMATICAL_GENDER_ANY = 0,   ACONFIGURATION_GRAMMATICAL_GENDER_NEUTER = 1,   ACONFIGURATION_GRAMMATICAL_GENDER_FEMININE = 2,   ACONFIGURATION_GRAMMATICAL_GENDER_MASCULINE = 3 }

enum Define flags and constants for various subsystem configurations.

Typedefs
AConfiguration	typedef struct AConfiguration AConfiguration is an opaque type used to get and set various subsystem configurations.

Functions
AConfiguration_copy(AConfiguration *dest, AConfiguration *src)	void Copy the contents of 'src' to 'dest'.
AConfiguration_delete(AConfiguration *config)	void Free an AConfiguration that was previously created with AConfiguration_new().
AConfiguration_diff(AConfiguration *config1, AConfiguration *config2)	int32_t Perform a diff between two configurations.
AConfiguration_fromAssetManager(AConfiguration *out, AAssetManager *am)	void Create and return a new AConfiguration based on the current configuration in use in the given AAssetManager.
AConfiguration_getCountry(AConfiguration *config, char *outCountry)	void Return the current country code set in the configuration.
AConfiguration_getDensity(AConfiguration *config)	int32_t Return the current ACONFIGURATION_DENSITY_* set in the configuration.
AConfiguration_getGrammaticalGender(AConfiguration *config)	int32_t Return the configuration's grammatical gender, or ACONFIGURATION_GRAMMATICAL_GENDER_ANY if not set.
AConfiguration_getKeyboard(AConfiguration *config)	int32_t Return the current ACONFIGURATION_KEYBOARD_* set in the configuration.
AConfiguration_getKeysHidden(AConfiguration *config)	int32_t Return the current ACONFIGURATION_KEYSHIDDEN_* set in the configuration.
AConfiguration_getLanguage(AConfiguration *config, char *outLanguage)	void Return the current language code set in the configuration.
AConfiguration_getLayoutDirection(AConfiguration *config)	int32_t Return the configuration's layout direction, or ACONFIGURATION_LAYOUTDIR_ANY if not set.
AConfiguration_getMcc(AConfiguration *config)	int32_t Return the current MCC set in the configuration.
AConfiguration_getMnc(AConfiguration *config)	int32_t Return the current MNC set in the configuration.
AConfiguration_getNavHidden(AConfiguration *config)	int32_t Return the current ACONFIGURATION_NAVHIDDEN_* set in the configuration.
AConfiguration_getNavigation(AConfiguration *config)	int32_t Return the current ACONFIGURATION_NAVIGATION_* set in the configuration.
AConfiguration_getOrientation(AConfiguration *config)	int32_t Return the current ACONFIGURATION_ORIENTATION_* set in the configuration.
AConfiguration_getScreenHeightDp(AConfiguration *config)	int32_t Return the current configuration screen height in dp units, or ACONFIGURATION_SCREEN_HEIGHT_DP_ANY if not set.
AConfiguration_getScreenLong(AConfiguration *config)	int32_t Return the current ACONFIGURATION_SCREENLONG_* set in the configuration.
AConfiguration_getScreenRound(AConfiguration *config)	int32_t Return the current ACONFIGURATION_SCREENROUND_* set in the configuration.
AConfiguration_getScreenSize(AConfiguration *config)	int32_t Return the current ACONFIGURATION_SCREENSIZE_* set in the configuration.
AConfiguration_getScreenWidthDp(AConfiguration *config)	int32_t Return the current configuration screen width in dp units, or ACONFIGURATION_SCREEN_WIDTH_DP_ANY if not set.
AConfiguration_getSdkVersion(AConfiguration *config)	int32_t Return the current SDK (API) version set in the configuration.
AConfiguration_getSmallestScreenWidthDp(AConfiguration *config)	int32_t Return the configuration's smallest screen width in dp units, or ACONFIGURATION_SMALLEST_SCREEN_WIDTH_DP_ANY if not set.
AConfiguration_getTouchscreen(AConfiguration *config)	int32_t Return the current ACONFIGURATION_TOUCHSCREEN_* set in the configuration.
AConfiguration_getUiModeNight(AConfiguration *config)	int32_t Return the current ACONFIGURATION_UI_MODE_NIGHT_* set in the configuration.
AConfiguration_getUiModeType(AConfiguration *config)	int32_t Return the current ACONFIGURATION_UI_MODE_TYPE_* set in the configuration.
AConfiguration_isBetterThan(AConfiguration *base, AConfiguration *test, AConfiguration *requested)	int32_t Determine whether the configuration in 'test' is better than the existing configuration in 'base'.
AConfiguration_match(AConfiguration *base, AConfiguration *requested)	int32_t Determine whether 'base' is a valid configuration for use within the environment 'requested'.
AConfiguration_new()	AConfiguration * Create a new AConfiguration, initialized with no values set.
AConfiguration_setCountry(AConfiguration *config, const char *country)	void Set the current country code in the configuration, from the first two characters in the string.
AConfiguration_setDensity(AConfiguration *config, int32_t density)	void Set the current density in the configuration.
AConfiguration_setGrammaticalGender(AConfiguration *config, int32_t value)	void Set the configuration's grammatical gender to one of the ACONFIGURATION_GRAMMATICAL_GENDER_* constants.
AConfiguration_setKeyboard(AConfiguration *config, int32_t keyboard)	void Set the current keyboard in the configuration.
AConfiguration_setKeysHidden(AConfiguration *config, int32_t keysHidden)	void Set the current keys hidden in the configuration.
AConfiguration_setLanguage(AConfiguration *config, const char *language)	void Set the current language code in the configuration, from the first two characters in the string.
AConfiguration_setLayoutDirection(AConfiguration *config, int32_t value)	void Set the configuration's layout direction.
AConfiguration_setMcc(AConfiguration *config, int32_t mcc)	void Set the current MCC in the configuration.
AConfiguration_setMnc(AConfiguration *config, int32_t mnc)	void Set the current MNC in the configuration.
AConfiguration_setNavHidden(AConfiguration *config, int32_t navHidden)	void Set the current nav hidden in the configuration.
AConfiguration_setNavigation(AConfiguration *config, int32_t navigation)	void Set the current navigation in the configuration.
AConfiguration_setOrientation(AConfiguration *config, int32_t orientation)	void Set the current orientation in the configuration.
AConfiguration_setScreenHeightDp(AConfiguration *config, int32_t value)	void Set the configuration's current screen width in dp units.
AConfiguration_setScreenLong(AConfiguration *config, int32_t screenLong)	void Set the current screen long in the configuration.
AConfiguration_setScreenRound(AConfiguration *config, int32_t screenRound)	void Set the current screen round in the configuration.
AConfiguration_setScreenSize(AConfiguration *config, int32_t screenSize)	void Set the current screen size in the configuration.
AConfiguration_setScreenWidthDp(AConfiguration *config, int32_t value)	void Set the configuration's current screen width in dp units.
AConfiguration_setSdkVersion(AConfiguration *config, int32_t sdkVersion)	void Set the current SDK version in the configuration.
AConfiguration_setSmallestScreenWidthDp(AConfiguration *config, int32_t value)	void Set the configuration's smallest screen width in dp units.
AConfiguration_setTouchscreen(AConfiguration *config, int32_t touchscreen)	void Set the current touchscreen in the configuration.
AConfiguration_setUiModeNight(AConfiguration *config, int32_t uiModeNight)	void Set the current UI mode night in the configuration.
AConfiguration_setUiModeType(AConfiguration *config, int32_t uiModeType)	void Set the current UI mode type in the configuration.

Enumerations

Anonymous Enum 24

Declared in android/configuration.h

 Anonymous Enum 24

Define flags and constants for various subsystem configurations.

Properties
ACONFIGURATION_COLOR_MODE	Bit mask for wide color gamut and HDR configurations.
ACONFIGURATION_DENSITY	Bit mask for density configuration.
ACONFIGURATION_DENSITY_ANY	Density: any density.
ACONFIGURATION_DENSITY_DEFAULT	Density: default density.
ACONFIGURATION_DENSITY_HIGH	Density: value corresponding to the hdpi resource qualifier.
ACONFIGURATION_DENSITY_LOW	Density: value corresponding to the ldpi resource qualifier.
ACONFIGURATION_DENSITY_MEDIUM	Density: value corresponding to the mdpi resource qualifier.
ACONFIGURATION_DENSITY_NONE	Density: no density specified.
ACONFIGURATION_DENSITY_TV	Density: value corresponding to the tvdpi 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_GRAMMATICAL_GENDER	Bit mask for grammatical gender configuration.
ACONFIGURATION_GRAMMATICAL_GENDER_ANY	Grammatical gender: not specified.
ACONFIGURATION_GRAMMATICAL_GENDER_FEMININE	Grammatical gender: feminine.
ACONFIGURATION_GRAMMATICAL_GENDER_MASCULINE	Grammatical gender: masculine.
ACONFIGURATION_GRAMMATICAL_GENDER_NEUTER	Grammatical gender: neuter.
ACONFIGURATION_HDR_ANY	HDR: not specified.
ACONFIGURATION_HDR_NO	HDR: value that corresponds to lowdr resource qualifier specified.
ACONFIGURATION_HDR_YES	HDR: value that corresponds to highdr resource qualifier specified.
ACONFIGURATION_KEYBOARD	Bit mask for keyboard configuration.
ACONFIGURATION_KEYBOARD_12KEY	Keyboard: value corresponding to the 12key resource qualifier.
ACONFIGURATION_KEYBOARD_ANY	Keyboard: not specified.
ACONFIGURATION_KEYBOARD_HIDDEN	Bit mask for keyboardHidden configuration.
ACONFIGURATION_KEYBOARD_NOKEYS	Keyboard: value corresponding to the nokeys resource qualifier.
ACONFIGURATION_KEYBOARD_QWERTY	Keyboard: value corresponding to the qwerty resource qualifier.
ACONFIGURATION_KEYSHIDDEN_ANY	Keyboard availability: not specified.
ACONFIGURATION_KEYSHIDDEN_NO	Keyboard availability: value corresponding to the keysexposed resource qualifier.
ACONFIGURATION_KEYSHIDDEN_SOFT	Keyboard availability: value corresponding to the keyssoft resource qualifier.
ACONFIGURATION_KEYSHIDDEN_YES	Keyboard availability: value corresponding to the keyshidden resource qualifier.
ACONFIGURATION_LAYOUTDIR	Bit mask for layout direction configuration.
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_LOCALE	Bit mask for locale configuration.
ACONFIGURATION_MCC	Bit mask for mcc configuration.
ACONFIGURATION_MNC	Bit mask for mnc 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.
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_NAVIGATION	Bit mask for navigation configuration.
ACONFIGURATION_NAVIGATION_ANY	Navigation: not specified.
ACONFIGURATION_NAVIGATION_DPAD	Navigation: value corresponding to the dpad resource qualifier.
ACONFIGURATION_NAVIGATION_NONAV	Navigation: value corresponding to the nonav 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_ORIENTATION	Bit mask for orientation configuration.
ACONFIGURATION_ORIENTATION_ANY	Orientation: not specified.
ACONFIGURATION_ORIENTATION_LAND	Orientation: value corresponding to the land resource qualifier.
ACONFIGURATION_ORIENTATION_PORT	Orientation: value corresponding to the port resource qualifier.
ACONFIGURATION_ORIENTATION_SQUARE	Deprecated. Not currently supported or used.
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_SCREENROUND_ANY
ACONFIGURATION_SCREENROUND_NO
ACONFIGURATION_SCREENROUND_YES
ACONFIGURATION_SCREENSIZE_ANY	Screen size: not specified.
ACONFIGURATION_SCREENSIZE_LARGE	Screen size: value indicating the screen is at least approximately 480x640 dp units, corresponding to the large 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_SMALL	Screen size: value indicating the screen is at least approximately 320x426 dp units, corresponding to the small 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_SCREEN_HEIGHT_DP_ANY	Screen height DPI: not specified.
ACONFIGURATION_SCREEN_LAYOUT	Bit mask for screen layout configuration.
ACONFIGURATION_SCREEN_ROUND
ACONFIGURATION_SCREEN_SIZE	Bit mask for screen size configuration.
ACONFIGURATION_SCREEN_WIDTH_DP_ANY	Screen width DPI: not specified.
ACONFIGURATION_SMALLEST_SCREEN_SIZE	Bit mask for smallest screen width configuration.
ACONFIGURATION_SMALLEST_SCREEN_WIDTH_DP_ANY	Smallest screen width DPI: not specified.
ACONFIGURATION_TOUCHSCREEN	Bit mask for touchscreen configuration.
ACONFIGURATION_TOUCHSCREEN_ANY	Touchscreen: not specified.
ACONFIGURATION_TOUCHSCREEN_FINGER	Touchscreen: value corresponding to the finger resource qualifier.
ACONFIGURATION_TOUCHSCREEN_NOTOUCH	Touchscreen: value corresponding to the notouch resource qualifier.
ACONFIGURATION_TOUCHSCREEN_STYLUS	Deprecated. Not currently supported or used.
ACONFIGURATION_UI_MODE	Bit mask for ui mode configuration.
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_UI_MODE_TYPE_ANY	UI mode: not specified.
ACONFIGURATION_UI_MODE_TYPE_APPLIANCE	UI mode: value that corresponds to appliance resource qualifier specified.
ACONFIGURATION_UI_MODE_TYPE_CAR	UI mode: value that corresponds to car resource qualifier specified.
ACONFIGURATION_UI_MODE_TYPE_DESK	UI mode: value that corresponds to desk resource qualifier specified.
ACONFIGURATION_UI_MODE_TYPE_NORMAL	UI mode: value that corresponds to no UI mode type resource qualifier specified.
ACONFIGURATION_UI_MODE_TYPE_TELEVISION	UI mode: value that corresponds to television resource qualifier specified.
ACONFIGURATION_UI_MODE_TYPE_VR_HEADSET	UI mode: value that corresponds to vr resource qualifier specified.
ACONFIGURATION_UI_MODE_TYPE_WATCH	UI mode: value that corresponds to watch resource qualifier specified.
ACONFIGURATION_VERSION	Bit mask for platform version configuration.
ACONFIGURATION_WIDE_COLOR_GAMUT_ANY	Wide color gamut: not specified.
ACONFIGURATION_WIDE_COLOR_GAMUT_NO	Wide color gamut: value that corresponds to no nowidecg resource qualifier specified.
ACONFIGURATION_WIDE_COLOR_GAMUT_YES	Wide color gamut: value that corresponds to widecg resource qualifier specified.

Typedefs

AConfiguration

Declared in android/configuration.h

struct AConfiguration AConfiguration

AConfiguration is an opaque type used to get and set various subsystem configurations.

A AConfiguration pointer can be obtained using:

• AConfiguration_new()
• AConfiguration_fromAssetManager()

Functions

AConfiguration_copy

Declared in android/configuration.h

void AConfiguration_copy(
  AConfiguration *dest,
  AConfiguration *src
)

Copy the contents of 'src' to 'dest'.

AConfiguration_delete

Declared in android/configuration.h

void AConfiguration_delete(
  AConfiguration *config
)

Free an AConfiguration that was previously created with AConfiguration_new().

AConfiguration_diff

Declared in android/configuration.h

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.

AConfiguration_fromAssetManager

Declared in android/configuration.h

void AConfiguration_fromAssetManager(
  AConfiguration *out,
  AAssetManager *am
)

Create and return a new AConfiguration based on the current configuration in use in the given AAssetManager.

AConfiguration_getCountry

Declared in android/configuration.h

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.

AConfiguration_getDensity

Declared in android/configuration.h

int32_t AConfiguration_getDensity(
  AConfiguration *config
)

Return the current ACONFIGURATION_DENSITY_* set in the configuration.

AConfiguration_getGrammaticalGender

Declared in android/configuration.h

int32_t AConfiguration_getGrammaticalGender(
  AConfiguration *config
)

Return the configuration's grammatical gender, or ACONFIGURATION_GRAMMATICAL_GENDER_ANY if not set.

Available since API level 34.

AConfiguration_getKeyboard

Declared in android/configuration.h

int32_t AConfiguration_getKeyboard(
  AConfiguration *config
)

Return the current ACONFIGURATION_KEYBOARD_* set in the configuration.

AConfiguration_getKeysHidden

Declared in android/configuration.h

int32_t AConfiguration_getKeysHidden(
  AConfiguration *config
)

Return the current ACONFIGURATION_KEYSHIDDEN_* set in the configuration.

AConfiguration_getLanguage

Declared in android/configuration.h

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.

AConfiguration_getLayoutDirection

Declared in android/configuration.h

int32_t AConfiguration_getLayoutDirection(
  AConfiguration *config
)

Return the configuration's layout direction, or ACONFIGURATION_LAYOUTDIR_ANY if not set.

Available since API level 17.

AConfiguration_getMcc

Declared in android/configuration.h

int32_t AConfiguration_getMcc(
  AConfiguration *config
)

Return the current MCC set in the configuration.

0 if not set.

AConfiguration_getMnc

Declared in android/configuration.h

int32_t AConfiguration_getMnc(
  AConfiguration *config
)

Return the current MNC set in the configuration.

0 if not set.

AConfiguration_getNavHidden

Declared in android/configuration.h

int32_t AConfiguration_getNavHidden(
  AConfiguration *config
)

Return the current ACONFIGURATION_NAVHIDDEN_* set in the configuration.

AConfiguration_getNavigation

Declared in android/configuration.h

int32_t AConfiguration_getNavigation(
  AConfiguration *config
)

Return the current ACONFIGURATION_NAVIGATION_* set in the configuration.

AConfiguration_getOrientation

Declared in android/configuration.h

int32_t AConfiguration_getOrientation(
  AConfiguration *config
)

Return the current ACONFIGURATION_ORIENTATION_* set in the configuration.

AConfiguration_getScreenHeightDp

Declared in android/configuration.h

int32_t AConfiguration_getScreenHeightDp(
  AConfiguration *config
)

Return the current configuration screen height in dp units, or ACONFIGURATION_SCREEN_HEIGHT_DP_ANY if not set.

AConfiguration_getScreenLong

Declared in android/configuration.h

int32_t AConfiguration_getScreenLong(
  AConfiguration *config
)

Return the current ACONFIGURATION_SCREENLONG_* set in the configuration.

AConfiguration_getScreenRound

Declared in android/configuration.h

int32_t AConfiguration_getScreenRound(
  AConfiguration *config
)

Return the current ACONFIGURATION_SCREENROUND_* set in the configuration.

Available since API level 30.

AConfiguration_getScreenSize

Declared in android/configuration.h

int32_t AConfiguration_getScreenSize(
  AConfiguration *config
)

Return the current ACONFIGURATION_SCREENSIZE_* set in the configuration.

AConfiguration_getScreenWidthDp

Declared in android/configuration.h

int32_t AConfiguration_getScreenWidthDp(
  AConfiguration *config
)

Return the current configuration screen width in dp units, or ACONFIGURATION_SCREEN_WIDTH_DP_ANY if not set.

AConfiguration_getSdkVersion

Declared in android/configuration.h

int32_t AConfiguration_getSdkVersion(
  AConfiguration *config
)

Return the current SDK (API) version set in the configuration.

AConfiguration_getSmallestScreenWidthDp

Declared in android/configuration.h

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.

AConfiguration_getTouchscreen

Declared in android/configuration.h

int32_t AConfiguration_getTouchscreen(
  AConfiguration *config
)

Return the current ACONFIGURATION_TOUCHSCREEN_* set in the configuration.

AConfiguration_getUiModeNight

Declared in android/configuration.h

int32_t AConfiguration_getUiModeNight(
  AConfiguration *config
)

Return the current ACONFIGURATION_UI_MODE_NIGHT_* set in the configuration.

AConfiguration_getUiModeType

Declared in android/configuration.h

int32_t AConfiguration_getUiModeType(
  AConfiguration *config
)

Return the current ACONFIGURATION_UI_MODE_TYPE_* set in the configuration.

AConfiguration_isBetterThan

Declared in android/configuration.h

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().

AConfiguration_match

Declared in android/configuration.h

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_new

Declared in android/configuration.h

AConfiguration * AConfiguration_new()

Create a new AConfiguration, initialized with no values set.

AConfiguration_setCountry

Declared in android/configuration.h

void AConfiguration_setCountry(
  AConfiguration *config,
  const char *country
)

Set the current country code in the configuration, from the first two characters in the string.

AConfiguration_setDensity

Declared in android/configuration.h

void AConfiguration_setDensity(
  AConfiguration *config,
  int32_t density
)

Set the current density in the configuration.

AConfiguration_setGrammaticalGender

Declared in android/configuration.h

void AConfiguration_setGrammaticalGender(
  AConfiguration *config,
  int32_t value
)

Set the configuration's grammatical gender to one of the ACONFIGURATION_GRAMMATICAL_GENDER_* constants.

Available since API level 34.

AConfiguration_setKeyboard

Declared in android/configuration.h

void AConfiguration_setKeyboard(
  AConfiguration *config,
  int32_t keyboard
)

Set the current keyboard in the configuration.

AConfiguration_setKeysHidden

Declared in android/configuration.h

void AConfiguration_setKeysHidden(
  AConfiguration *config,
  int32_t keysHidden
)

Set the current keys hidden in the configuration.

AConfiguration_setLanguage

Declared in android/configuration.h

void AConfiguration_setLanguage(
  AConfiguration *config,
  const char *language
)

Set the current language code in the configuration, from the first two characters in the string.

AConfiguration_setLayoutDirection

Declared in android/configuration.h

void AConfiguration_setLayoutDirection(
  AConfiguration *config,
  int32_t value
)

Set the configuration's layout direction.

Available since API level 17.

AConfiguration_setMcc

Declared in android/configuration.h

void AConfiguration_setMcc(
  AConfiguration *config,
  int32_t mcc
)

Set the current MCC in the configuration.

0 to clear.

AConfiguration_setMnc

Declared in android/configuration.h

void AConfiguration_setMnc(
  AConfiguration *config,
  int32_t mnc
)

Set the current MNC in the configuration.

0 to clear.

AConfiguration_setNavHidden

Declared in android/configuration.h

void AConfiguration_setNavHidden(
  AConfiguration *config,
  int32_t navHidden
)

Set the current nav hidden in the configuration.

AConfiguration_setNavigation

Declared in android/configuration.h

void AConfiguration_setNavigation(
  AConfiguration *config,
  int32_t navigation
)

Set the current navigation in the configuration.

AConfiguration_setOrientation

Declared in android/configuration.h

void AConfiguration_setOrientation(
  AConfiguration *config,
  int32_t orientation
)

Set the current orientation in the configuration.

AConfiguration_setScreenHeightDp

Declared in android/configuration.h

void AConfiguration_setScreenHeightDp(
  AConfiguration *config,
  int32_t value
)

Set the configuration's current screen width in dp units.

AConfiguration_setScreenLong

Declared in android/configuration.h

void AConfiguration_setScreenLong(
  AConfiguration *config,
  int32_t screenLong
)

Set the current screen long in the configuration.

AConfiguration_setScreenRound

Declared in android/configuration.h

void AConfiguration_setScreenRound(
  AConfiguration *config,
  int32_t screenRound
)

Set the current screen round in the configuration.

AConfiguration_setScreenSize

Declared in android/configuration.h

void AConfiguration_setScreenSize(
  AConfiguration *config,
  int32_t screenSize
)

Set the current screen size in the configuration.

AConfiguration_setScreenWidthDp

Declared in android/configuration.h

void AConfiguration_setScreenWidthDp(
  AConfiguration *config,
  int32_t value
)

Set the configuration's current screen width in dp units.

AConfiguration_setSdkVersion

Declared in android/configuration.h

void AConfiguration_setSdkVersion(
  AConfiguration *config,
  int32_t sdkVersion
)

Set the current SDK version in the configuration.

AConfiguration_setSmallestScreenWidthDp

Declared in android/configuration.h

void AConfiguration_setSmallestScreenWidthDp(
  AConfiguration *config,
  int32_t value
)

Set the configuration's smallest screen width in dp units.

AConfiguration_setTouchscreen

Declared in android/configuration.h

void AConfiguration_setTouchscreen(
  AConfiguration *config,
  int32_t touchscreen
)

Set the current touchscreen in the configuration.

AConfiguration_setUiModeNight

Declared in android/configuration.h

void AConfiguration_setUiModeNight(
  AConfiguration *config,
  int32_t uiModeNight
)

Set the current UI mode night in the configuration.

AConfiguration_setUiModeType

Declared in android/configuration.h

void AConfiguration_setUiModeType(
  AConfiguration *config,
  int32_t uiModeType
)

Set the current UI mode type in the configuration.