# Titanium.UI.Android

> The Android-specific UI capabilities. All properties, methods and events in this namespace will only work on Android systems. #### Drawer Layout The drawer-layout components acts as a top-level container for window content that allows for interactive "drawer" views to be pulled out from one or both vertical edges of the window. It is represented by a `centerView` and optional `leftView` and `rightView` components that can be swiped in and out with additional configuration and transitions. Learn more about drawer-layouts in it's dedicated [Titanium.UI.Android.DrawerLayout](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.DrawerLayout.md) docs.

- Source: https://titaniumsdk.com/docs/sdk/13.1.0/Titanium.UI.Android
- Titanium SDK version: 13.1.0
- Kind: module
- Platforms: Android
- Since: Titanium SDK 1.0
- Extends: Titanium.Module
- Inheritance: Titanium.Module > Titanium.Proxy

## Example: Android Preferences Example

Create preferences interface for the application.

#### `app.js`
``` js
var button = Ti.UI.createButton({
  title:	'Click to Open Preferences'
});
button.addEventListener('click', function() {
  Ti.API.info('Current value for editText: ' + Ti.App.Properties.getString('editText'));
  Ti.UI.Android.openPreferences();
});
currentWindow.add(button);
```

#### `platform/android/res/xml/preferences.xml`
``` xml
<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"
    android:title="Preferences">
  <PreferenceScreen
      android:title="Misc. Preferences"
      android:summary="Click to see more options">
    <EditTextPreference
      android:title="Edit Text Preference"
      android:summary="You may enter a string"
      android:defaultValue=""
      android:key="editText" />
  </PreferenceScreen>
  <PreferenceCategory android:title="Category One">
    <CheckBoxPreference
      android:title="CheckBox Preference"
      android:defaultValue="false"
      android:summary="You may enter a boolean"
      android:key="checkbox" />
    <RingtonePreference
      android:title="Ringtone Preference"
      android:summary="You may pick a ringtone"
      android:defaultValue=""
      android:key="ringtone" />
  </PreferenceCategory>
  <PreferenceCategory android:title="Category Two">
    <ListPreference
      android:title="List Preference"
      android:summary="You may chose from multiple choices"
      android:key="list"
    android:entries="@array/listNames"
    android:entryValues="@array/listValues"
    />
  </PreferenceCategory>
</PreferenceScreen>
```

#### `platform/android/res/values/array/array.xml`
``` xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
  <string-array name="listNames">
    <item>5 Minutes</item>
    <item>10 Minutes</item>
    <item>15 Minutes</item>
    <item>30 Minutes</item>
    <item>60 Minutes</item>
  </string-array>
  <string-array name="listValues">
    <item>5</item>
    <item>10</item>
    <item>15</item>
    <item>30</item>
    <item>60</item>
  </string-array>
</resources>
```

## Properties

### FLAG_LAYOUT_NO_LIMITS

- Type: Number
- Platforms: Android
- Since: Titanium SDK 10.1.0
- Permission: read-only

Flag allowing window to extend into the status bar and navigation bar.

