Inheritance diagram for com.google.appinventor.components.runtime.ContactPicker:

Public Member Functions
	ContactPicker (ComponentContainer container)

void	click ()

String	Picture ()

String	ContactName ()

String	EmailAddress ()

String	ContactUri ()

List	EmailAddressList ()

String	PhoneNumber ()

List	PhoneNumberList ()

void	ViewContact (String uri)

void	resultReturned (int requestCode, int resultCode, Intent data)

void	preHoneycombGetContactInfo (Cursor contactCursor, Uri theContactUri)

String	postHoneycombGetContactNameAndPicture (Cursor contactCursor)

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

Protected Member Functions
	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
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

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 = ""

Detailed Description

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

ContactName(): the contact's name
EmailAddress(): the contact's primary email address
EmailAddressList(): a list of the contact's email addresses
ContactUri(): the contact's URI on the device
PhoneNumber(): the contact's primary phone number (on Later Android Verisons)
PhoneNumberList(): a list of the contact's phone numbers (on Later Android Versions)
Picture(): the name of the file containing the contact's image, which can be used as a Picture property value for the Image or ImageSprite component.

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

The ContactPicker component might not work on all phones. For example, on Android systems before system 3.0, it cannot pick phone numbers, and the list of email addresses will contain only one email.

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); Yifan(Evan) Li (for contact Uri)

Definition at line 80 of file ContactPicker.java.

Constructor & Destructor Documentation

◆ ContactPicker() [1/2]

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

Create a new ContactPicker component.

Parameters

container the parent container.

Definition at line 112 of file ContactPicker.java.

◆ ContactPicker() [2/2]

com.google.appinventor.components.runtime.ContactPicker.ContactPicker	(	ComponentContainer	container,
		Uri	intentUri
	)

protected

Definition at line 116 of file ContactPicker.java.

Member Function Documentation

◆ checkContactUri()

boolean com.google.appinventor.components.runtime.ContactPicker.checkContactUri	(	Uri	suspectUri,
		String	requiredPattern
	)

protected

Definition at line 401 of file ContactPicker.java.

◆ click()

void com.google.appinventor.components.runtime.ContactPicker.click ( )

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

Definition at line 130 of file ContactPicker.java.

◆ ContactName()

String com.google.appinventor.components.runtime.ContactPicker.ContactName ( )

Returns the full name of the selected contact, or the empty string if a name is unavailable.

Definition at line 166 of file ContactPicker.java.

◆ ContactUri()

String com.google.appinventor.components.runtime.ContactPicker.ContactUri ( )

Returns a URI that specifies the location of the contact on the device.

Definition at line 193 of file ContactPicker.java.

◆ EmailAddress()

String com.google.appinventor.components.runtime.ContactPicker.EmailAddress ( )

Returns the primary email address of the selected contact, or the empty string if an email address is unavailable.

Definition at line 176 of file ContactPicker.java.

◆ EmailAddressList()

List com.google.appinventor.components.runtime.ContactPicker.EmailAddressList ( )

Returns a list of email addresses associated with the selected contact.

Definition at line 202 of file ContactPicker.java.

◆ ensureNotNull() [1/2]

List com.google.appinventor.components.runtime.ContactPicker.ensureNotNull ( List value )

protected

Definition at line 491 of file ContactPicker.java.

◆ ensureNotNull() [2/2]

String com.google.appinventor.components.runtime.ContactPicker.ensureNotNull ( String value )

protected

Definition at line 483 of file ContactPicker.java.

◆ getEmailAddress()

String com.google.appinventor.components.runtime.ContactPicker.getEmailAddress ( String emailId )

protected

Email address getter for pre-Honeycomb.

Definition at line 432 of file ContactPicker.java.

◆ getIntent()

Intent com.google.appinventor.components.runtime.ContactPicker.getIntent ( )

protected

Provides the Intent used to launch the picker activity.

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

Definition at line 239 of file ContactPicker.java.

◆ guardCursorGetString()

String com.google.appinventor.components.runtime.ContactPicker.guardCursorGetString	(	Cursor	cursor,
		int	index
	)

protected

Definition at line 470 of file ContactPicker.java.

◆ PhoneNumber()

String com.google.appinventor.components.runtime.ContactPicker.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 in com.google.appinventor.components.runtime.PhoneNumberPicker.

