AI2 Component  (Version nb184)
com.google.appinventor.components.runtime.PhoneNumberPicker Class Reference
Inheritance diagram for com.google.appinventor.components.runtime.PhoneNumberPicker:
com.google.appinventor.components.runtime.ContactPicker com.google.appinventor.components.runtime.Picker com.google.appinventor.components.runtime.ActivityResultListener com.google.appinventor.components.runtime.ButtonBase com.google.appinventor.components.runtime.ActivityResultListener com.google.appinventor.components.runtime.AndroidViewComponent com.google.appinventor.components.runtime.VisibleComponent com.google.appinventor.components.runtime.Component

Public Member Functions

 PhoneNumberPicker (ComponentContainer container)
 
String PhoneNumber ()
 
void resultReturned (int requestCode, int resultCode, Intent data)
 
void preHoneycombGetContactInfo (Cursor cursor)
 
String postHoneycombGetContactNameAndPicture (Cursor contactCursor)
 
void postHoneycombGetContactEmailsAndPhones (Cursor dataCursor)
 
- Public Member Functions inherited from com.google.appinventor.components.runtime.ContactPicker
 ContactPicker (ComponentContainer container)
 
void click ()
 
String Picture ()
 
String ContactName ()
 
String EmailAddress ()
 
String ContactUri ()
 
List EmailAddressList ()
 
List PhoneNumberList ()
 
void ViewContact (String uri)
 
void preHoneycombGetContactInfo (Cursor contactCursor, Uri theContactUri)
 
void postHoneycombGetContactEmailAndPhone (Cursor dataCursor)
 
- Public Member Functions inherited from com.google.appinventor.components.runtime.Picker
 Picker (ComponentContainer container)
 
void Open ()
 
void BeforePicking ()
 
void AfterPicking ()
 
- Public Member Functions inherited from com.google.appinventor.components.runtime.ButtonBase
 ButtonBase (ComponentContainer container)
 
boolean onTouch (View view, MotionEvent me)
 
View getView ()
 
void TouchDown ()
 
void TouchUp ()
 
void GotFocus ()
 
void LostFocus ()
 
int TextAlignment ()
 
void TextAlignment (int alignment)
 
int Shape ()
 
void Shape (int shape)
 
String Image ()
 
void Image (String path)
 
int BackgroundColor ()
 
void BackgroundColor (int argb)
 
boolean Enabled ()
 
void Enabled (boolean enabled)
 
boolean FontBold ()
 
void FontBold (boolean bold)
 
void ShowFeedback (boolean showFeedback)
 
boolean ShowFeedback ()
 
boolean FontItalic ()
 
void FontItalic (boolean italic)
 
float FontSize ()
 
void FontSize (float size)
 
int FontTypeface ()
 
void FontTypeface (int typeface)
 
String Text ()
 
void Text (String text)
 
int TextColor ()
 
void TextColor (int argb)
 
boolean longClick ()
 
void onClick (View view)
 
void onFocusChange (View previouslyFocused, boolean gainFocus)
 
boolean onLongClick (View view)
 
- Public Member Functions inherited from com.google.appinventor.components.runtime.AndroidViewComponent
boolean Visible ()
 
void Visible (boolean visibility)
 
int Width ()
 
void Width (int width)
 
void WidthPercent (int pCent)
 
void setLastWidth (int width)
 
int getSetWidth ()
 
void setLastHeight (int height)
 
int getSetHeight ()
 
void CopyWidth (AndroidViewComponent sourceComponent)
 
int Height ()
 
void Height (int height)
 
void HeightPercent (int pCent)
 
void CopyHeight (AndroidViewComponent sourceComponent)
 
int Column ()
 
void Column (int column)
 
int Row ()
 
void Row (int row)
 
HandlesEventDispatching getDispatchDelegate ()
 

Additional Inherited Members

- Static Public Attributes inherited from com.google.appinventor.components.runtime.Component
static final String ASSET_DIRECTORY = "component"
 
static final int ALIGNMENT_NORMAL = 0
 
static final int ALIGNMENT_CENTER = 1
 
static final int ALIGNMENT_OPPOSITE = 2
 
static final int ACCELEROMETER_SENSITIVITY_WEAK = 1
 
static final int ACCELEROMETER_SENSITIVITY_MODERATE = 2
 
static final int ACCELEROMETER_SENSITIVITY_STRONG = 3
 
static final int BUTTON_SHAPE_DEFAULT = 0
 
static final int BUTTON_SHAPE_ROUNDED = 1
 
