> For the complete documentation index, see [llms.txt](https://help.appybuilder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.appybuilder.com/components/reference/social/phonenumberpicker.md).

# PhoneNumberPicker

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:

* ContactName: the contact's name
* PhoneNumber: the contact's phone number
* EmailAddress: the contact's email address
* 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 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.

## Properties

### BackgroundColor

Returns the button's background color

### ContactName

### EmailAddress

### Enabled

### FontBold (designer only)

### FontItalic (designer only)

### FontSize (designer only)

### FontTypeface (designer only)

### Height

### Image

Specifies the path of the button's image. If there is both an Image and a BackgroundColor, only the Image will be visible.

### PhoneNumber

### Picture

### Shape (designer only)

Specifies the button's shape (default, rounded, rectangular, oval). The shape will not be visible if an Image is being displayed.

### ShowFeedback

Specifies if a visual feedback should be shown for a button that as an image as background.

### Text

TextAlignment (designer only)

### TextColor

### Visible

Specifies whether the component should be visible on the screen. Value is true if the component is showing and false if hidden.

### Width

## Events

### AfterPicking()

Simple event to be raised after the picker activity returns its result and the properties have been filled in.

### BeforePicking()

Simple event to raise when the component is clicked but before the picker activity is started.

### GotFocus()

Indicates the cursor moved over the button so it is now possible to click it.

### LostFocus()

Indicates the cursor moved away from the button so it is now no longer possible to click it.

## Methods

### Open()

Opens the picker, as though the user clicked on it.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.appybuilder.com/components/reference/social/phonenumberpicker.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.