Titanium SDK # Titanium.Android.R
The Titanium binding of the native Android R class, giving access to
Android system-wide resources or application resources.
1.5# Overview
To access system-wide resources your application's resources, use Titanium.Android.R. To access your application's resources, use Titanium.App.Android.R.
These properties and sub-properties correspond directly to the properties
of the the android.R class, and should have the same syntax.
To retrieve the "OK" string from system resources in Android:
Ti.Android.currentActivity.getString(Ti.Android.R.string.ok);
If the file platform/android/res/drawable/icon.png exists in the
project, it can be accessed using its resource name, as follows:
var resid = Titanium.App.Android.R.drawable.icon;
See also: android.R (opens new window) in the Android Developer Reference. For more information, refer to the official documentation on the Android Developer website about accessing application resources (opens new window).
Starting in Titanium SDK 7.3.0, this API exposes all Android related R classes
for the usage in Hyperloop. For example, it can be used to access menu resources
as part of native user interfaces, e.g. BottomNavigationView or RecyclerView.
See an example in the Hyperloop Sample App (opens new window) for details!
# Properties
# anim READONLY
1.5Animation resources. See R.anim in the Android Developer Reference.
# animator READONLY
7.3.0Animator resources. See R.animator in the Android Developer Reference.
# apiName READONLY
3.2.0The name of the API that this proxy corresponds to.
The value of this property is the fully qualified name of the API. For example, Titanium.UI.Button
returns Ti.UI.Button.
# attr READONLY
1.5Attribute resources. See R.attr in the Android Developer Reference.
# bool READONLY
7.3.0Boolean resources. See R.bool in the Android Developer Reference.
# bubbleParent
3.0.0Indicates if the proxy will bubble an event to its parent.
Some proxies (most commonly views) have a relationship to other proxies, often established by the add() method. For example, for a button added to a window, a click event on the button would bubble up to the window. Other common parents are table sections to their rows, table views to their sections, and scrollable views to their views. Set this property to false to disable the bubbling to the proxy's parent.
Default: true
# dimen READONLY
1.5Dimension resources. See https://developer.android.com/reference/android/R.dimen.html in the Android Developer Reference.
# drawable READONLY
1.5Drawable resources. See R.drawable in the Android Developer Reference.
# fraction READONLY
7.3.0Fraction resources. See R.fraction in the Android Developer Reference.
# integer READONLY
1.5Integer resources. See R.integer in the Android Developer Reference.
# interpolator READONLY
7.3.0Interpolator resources. See R.fraction in the Android Developer Reference.
# layout READONLY
1.5Layout resources. See R.layout in the Android Developer Reference.
# lifecycleContainer
3.6.0The Window or TabGroup whose Activity lifecycle should be triggered on the proxy.
If this property is set to a Window or TabGroup, then the corresponding Activity lifecycle event callbacks will also be called on the proxy. Proxies that require the activity lifecycle will need this property set to the appropriate containing Window or TabGroup.
# mipmap READONLY
7.3.0Mipmap resources. See R.mipmap in the Android Developer Reference.
# plurals READONLY
7.3.0Plurals resources. See R.plurals in the Android Developer Reference.
# string READONLY
1.5String resources. See R.string in the Android Developer Reference.
# styleable READONLY
1.5Styleable resources. See R.styleable in the Android Developer Reference.
# transition READONLY
7.3.0Transition resources. See R.transition in the Android Developer Reference.
# Methods
# addEventListener
1.5Adds the specified callback as an event listener for the named event.
Parameters
| Name | Type | Description |
|---|---|---|
name | String | Name of the event. |
callback | Callback<Titanium.Event> | Callback function to invoke when the event is fired. |
Returns
- Type
- void
# applyProperties
3.0.0Applies the properties to the proxy.
Properties are supplied as a dictionary. Each key-value pair in the object is applied to the proxy such that myproxy[key] = value.
Parameters
| Name | Type | Description |
|---|---|---|
props | Dictionary | A dictionary of properties to apply. |
Returns
- Type
- void
# fireEvent
1.5Fires a synthesized event to any registered listeners.
Parameters
| Name | Type | Description |
|---|---|---|
name | String | Name of the event. |
event | Dictionary | A dictionary of keys and values to add to the Titanium.Event object sent to the listeners. |
Returns
- Type
- void
# removeEventListener
1.5Removes the specified callback as an event listener for the named event.
Multiple listeners can be registered for the same event, so the
callback parameter is used to determine which listener to remove.
When adding a listener, you must save a reference to the callback function in order to remove the listener later:
var listener = function() { Ti.API.info("Event listener called."); }
window.addEventListener('click', listener);
To remove the listener, pass in a reference to the callback function:
window.removeEventListener('click', listener);
Parameters
| Name | Type | Description |
|---|---|---|
name | String | Name of the event. |
callback | Callback<Titanium.Event> | Callback function to remove. Must be the same function passed to |
Returns
- Type
- void