static final int BUTTON_SHAPE_RECT = 2
 
static final int BUTTON_SHAPE_OVAL = 3
 
static final int COLOR_NONE = 0x00FFFFFF
 
static final int COLOR_BLACK = 0xFF000000
 
static final int COLOR_BLUE = 0xFF0000FF
 
static final int COLOR_CYAN = 0xFF00FFFF
 
static final int COLOR_DKGRAY = 0xFF444444
 
static final int COLOR_GRAY = 0xFF888888
 
static final int COLOR_GREEN = 0xFF00FF00
 
static final int COLOR_LTGRAY = 0xFFCCCCCC
 
static final int COLOR_MAGENTA = 0xFFFF00FF
 
static final int COLOR_ORANGE = 0xFFFFC800
 
static final int COLOR_PINK = 0xFFFFAFAF
 
static final int COLOR_RED = 0xFFFF0000
 
static final int COLOR_WHITE = 0xFFFFFFFF
 
static final int COLOR_YELLOW = 0xFFFFFF00
 
static final int COLOR_DEFAULT = 0x00000000
 
static final String DEFAULT_VALUE_COLOR_NONE = "&H00FFFFFF"
 
static final String DEFAULT_VALUE_COLOR_BLACK = "&HFF000000"
 
static final String DEFAULT_VALUE_COLOR_BLUE = "&HFF0000FF"
 
static final String DEFAULT_VALUE_COLOR_CYAN = "&HFF00FFFF"
 
static final String DEFAULT_VALUE_COLOR_DKGRAY = "&HFF444444"
 
static final String DEFAULT_VALUE_COLOR_GRAY = "&HFF888888"
 
static final String DEFAULT_VALUE_COLOR_GREEN = "&HFF00FF00"
 
static final String DEFAULT_VALUE_COLOR_LTGRAY = "&HFFCCCCCC"
 
static final String DEFAULT_VALUE_COLOR_MAGENTA = "&HFFFF00FF"
 
static final String DEFAULT_VALUE_COLOR_ORANGE = "&HFFFFC800"
 
static final String DEFAULT_VALUE_COLOR_PINK = "&HFFFFAFAF"
 
static final String DEFAULT_VALUE_COLOR_RED = "&HFFFF0000"
 
static final String DEFAULT_VALUE_COLOR_WHITE = "&HFFFFFFFF"
 
static final String DEFAULT_VALUE_COLOR_YELLOW = "&HFFFFFF00"
 
static final String DEFAULT_VALUE_COLOR_DEFAULT = "&H00000000"
 
static final float FONT_DEFAULT_SIZE = 14
 
static final int LAYOUT_ORIENTATION_HORIZONTAL = ComponentConstants.LAYOUT_ORIENTATION_HORIZONTAL
 
static final int LAYOUT_ORIENTATION_VERTICAL = ComponentConstants.LAYOUT_ORIENTATION_VERTICAL
 
static final int SCALING_SCALE_PROPORTIONALLY = 0
 
static final int SCALING_SCALE_TO_FIT = 1
 
static final int TYPEFACE_DEFAULT = 0
 
static final int TYPEFACE_SANSSERIF = 1
 
static final int TYPEFACE_SERIF = 2
 
static final int TYPEFACE_MONOSPACE = 3
 
static final int LENGTH_PREFERRED = -1
 
static final int LENGTH_FILL_PARENT = -2
 
static final int LENGTH_UNKNOWN = -3
 
static final int LENGTH_PERCENT_TAG = -1000
 
static final int TOAST_LENGTH_SHORT = 0
 
static final int TOAST_LENGTH_LONG = 1
 
static final int DIRECTION_NORTH = 1
 
static final int DIRECTION_NORTHEAST = 2
 
static final int DIRECTION_EAST = 3
 
static final int DIRECTION_SOUTHEAST = 4
 
static final int DIRECTION_SOUTH = -1
 
static final int DIRECTION_SOUTHWEST = -2
 
static final int DIRECTION_WEST = -3
 
static final int DIRECTION_NORTHWEST = -4
 
static final int DIRECTION_NONE = 0
 
static final int DIRECTION_MIN = -4
 
static final int DIRECTION_MAX = 4
 
static float SLIDER_MIN_VALUE = 10
 
static float SLIDER_MAX_VALUE = 50
 
static float SLIDER_THUMB_VALUE = (SLIDER_MIN_VALUE + SLIDER_MAX_VALUE) / 2.0f
 
static final String DEFAULT_VALUE_TEXT_TO_SPEECH_COUNTRY = ""
 