When assigned to [Window.windowFlags](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#windowFlags), this flag will make the
window ignore the system's insets such as the top status bar and bottom navigation bar so that
they overlap the window. The system may make the status bar and navigation bar completely transparent,
but this behavior is not guaranteed to happen.

When using this flag, it's also recommended to set the
[Window.extendSafeArea](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#extendSafeArea) property to `true`.

Warning: Using this flag causes [Window.safeAreaPadding](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#safeAreaPadding)
to return all zeros. This flag also breaks keyboard `adjustPan` support.

### FLAG_TRANSLUCENT_NAVIGATION

- Type: Number
- Platforms: Android
- Since: Titanium SDK 7.5.0
- Permission: read-only

Window flag which makes the Android system's navigation bar semi-transparent.

When assigned to [Titanium.UI.Window.windowFlags](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#windowFlags), this flag will make the Android
system's bottom navigation bar semi-transparent. This flag will only work if you also set the
[Window.extendSafeArea](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#extendSafeArea) property to `true`.

This flag is only supported by Android 4.4 and newer OS versions. This flag is ignored on older versions.
On Android 4.4, navigation bar can only be translucent in portrait mode while newer OS versions support
this flag for all orientations.

### FLAG_TRANSLUCENT_STATUS

- Type: Number
- Platforms: Android
- Since: Titanium SDK 7.5.0
- Permission: read-only

Window flag which makes the Android system's top status bar semi-transparent.

When assigned to [Titanium.UI.Window.windowFlags](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#windowFlags), this flag will make the Android
system's top status bar semi-transparent. This flag will only work if you also set the
[Titanium.UI.Window.extendSafeArea](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#extendSafeArea) property to `true`.

This flag is only supported by Android 4.4 and newer OS versions. This flag is ignored on older versions.

### GRAVITY_AXIS_CLIP

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Raw bit controlling whether the right/bottom edge is clipped to its container, based on the gravity direction being applied.

### GRAVITY_AXIS_PULL_AFTER

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Raw bit controlling how the right/bottom edge is placed.

### GRAVITY_AXIS_PULL_BEFORE

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Raw bit controlling how the left/top edge is placed.

### GRAVITY_AXIS_SPECIFIED

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Raw bit indicating the gravity for an axis has been specified.

### GRAVITY_AXIS_X_SHIFT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Bits defining the horizontal axis.

### GRAVITY_AXIS_Y_SHIFT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Bits defining the vertical axis.

### GRAVITY_BOTTOM

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Push object to the bottom of its container, not changing its size.

### GRAVITY_CENTER

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Place the object in the center of its container in both the vertical and horizontal axis, not changing its size.

### GRAVITY_CENTER_HORIZONTAL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Place object in the horizontal center of its container, not changing its size.

### GRAVITY_CENTER_VERTICAL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Place object in the vertical center of its container, not changing its size.

### GRAVITY_CLIP_HORIZONTAL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Flag to clip the edges of the object to its container along the horizontal axis.

### GRAVITY_CLIP_VERTICAL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Flag to clip the edges of the object to its container along the vertical axis.

### GRAVITY_DISPLAY_CLIP_HORIZONTAL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Special constant to enable clipping to an overall display along the horizontal dimension.

### GRAVITY_DISPLAY_CLIP_VERTICAL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Special constant to enable clipping to an overall display along the vertical dimension.

### GRAVITY_END

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Push object to x-axis position at the end of its container, not changing its size.

### GRAVITY_FILL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Grow the horizontal and vertical size of the object if needed so it completely fills its container.

### GRAVITY_FILL_HORIZONTAL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Grow the horizontal size of the object if needed so it completely fills its container.

### GRAVITY_FILL_VERTICAL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Grow the vertical size of the object if needed so it completely fills its container.

### GRAVITY_HORIZONTAL_GRAVITY_MASK

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Binary mask to get the absolute horizontal gravity of a gravity.

### GRAVITY_LEFT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Push object to the left of its container, not changing its size.

### GRAVITY_NO_GRAVITY

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Constant indicating that no gravity has been set

### GRAVITY_RELATIVE_HORIZONTAL_GRAVITY_MASK

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Binary mask for the horizontal gravity and script specific direction bit.

### GRAVITY_RELATIVE_LAYOUT_DIRECTION

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Raw bit controlling whether the layout direction is relative or not (GRAVITY_START/GRAVITY_END instead of absolute GRAVITY_LEFT/GRAVITY_RIGHT).

### GRAVITY_RIGHT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Push object to the right of its container, not changing its size.

### GRAVITY_START

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Push object to x-axis position at the start of its container, not changing its size.

### GRAVITY_TOP

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Push object to the top of its container, not changing its size.

### GRAVITY_VERTICAL_GRAVITY_MASK

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.4.0
- Permission: read-only

Binary mask to get the vertical gravity of a gravity.

### OVER_SCROLL_ALWAYS

- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.1.0
- Permission: read-only

Always allow a user to over-scroll this view, provided it is a view that can scroll.

Use this with the following properties - [Titanium.UI.ScrollableView.overScrollMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.ScrollableView.md#overScrollMode), [Titanium.UI.ScrollView.overScrollMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.ScrollView.md#overScrollMode),
[Titanium.UI.TableView.overScrollMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TableView.md#overScrollMode) and [Titanium.UI.WebView.overScrollMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#overScrollMode).

Only applicable when [Titanium.Platform.Android.API_LEVEL](https://titaniumsdk.com/docs/sdk/Titanium.Platform.Android.md#API_LEVEL) is 9 or above.

### OVER_SCROLL_IF_CONTENT_SCROLLS

- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.1.0
- Permission: read-only

Allow a user to over-scroll this view only if the content is large enough to meaningfully scroll, provided it is a view that can scroll.

Use this with the following properties - [Titanium.UI.ScrollableView.overScrollMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.ScrollableView.md#overScrollMode), [Titanium.UI.ScrollView.overScrollMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.ScrollView.md#overScrollMode),
[Titanium.UI.TableView.overScrollMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TableView.md#overScrollMode) and [Titanium.UI.WebView.overScrollMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#overScrollMode).

Only applicable when [Titanium.Platform.Android.API_LEVEL](https://titaniumsdk.com/docs/sdk/Titanium.Platform.Android.md#API_LEVEL) is 9 or above.

### OVER_SCROLL_NEVER

- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.1.0
- Permission: read-only

Never allow a user to over-scroll this view.

Use this with the following properties - [Titanium.UI.ScrollableView.overScrollMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.ScrollableView.md#overScrollMode), [Titanium.UI.ScrollView.overScrollMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.ScrollView.md#overScrollMode),
[Titanium.UI.TableView.overScrollMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TableView.md#overScrollMode) and [Titanium.UI.WebView.overScrollMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#overScrollMode).

Only applicable when [Titanium.Platform.Android.API_LEVEL](https://titaniumsdk.com/docs/sdk/Titanium.Platform.Android.md#API_LEVEL) is 9 or above.

### PIXEL_FORMAT_A_8

- Type: Number
- Platforms: Android
- Since: Titanium SDK 1.8.0
- Permission: read-only

Android A_8 pixel format for [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md). Selecting the correct pixel format
can improve image clarity and performance.

See the Android Developer website for official documentation about the
[PixelFormat](https://developer.android.com/reference/android/graphics/PixelFormat.html)
constants.

### PIXEL_FORMAT_L_8

- Type: Number
- Platforms: Android
- Since: Titanium SDK 1.8.0
- Permission: read-only

Android L_8 pixel format for [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md). Selecting the correct pixel format
can improve image clarity and performance.

See the Android Developer website for official documentation about the
[PixelFormat](https://developer.android.com/reference/android/graphics/PixelFormat.html)
constants.

### PIXEL_FORMAT_LA_88

- Type: Number
- Platforms: Android
- Since: Titanium SDK 1.8.0
- Permission: read-only

Android LA_88 pixel format for [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md). Selecting the correct pixel format
can improve image clarity and performance.

See the Android Developer website for official documentation about the
[PixelFormat](https://developer.android.com/reference/android/graphics/PixelFormat.html)
constants.

### PIXEL_FORMAT_OPAQUE

- Type: Number
- Platforms: Android
- Since: Titanium SDK 1.8.0
- Permission: read-only

Android OPAQUE pixel format for [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md). Selecting the correct pixel format
can improve image clarity and performance.

See the Android Developer website for official documentation about the
[PixelFormat](https://developer.android.com/reference/android/graphics/PixelFormat.html)
constants.

### PIXEL_FORMAT_RGB_332

- Type: Number
- Platforms: Android
- Since: Titanium SDK 1.8.0
- Permission: read-only

Android RGB_332 pixel format for [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md). Selecting the correct pixel format
can improve image clarity and performance.

See the Android Developer website for official documentation about the
[PixelFormat](https://developer.android.com/reference/android/graphics/PixelFormat.html)
constants.

### PIXEL_FORMAT_RGB_565

- Type: Number
- Platforms: Android
- Since: Titanium SDK 1.8.0
- Permission: read-only

Android RGB_565 pixel format for [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md). Selecting the correct pixel format
can improve image clarity and performance.

See the Android Developer website for official documentation about the
[PixelFormat](https://developer.android.com/reference/android/graphics/PixelFormat.html)
constants.

### PIXEL_FORMAT_RGB_888

- Type: Number
- Platforms: Android
- Since: Titanium SDK 1.8.0
- Permission: read-only

Android RGB_888 pixel format for [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md). Selecting the correct pixel format
can improve image clarity and performance.

See the Android Developer website for official documentation about the
[PixelFormat](https://developer.android.com/reference/android/graphics/PixelFormat.html)
constants.

### PIXEL_FORMAT_RGBA_4444

- Type: Number
- Platforms: Android
- Since: Titanium SDK 1.8.0
- Permission: read-only

Android RGBA_4444 pixel format for [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md). Selecting the correct pixel format
can improve image clarity and performance.

See the Android Developer website for official documentation about the
[PixelFormat](https://developer.android.com/reference/android/graphics/PixelFormat.html)
constants.

### PIXEL_FORMAT_RGBA_5551

- Type: Number
- Platforms: Android
- Since: Titanium SDK 1.8.0
- Permission: read-only

Android RGBA_5551 pixel format for [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md). Selecting the correct pixel format
can improve image clarity and performance.

See the Android Developer website for official documentation about the
[PixelFormat](https://developer.android.com/reference/android/graphics/PixelFormat.html)
constants.

### PIXEL_FORMAT_RGBA_8888

- Type: Number
- Platforms: Android
- Since: Titanium SDK 1.8.0
- Permission: read-only

Android RGBA_8888 pixel format for [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md). Selecting the correct pixel format
can improve image clarity and performance.

See the Android Developer website for official documentation about the
[PixelFormat](https://developer.android.com/reference/android/graphics/PixelFormat.html)
constants.

### PIXEL_FORMAT_RGBX_8888

- Type: Number
- Platforms: Android
- Since: Titanium SDK 1.8.0
- Permission: read-only

Android RGBX_8888 pixel format for [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md). Selecting the correct pixel format
can improve image clarity and performance.

See the Android Developer website for official documentation about the
[PixelFormat](https://developer.android.com/reference/android/graphics/PixelFormat.html)
constants.

### PIXEL_FORMAT_TRANSLUCENT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 1.8.0
- Permission: read-only

Android TRANSLUCENT pixel format for [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md). Selecting the correct pixel format
can improve image clarity and performance.

See the Android Developer website for official documentation about the
[PixelFormat](https://developer.android.com/reference/android/graphics/PixelFormat.html)
constants.

### PIXEL_FORMAT_TRANSPARENT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 1.8.0
- Permission: read-only

Android A_8 pixel format for [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md). Selecting the correct pixel format can
improve image clarity and performance.

See the Android Developer website for official documentation about the
[PixelFormat](https://developer.android.com/reference/android/graphics/PixelFormat.html)
constants.

### PIXEL_FORMAT_UNKNOWN

- Type: Number
- Platforms: Android
- Since: Titanium SDK 1.8.0
- Permission: read-only

Android UNKNOWN pixel format for [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md). Selecting the correct pixel format
can improve image clarity and performance.

See the Android Developer website for official documentation about the
[PixelFormat](https://developer.android.com/reference/android/graphics/PixelFormat.html)
constants.

### PROGRESS_INDICATOR_DETERMINANT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.0.0
- Permission: read-only

Used with the [Titanium.UI.Android.ProgressIndicator.type](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.ProgressIndicator.md#type) property to indicate an ongoing
activity of determinate length.

### PROGRESS_INDICATOR_DIALOG

- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.0.0
- Permission: read-only

Display [Titanium.UI.Android.ProgressIndicator](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.ProgressIndicator.md) as a modal dialog. (default)

Used with the [Titanium.UI.Android.ProgressIndicator.location](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.ProgressIndicator.md#location) property.

### PROGRESS_INDICATOR_INDETERMINANT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.0.0
- Permission: read-only

Used with the [Titanium.UI.Android.ProgressIndicator.type](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.ProgressIndicator.md#type) property to indicate an ongoing
activity of indeterminate length. (default)

### PROGRESS_INDICATOR_STATUS_BAR

- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.0.0
- Permission: read-only

Display [Titanium.UI.Android.ProgressIndicator](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.ProgressIndicator.md) as a horizontal progress bar in the title of
the window.

Used with the [Titanium.UI.Android.ProgressIndicator.location](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.ProgressIndicator.md#location) property.

### SCROLL_FLAG_ENTER_ALWAYS

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.1.0
- Permission: read-only

When entering (scrolling on screen) the view will scroll on any downwards scroll event, regardless of whether the scrolling view is also scrolling. This is commonly referred to as the 'quick return' pattern.

### SCROLL_FLAG_ENTER_ALWAYS_COLLAPSED

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.1.0
- Permission: read-only

An additional flag for 'enterAlways' which modifies the returning view to only initially scroll back to it's collapsed height. Once the scrolling view has reached the end of it's scroll range, the remainder of this view will be scrolled into view. The collapsed height is defined by the view's minimum height.

### SCROLL_FLAG_EXIT_UNTIL_COLLAPSED

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.1.0
- Permission: read-only

When exiting (scrolling off screen) the view will be scrolled until it is 'collapsed'. The collapsed height is defined by the view's minimum height.

### SCROLL_FLAG_NO_SCROLL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.1.0
- Permission: read-only

Disable scrolling on the view. This flag should not be combined with any of the other scroll flags.

### SCROLL_FLAG_SCROLL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.1.0
- Permission: read-only

The view will be scroll in direct relation to scroll events. This flag needs to be set for any of the other flags to take effect. If any sibling views before this one do not have this flag, then this value has no effect.

### SCROLL_FLAG_SNAP

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.1.0
- Permission: read-only

Upon a scroll ending, if the view is only partially visible then it will be snapped and scrolled to its closest edge. For example, if the view only has its bottom 25% displayed, it will be scrolled off screen completely. Conversely, if its bottom 75% is visible then it will be scrolled fully into view.

### SCROLL_FLAG_SNAP_MARGINS

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.1.0
- Permission: read-only

An additional flag to be used with 'snap'. If set, the view will be snapped to its top and bottom margins, as opposed to the edges of the view itself.

### SOFT_INPUT_ADJUST_NOTHING

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.1.0
- Permission: read-only

The window will not be resized, and it will not be panned to make its focus visible.

Used with the [Titanium.UI.Window.windowSoftInputMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#windowSoftInputMode) property.

### SOFT_INPUT_ADJUST_PAN

- Type: Number
- Platforms: Android
- Permission: read-only

Pan the current heavyweight window when the input method (ie software keyboard) is shown, to
ensure that its contents are not obscured.

Used with the [Titanium.UI.Window.windowSoftInputMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#windowSoftInputMode) property.

One of the group of soft input adjustment constants,
[SOFT_INPUT_ADJUST_UNSPECIFIED](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_ADJUST_UNSPECIFIED),
[SOFT_INPUT_ADJUST_RESIZE](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_ADJUST_RESIZE),
and [SOFT_INPUT_ADJUST_PAN](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_ADJUST_PAN).

### SOFT_INPUT_ADJUST_RESIZE

- Type: Number
- Platforms: Android
- Permission: read-only

Resize the current heavyweight window when the input method (ie software keyboard) is shown,
to ensure that its contents are not obscured.

Used with the [Titanium.UI.Window.windowSoftInputMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#windowSoftInputMode) property.

One of the group of soft input adjustment constants,
[SOFT_INPUT_ADJUST_UNSPECIFIED](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_ADJUST_UNSPECIFIED),
[SOFT_INPUT_ADJUST_RESIZE](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_ADJUST_RESIZE),
and [SOFT_INPUT_ADJUST_PAN](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_ADJUST_PAN).

### SOFT_INPUT_ADJUST_UNSPECIFIED

- Type: Number
- Platforms: Android
- Permission: read-only

Use the system-default behavior to determine how the soft input area (ie software keyboard)
is accomodated by the current heavyweight window when it receives focus (default.)

Depends on the `AndroidManifest.xml` setting if defined or system-default otherwise to
determine how to accomodate the soft keyboard when visible.

Used with the [Titanium.UI.Window.windowSoftInputMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#windowSoftInputMode) property.

One of the group of soft input adjustment constants,
[SOFT_INPUT_ADJUST_UNSPECIFIED](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_ADJUST_UNSPECIFIED),
[SOFT_INPUT_ADJUST_RESIZE](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_ADJUST_RESIZE),
and [SOFT_INPUT_ADJUST_PAN](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_ADJUST_PAN).

### SOFT_INPUT_STATE_ALWAYS_HIDDEN

- Type: Number
- Platforms: Android
- Permission: read-only

Always hide the soft input area (ie software keyboard) when the current heavyweight window
receives focus.

Note that the unresolved bug [#7115](https://code.google.com/p/android/issues/detail?id=7115)
on the Official Android Project website affects this functionality.

Used with the [Titanium.UI.Window.windowSoftInputMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#windowSoftInputMode) property.

One of the group of soft input visibility constants,
[SOFT_INPUT_STATE_ALWAYS_HIDDEN](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_ALWAYS_HIDDEN),
[SOFT_INPUT_STATE_ALWAYS_VISIBLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_ALWAYS_VISIBLE),
[SOFT_INPUT_STATE_HIDDEN](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_HIDDEN),
[SOFT_INPUT_STATE_UNSPECIFIED](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_UNSPECIFIED),
and [SOFT_INPUT_STATE_VISIBLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_VISIBLE).

### SOFT_INPUT_STATE_ALWAYS_VISIBLE

- Type: Number
- Platforms: Android
- Permission: read-only

Always show the soft input area (ie software keyboard) when the current heavyweight window
receives focus.

Used with the [Titanium.UI.Window.windowSoftInputMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#windowSoftInputMode) property.

This constant is one of the group of soft input visibility constants,
[SOFT_INPUT_STATE_ALWAYS_HIDDEN](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_ALWAYS_HIDDEN),
[SOFT_INPUT_STATE_ALWAYS_VISIBLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_ALWAYS_VISIBLE),
[SOFT_INPUT_STATE_HIDDEN](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_HIDDEN),
[SOFT_INPUT_STATE_UNSPECIFIED](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_UNSPECIFIED),
and [SOFT_INPUT_STATE_VISIBLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_VISIBLE).

### SOFT_INPUT_STATE_HIDDEN

- Type: Number
- Platforms: Android
- Permission: read-only

Attempt to hide the soft input area (ie software keyboard) when the current heavyweight
window receives focus.

Used with the [Titanium.UI.Window.windowSoftInputMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#windowSoftInputMode) property.

This constant is one of the group of soft input visibility constants,
[SOFT_INPUT_STATE_ALWAYS_HIDDEN](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_ALWAYS_HIDDEN),
[SOFT_INPUT_STATE_ALWAYS_VISIBLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_ALWAYS_VISIBLE),
[SOFT_INPUT_STATE_HIDDEN](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_HIDDEN),
[SOFT_INPUT_STATE_UNSPECIFIED](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_UNSPECIFIED),
and [SOFT_INPUT_STATE_VISIBLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_VISIBLE).

### SOFT_INPUT_STATE_UNSPECIFIED

- Type: Number
- Platforms: Android
- Permission: read-only

Use the system-default behavior to determine whether to show the soft input area
(ie software keyboard) when the current heavyweight window receives focus.

Used with the [Titanium.UI.Window.windowSoftInputMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#windowSoftInputMode) property.

This constant is one of the group of soft input visibility constants,
[SOFT_INPUT_STATE_ALWAYS_HIDDEN](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_ALWAYS_HIDDEN),
[SOFT_INPUT_STATE_ALWAYS_VISIBLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_ALWAYS_VISIBLE),
[SOFT_INPUT_STATE_HIDDEN](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_HIDDEN),
[SOFT_INPUT_STATE_UNSPECIFIED](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_UNSPECIFIED),
and [SOFT_INPUT_STATE_VISIBLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_VISIBLE).

### SOFT_INPUT_STATE_VISIBLE

- Type: Number
- Platforms: Android
- Permission: read-only

Attempt to show the soft input area (ie software keyboard) when the current heavyweight
window receives focus.

Used with the [Titanium.UI.Window.windowSoftInputMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#windowSoftInputMode) property.

This constant is one of the group of soft input visibility constants,
[SOFT_INPUT_STATE_ALWAYS_HIDDEN](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_ALWAYS_HIDDEN),
[SOFT_INPUT_STATE_ALWAYS_VISIBLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_ALWAYS_VISIBLE),
[SOFT_INPUT_STATE_HIDDEN](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_HIDDEN),
[SOFT_INPUT_STATE_UNSPECIFIED](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_UNSPECIFIED),
and [SOFT_INPUT_STATE_VISIBLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.md#SOFT_INPUT_STATE_VISIBLE).

### SOFT_KEYBOARD_DEFAULT_ON_FOCUS

- Type: Number
- Platforms: Android
- Permission: read-only

Use Android default behavior to handle keyboard visibility when a view receives focus.
(default)

### SOFT_KEYBOARD_HIDE_ON_FOCUS

- Type: Number
- Platforms: Android
- Permission: read-only

Attempt to hide the soft keyboard when a view receives focus. Note: system can override
request.

### SOFT_KEYBOARD_SHOW_ON_FOCUS

- Type: Number
- Platforms: Android
- Permission: read-only

Attempt to show the soft keyboard when a view receives focus. Note: system can override
request.

### STATUS_BAR_LIGHT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.7.0
- Permission: read-only

Sets the color of the status bar to light mode. Needs Android API level 23.

### SWITCH_STYLE_CHECKBOX

- Type: Number
- Platforms: Android
- Permission: read-only
- DEPRECATED since 10.0.0. Use <Titanium.UI.SWITCH_STYLE_CHECKBOX> instead.

Display a checkbox.

Use with the [Titanium.UI.Switch.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Switch.md#style) property.

### SWITCH_STYLE_SWITCH

- Type: Number
- Platforms: Android
- Since: Titanium SDK 4.0.0
- Permission: read-only
- DEPRECATED since 10.0.0. Use <Titanium.UI.SWITCH_STYLE_SLIDER> instead.

Display a switch.

Use with the [Titanium.UI.Switch.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Switch.md#style) property.

### SWITCH_STYLE_TOGGLEBUTTON

- Type: Number
- Platforms: Android
- Permission: read-only
- DEPRECATED since 10.0.0. Use <Titanium.UI.SWITCH_STYLE_TOGGLE_BUTTON> instead.

Display a toggle button.

Use with the [Titanium.UI.Switch.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Switch.md#style) property.

### TAB_MODE_FIXED

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.2.0

Set the TabGroup tab mode to fixed (default).

### TAB_MODE_SCROLLABLE

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.2.0

Set the TabGroup tab mode to scrollable.

### TABS_STYLE_BOTTOM_NAVIGATION

- Type: Number
- Platforms: Android
- Since: Titanium SDK 8.0.0
- Permission: read-only

TabGroup style taking advantage of a bottom navigation controller for switching between tabs.

### TABS_STYLE_DEFAULT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 8.0.0
- Permission: read-only

The default TabGroup style that places the Tabs bellow the ActionBar and above the Window content.

### TRANSITION_CHANGE_BOUNDS

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.2.0
- Permission: read-only

Captures layout bounds of target views before and after the scene change and animates those changes during the transition.

Use this only for shared element transition.
Refers to [ChangeBounds](https://developer.android.com/reference/android/transition/ChangeBounds.html) transition.

### TRANSITION_CHANGE_CLIP_BOUNDS

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.2.0
- Permission: read-only

Captures the clip bounds before and after the scene change and animates those changes during the transition.

Use this only for shared element transition.
Refers to [ChangeClipBounds](https://developer.android.com/reference/android/transition/ChangeClipBounds.html) transition.

### TRANSITION_CHANGE_IMAGE_TRANSFORM

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.2.0
- Permission: read-only

Captures an ImageView's matrix before and after the scene change and animates it during the transition.

Use this only for shared element transition.
Refers to [ChangeImageTransform](https://developer.android.com/reference/android/transition/ChangeImageTransform.html) transition.

### TRANSITION_CHANGE_TRANSFORM

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.2.0
- Permission: read-only

Captures scale and rotation for Views before and after the scene change and animates those changes during the transition.

Use this only for shared element transition.
Refers to [ChangeTransform](https://developer.android.com/reference/android/transition/ChangeTransform.html) transition.

### TRANSITION_EXPLODE

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.2.0
- Permission: read-only

Moves views in or out from the edges of the scene.

Use this only for activity transition.
Refers to [Explode](https://developer.android.com/reference/android/transition/Explode.html) transition.

### TRANSITION_FADE_IN

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.2.0
- Permission: read-only

Fades in the views.

Use this only for activity transition.
Refers to [Fade](https://developer.android.com/reference/android/transition/Fade.html) transition.

### TRANSITION_FADE_OUT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.2.0
- Permission: read-only

Fades out the views.

Use this only for activity transition.
Refers to [Fade](https://developer.android.com/reference/android/transition/Fade.html) transition.

### TRANSITION_NONE

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.2.0
- Permission: read-only

Resets transition to platform default.

Can be used with activity and shared element transtion.

### TRANSITION_SLIDE_BOTTOM

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.2.0
- Permission: read-only

Moves views to bottom.

Use this only for activity transition.
Refers to [Slide](https://developer.android.com/reference/android/transition/Slide.html) transition.

### TRANSITION_SLIDE_LEFT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.2.0
- Permission: read-only

Moves views to left.

Use this only for activity transition.
Refers to [Slide](https://developer.android.com/reference/android/transition/Slide.html) transition.

### TRANSITION_SLIDE_RIGHT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.2.0
- Permission: read-only

Moves views to right.

Use this only for activity transition.
Refers to [Slide](https://developer.android.com/reference/android/transition/Slide.html) transition.

### TRANSITION_SLIDE_TOP

- Type: Number
- Platforms: Android
- Since: Titanium SDK 5.2.0
- Permission: read-only

Moves views to top.

Use this only for activity transition.
Refers to [Slide](https://developer.android.com/reference/android/transition/Slide.html) transition.

### WEBVIEW_LOAD_CACHE_ELSE_NETWORK

- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.2.0
- Permission: read-only

Use with [WebView.cacheMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#cacheMode) to override how the cache is used in a web view.

Use cached resources when they're available, even when they're expired. Otherwise load resources via network.

### WEBVIEW_LOAD_CACHE_ONLY

- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.2.0
- Permission: read-only

Use with [WebView.cacheMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#cacheMode) to override how the cache is used in a web view.

Don't use network, load from the cache only.

### WEBVIEW_LOAD_DEFAULT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.2.0
- Permission: read-only

Use with [WebView.cacheMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#cacheMode) to override how the cache is used in a web view.

This is the default cache usage mode.

### WEBVIEW_LOAD_NO_CACHE

- Type: Number
- Platforms: Android
- Since: Titanium SDK 3.2.0
- Permission: read-only

Use with [WebView.cacheMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#cacheMode) to override how the cache is used in a web view.

Don't use cache, load from the network.

### WEBVIEW_PLUGINS_OFF

- Type: Number
- Platforms: Android
- Permission: read-only

Use with [WebView.pluginState](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#pluginState) to disable plugins in a web view.

Content that requires a plugin, is not loaded, and any
alternative content is displayed instead.

### WEBVIEW_PLUGINS_ON

- Type: Number
- Platforms: Android
- Permission: read-only

Use with [WebView.pluginState](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#pluginState) to enable plugins in a web view.

Content that requires a plugin,, is always loaded, whether or not a plugin is
available for the content.

### WEBVIEW_PLUGINS_ON_DEMAND

- Type: Number
- Platforms: Android
- Permission: read-only

Display a placeholder and only load plugins when user selects it.

Content that requires a plugin, is replaced by a placeholder. When
the user clicks on the placeholder, the plugin is loaded and the content is displayed.

Use with [WebView.pluginState](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#pluginState) to load plugins on demand.

### WEBVIEW_SCROLLBARS_DEFAULT

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.3.0
- Permission: read-only

Show horizontal and vertical scrollbar in a Ti.UI.WebView.

### WEBVIEW_SCROLLBARS_HIDE_ALL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.3.0
- Permission: read-only

Hide all scrollbars in a Ti.UI.WebView.

### WEBVIEW_SCROLLBARS_HIDE_HORIZONTAL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.3.0
- Permission: read-only

Hide horizontal scrollbar in a Ti.UI.WebView.

### WEBVIEW_SCROLLBARS_HIDE_VERTICAL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.3.0
- Permission: read-only

Hide vertical scrollbar in a Ti.UI.WebView.

## Methods

### createCardView

- Platforms: Android
- Since: Titanium SDK 5.1.0

Creates and returns an instance of [Titanium.UI.Android.CardView](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.CardView.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Android.CardView>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Android.CardView](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.CardView.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Android.CardView

### createCollapseToolbar

- Platforms: Android
- Since: Titanium SDK 12.1.0

Creates and returns an instance of [Titanium.UI.Android.CollapseToolbar](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.CollapseToolbar.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Android.CollapseToolbar>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Android.CollapseToolbar](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.CollapseToolbar.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Android.CollapseToolbar

### createDrawerLayout

- Platforms: Android
- Since: Titanium SDK 6.2.0

Creates and returns an instance of [Titanium.UI.Android.DrawerLayout](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.DrawerLayout.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Android.DrawerLayout>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Android.DrawerLayout](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.DrawerLayout.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Android.DrawerLayout

### createFloatingActionButton

- Platforms: Android
- Since: Titanium SDK 12.0.0

Creates and returns an instance of [Titanium.UI.Android.FloatingActionButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.FloatingActionButton.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Android.FloatingActionButton>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Android.FloatingActionButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.FloatingActionButton.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Android.FloatingActionButton

### createProgressIndicator

- Platforms: Android
- Since: Titanium SDK 3.0.0

Creates and returns an instance of [Titanium.UI.Android.ProgressIndicator](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.ProgressIndicator.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Android.ProgressIndicator>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Android.ProgressIndicator](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.ProgressIndicator.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Android.ProgressIndicator

### createSearchView

- Platforms: Android
- Since: Titanium SDK 3.0.2

Creates and returns an instance of [Titanium.UI.Android.SearchView](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.SearchView.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Android.SearchView>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Android.SearchView](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.SearchView.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Android.SearchView

### createSnackbar

- Platforms: Android
- Since: Titanium SDK 11.1.0

Creates and returns an instance of [Titanium.UI.Android.Snackbar](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.Snackbar.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Android.Snackbar>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Android.Snackbar](https://titaniumsdk.com/docs/sdk/Titanium.UI.Android.Snackbar.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Android.Snackbar

### getColorResource

- Platforms: Android
- Since: Titanium SDK 9.1.0

Returns a <Ti.Color> instance for a color defined by the system or user resources (colors.xml)

This method allows converting a known color resource id or short name to an actual color instance.

The resource id values can be accessed via [Titanium.Android.R.color](https://titaniumsdk.com/docs/sdk/Titanium.Android.R.md#color) and <Titanium.App.Android.R.color> properties.

See the official Android Developer documentation for
the [R.color](https://developer.android.com/reference/android/R.color) constants.

Parameters:

- `resourceIdOrColorName` (Number | String): integer resource id for a color, or the name of the color defined in the application resources (colors.xml).

Returns: Titanium.UI.Color

### harmonizedColor

- Platforms: Android
- Since: Titanium SDK 12.0.0

Creates a harmonizing color

Shifts the hue of the input color towards the hue of colorPrimary and returns a new color
as a hex string. Usage: `Ti.UI.Android.harmonizedColor("#ff0000");`

Parameters:

- `color` (String | Titanium.UI.Color): Input Color

Returns: String

### hideSoftKeyboard

- Platforms: Android

Hides the soft keyboard.

Be aware that it is not currently possible in the native Android API to detect that the
keyboard is already visible or to globally show the keyboard.

### moveToBackground

- Platforms: Android
- Since: Titanium SDK 12.4.0

Moves the app to the background

### openPreferences

- Platforms: Android

Opens an application preferences dialog, using the native Android system settings interface,
defined by the platform-specific `preferences.xml` and `array.xml` files.

The preferences configuration files must be created in the project folders,
`platform/android/res/xml/preferences.xml` and `platform/android/res/values/array/array.xml`.

The preferences values can be accessed via [Titanium.App.Properties](https://titaniumsdk.com/docs/sdk/Titanium.App.Properties.md).

See the example for a demonstration, and the official Android Developer documentation for
the [preferences.xml](https://developer.android.com/guide/topics/ui/settings.html#DefiningPrefs)
format.

## Inherited members

7 members are inherited. Each is documented on the type that declares it.

- [Titanium.Proxy](https://titaniumsdk.com/docs/sdk/13.1.0/Titanium.Proxy.md): `addEventListener`, `apiName`, `applyProperties`, `bubbleParent`, `fireEvent`, `lifecycleContainer`, `removeEventListener`

---

- This corpus documents Titanium SDK 13.4.1. Anything here that does not name a version describes 13.4.1.
- Titanium is maintained by TiDev. The Appcelerator toolchain is retired: there is no `appc` CLI, no Appcelerator Studio and no hosted build service. The supported CLI is `titanium` on npm, invoked as `ti`.