App Inventor 2 指令中文化 ContactPicker 聯絡人選擇器

ContactPicker 聯絡人選擇器

ContactPicker 元件可讓使用者選擇 Android 通訊錄的一筆資料。

ContactPicker 元件是一個用來顯示裝置上通訊錄的按鈕,並可讓使用者選擇特定內容。

當使用者點選之後,請參考下列屬性:

• ContactName :聯絡人姓名。

• EmailAddress:聯絡人的主要電子郵件。

• Picture: 聯 絡 人 大 頭 照, 照 片 property value for the Image or Image Sprite  component. 

尚有其他屬性可用來設定ContactPicker元件之外觀,包括文字對齊、背景圖片以及事件(是否可點選)。


屬性

EmailAddressList
聯絡人的電子郵件地址列表。

ContactPicker.EmailAddressList : 取得聯絡人的電子郵件地址列表。


PhoneNumber
聯絡人的主要電話號碼(較新的Android版本)。

ContactPicker.PhoneNumber : 取得聯絡人主要電話號碼


PhoneNumberList
聯絡人的電話號碼列表

ContactPicker.PhoneNumberList : 取得聯絡人電話號碼列表


ShowFeedback
於背景設定一個視覺化的按鈕


Enabled
設定是否可以使用。

ContactPicker.Enabled:取得 ContactPicker 現在是否可使用(boolean)
Set ContactPicker.Enabled:設定 ContactPicker 為可/不可使用


Image
設定圖片。

ContactPicker.Image:取得 ContactPicker 的底圖。
Set ContactPicker.Image:設定 ContactPicker 的底圖。


BackgroundColor
設定背景顏色。

ContactPicker.BackgroundColor : 取得 ContactPicker 背景顏色
Set ContactPicker.BackgroundColor 設定 ContactPicker 背景顏色


ContactName 
聯絡人名稱。

ContactPicker.ContactName : 取得聯絡人名稱。


EmailAddress
聯絡人的電子郵件地址。

ContactPicker.EmailAddress : 取得聯絡人的電子郵件地址。


Picture
聯絡人的圖片。

ContactPicker.Picture : 取得聯絡人的圖片。


FontBold 
設定文字粗體。


FontItalic
設定文字斜體。


FontSize 
設定文字大小。


FontTypeface
設定文字字形。

Text
設定文字顯示。

ContactPicker.Text :取得 ContactPicker 的文字內容。
Set ContactPicker.Text :設定 ContactPicker 的文字內容。


TextAlignment 
設定對其方式(左、中、右)。

TextColor 
設定文字的顏色。

Set ContactPicker.TextColor  設定 ContactPicker 的文字顏色。
ContactPicker.TextColor 取得 ContactPicker 現在的文字顏色。


Visible
本項需設為真,才能在螢幕上看到本元件。

ContactPicker.Visible 取得 ContactPicker 現在是否可被看見(boolean)
Set ContactPicker.Visible設定 ContactPicker 為可/不可被看見


Width 
元件寬度(x 軸像素)。

ContactPicker.Width:取得 ContactPicker 現在寬度(integer)
Set ContactPicker.Width:設定 ContactPicker 寬度 


Height 
元件高度(y 軸像素)。

ContactPicker.Height:取得 ContactPicker 現在高度(integer)
Set ContactPicker.Height設定 ContactPicker 高度



事件

AfterPicking()
when ContactPicker.AfterPicking : 使用者點選ContactPicker中某項目完成後呼叫本事件。代表使用者選取了某位聯絡人。


BeforePicking()
when ContactPicker.BeforePicking : 使用者點選 ContactPicker,但還沒點選某項目時呼叫本事件。


GotFocus()
when ContactPicker.GotFocus : 當指頭移到 ContactPicker 之上,代表現在可以點選本元件時呼叫本事件。


LostFocus()
when ContactPicker.LostFocus : 當指頭移出 ContactPicker,代表不能點選本元件時呼叫本事件。


TouchDown(number x, number y)
When ContactPicker.TouchDown : 當使用者點擊 ContactPicker 時,手指放置在 ContactPicker 上,並讓手指留在那裏回傳(x,y)座標代表使用者所點擊的位置。


TouchUp(number x, number y)
When ContactPicker.Up : 當使用者點擊 ContactPicker,手指離開 ContactPicker 時回傳(x,y)座標代表使用者手指離開的位置。



方法

Open()
ContactPicker.Open : 開啟 ContactPicker,效果同使用者親自點選一樣。