Definition at line 212 of file ContactPicker.java.

◆ PhoneNumberList()

List com.google.appinventor.components.runtime.ContactPicker.PhoneNumberList ( )

Returns a list of phone numbers associated with the selected contact.

Definition at line 221 of file ContactPicker.java.

◆ Picture()

String com.google.appinventor.components.runtime.ContactPicker.Picture ( )

Returns a picture URI for the selected contact, which can be used to retrieve the contact's photo and other fields.

Definition at line 157 of file ContactPicker.java.

◆ postHoneycombGetContactEmailAndPhone()

void com.google.appinventor.components.runtime.ContactPicker.postHoneycombGetContactEmailAndPhone ( Cursor dataCursor )

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

Definition at line 347 of file ContactPicker.java.

◆ postHoneycombGetContactNameAndPicture()

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

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

Reimplemented in com.google.appinventor.components.runtime.PhoneNumberPicker.

Definition at line 327 of file ContactPicker.java.

◆ preHoneycombGetContactInfo()

void com.google.appinventor.components.runtime.ContactPicker.preHoneycombGetContactInfo	(	Cursor	contactCursor,
		Uri	theContactUri
	)

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

Definition at line 312 of file ContactPicker.java.

◆ puntContactSelection()

void com.google.appinventor.components.runtime.ContactPicker.puntContactSelection ( int errorNumber )

protected

Definition at line 422 of file ContactPicker.java.

◆ resultReturned()

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

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

Parameters

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

Implements com.google.appinventor.components.runtime.ActivityResultListener.

Reimplemented in com.google.appinventor.components.runtime.PhoneNumberPicker.

Definition at line 252 of file ContactPicker.java.

◆ ViewContact()

void com.google.appinventor.components.runtime.ContactPicker.ViewContact ( String uri )

Opens the selected contact's entry in the device's default Contacts app.

Definition at line 229 of file ContactPicker.java.

Member Data Documentation

◆ activityContext

final Activity com.google.appinventor.components.runtime.ContactPicker.activityContext

protected

Definition at line 93 of file ContactPicker.java.

◆ contactName

String com.google.appinventor.components.runtime.ContactPicker.contactName

protected

Definition at line 96 of file ContactPicker.java.

◆ contactPictureUri

String com.google.appinventor.components.runtime.ContactPicker.contactPictureUri

protected

Definition at line 99 of file ContactPicker.java.

◆ contactUri

String com.google.appinventor.components.runtime.ContactPicker.contactUri

protected

Definition at line 98 of file ContactPicker.java.

◆ emailAddress

String com.google.appinventor.components.runtime.ContactPicker.emailAddress

protected

Definition at line 97 of file ContactPicker.java.

◆ emailAddressList

List com.google.appinventor.components.runtime.ContactPicker.emailAddressList

protected

Definition at line 102 of file ContactPicker.java.

◆ phoneNumber

String com.google.appinventor.components.runtime.ContactPicker.phoneNumber

protected

Definition at line 100 of file ContactPicker.java.

◆ phoneNumberList

List com.google.appinventor.components.runtime.ContactPicker.phoneNumberList

protected

Definition at line 103 of file ContactPicker.java.

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

C:/Users/Ulli/appinventor-sources/appinventor/components/src/com/google/appinventor/components/runtime/ContactPicker.java

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ContactPicker() [1/2]

◆ ContactPicker() [2/2]

Member Function Documentation

◆ checkContactUri()

◆ click()

◆ ContactName()

◆ ContactUri()

◆ EmailAddress()

◆ EmailAddressList()

◆ ensureNotNull() [1/2]

◆ ensureNotNull() [2/2]

◆ getEmailAddress()

◆ getIntent()

◆ guardCursorGetString()

◆ PhoneNumber()

◆ PhoneNumberList()

◆ Picture()

◆ postHoneycombGetContactEmailAndPhone()

◆ postHoneycombGetContactNameAndPicture()

◆ preHoneycombGetContactInfo()

◆ puntContactSelection()

◆ resultReturned()

◆ ViewContact()

Member Data Documentation

◆ activityContext

◆ contactName

◆ contactPictureUri

◆ contactUri

◆ emailAddress

◆ emailAddressList

◆ phoneNumber

◆ phoneNumberList