static final String DEFAULT_VALUE_TEXT_TO_SPEECH_LANGUAGE = ""
 
- Protected Member Functions inherited from com.google.appinventor.components.runtime.ContactPicker
 ContactPicker (ComponentContainer container, Uri intentUri)
 
Intent getIntent ()
 
boolean checkContactUri (Uri suspectUri, String requiredPattern)
 
void puntContactSelection (int errorNumber)
 
String getEmailAddress (String emailId)
 
String guardCursorGetString (Cursor cursor, int index)
 
String ensureNotNull (String value)
 
List ensureNotNull (List value)
 
- Protected Member Functions inherited from com.google.appinventor.components.runtime.AndroidViewComponent
 AndroidViewComponent (ComponentContainer container)
 
- Protected Member Functions inherited from com.google.appinventor.components.runtime.VisibleComponent
 VisibleComponent ()
 
- Protected Attributes inherited from com.google.appinventor.components.runtime.ContactPicker
final Activity activityContext
 
String contactName
 
String emailAddress
 
String contactUri
 
String contactPictureUri
 
String phoneNumber
 
List emailAddressList
 
List phoneNumberList
 
- Protected Attributes inherited from com.google.appinventor.components.runtime.Picker
final ComponentContainer container
 
int requestCode
 
- Protected Attributes inherited from com.google.appinventor.components.runtime.AndroidViewComponent
final ComponentContainer container
 

Detailed Description

A button that, when clicked on, displays a list of the contacts' phone numbers to choose among. After the user has made a selection, the following properties will be set to information about the chosen contact:

Other properties affect the appearance of the button (TextAlignment(), BackgroundColor(), etc.) and whether it can be clicked on (Enabled()).

The PhoneNumberPicker component may not work on all Android devices. For example, on Android systems before system 3.0, the returned lists of phone numbers and email addresses will be empty.

Author
sharo.nosp@m.n@go.nosp@m.ogle..nosp@m.com (Sharon Perl)
markf.nosp@m.@goo.nosp@m.gle.c.nosp@m.om (Mark Friedman)

Definition at line 71 of file PhoneNumberPicker.java.

Constructor & Destructor Documentation

◆ PhoneNumberPicker()

com.google.appinventor.components.runtime.PhoneNumberPicker.PhoneNumberPicker ( ComponentContainer  container)

Create a new ContactPicker component.

Parameters
containerthe parent container.

Definition at line 92 of file PhoneNumberPicker.java.

Member Function Documentation

◆ PhoneNumber()

String com.google.appinventor.components.runtime.PhoneNumberPicker.PhoneNumber ( )

Returns the primary phone number associated with the selected contact, or the empty string if no phone number is associated with the contact.

Reimplemented from com.google.appinventor.components.runtime.ContactPicker.

Definition at line 102 of file PhoneNumberPicker.java.

◆ postHoneycombGetContactEmailsAndPhones()

void com.google.appinventor.components.runtime.PhoneNumberPicker.postHoneycombGetContactEmailsAndPhones ( Cursor  dataCursor)

Assigns emailAddress, phoneNumber, emailAddressList, and phoneNumberList for Honeycomb and up.

Definition at line 213 of file PhoneNumberPicker.java.

◆ postHoneycombGetContactNameAndPicture()

String com.google.appinventor.components.runtime.PhoneNumberPicker.postHoneycombGetContactNameAndPicture ( Cursor  contactCursor)

Assigns contactName and contactPictureUri for Honeycomb and up. Returns id for getting emailAddress and phoneNumber.

Reimplemented from com.google.appinventor.components.runtime.ContactPicker.

Definition at line 194 of file PhoneNumberPicker.java.

◆ preHoneycombGetContactInfo()

void com.google.appinventor.components.runtime.PhoneNumberPicker.preHoneycombGetContactInfo ( Cursor  cursor)

For versions before Honeycomb, we get all the contact info from the same table.

Definition at line 178 of file PhoneNumberPicker.java.

◆ resultReturned()

void com.google.appinventor.components.runtime.PhoneNumberPicker.resultReturned ( int  requestCode,
int  resultCode,
Intent  data 
)

Callback method to get the result returned by the contact picker activity

Parameters
requestCodea code identifying the request.
resultCodea code specifying success or failure of the activity
datathe returned data, in this case an Intent whose data field contains the contact's content provider Uri.

Reimplemented from com.google.appinventor.components.runtime.ContactPicker.

Definition at line 121 of file PhoneNumberPicker.java.


The documentation for this class was generated from the following file: