组件目录
QQ互联登录 联系人选择框 邮箱地址选择框 电话拨号器 电话号选择框 信息分享器 短信收发器

QQ互联登录 QQConnect

QQ互联登录组件，用于QQ登录，使用前请访问QQ互联官网 https://connect.qq.com/ 申请一个AppID后即可使用。组件默认的AppID为QQ互联测试AppID。本组件由 张智强 开发。

属性

  • 应用ID APP_ID 文本 APP_ID是分配给第三方应用的appid，类型为文本类型，访问QQ互联官网https://connect.qq.com/可申请一个AppID
  • 访问令牌 AccessToken 文本 只代码, 只读 暂无描述
  • 失效时间 ExpiresIn 数字 只代码, 只读 暂无描述
  • OpenID OpenId 文本 只代码, 只读 暂无描述
  • QQ令牌 QQToken 任意 只代码, 只读 暂无描述

事件

  • 获得Uniconid GotUnionid 平台唯一标识 unionid: 文本 获得到Unionid
  • 获取Unionid失败 GotUnionidFailure 消息 massage: 文本 获取Unionid失败
  • 获取Unionid出错 GotUnionidError 消息 message: 文本, 错误码 code: 数字, 详细信息 detail: 文本 获取Unionid时出现错误
  • 登录成功 LoginSucceed JSON数据 json: 文本 登录成功
  • 登录失败 LoginFailure 消息 massage: 文本 登录失败
  • 登录出错 LoginError 消息 message: 文本, 错误码 code: 数字, 详细信息 detail: 文本 登录异常,登录常见错误码信息 110201：未登陆 110405：登录请求被限制 110404：请求参数缺少appid 110401：请求的应用不存在 110407：应用已经下架 110406：应用没有通过审核 100044：错误的sign 110500：获取用户授权信息失败 110501：获取应用的授权信息失败 110502：设置用户授权失败 110503：获取token失败 110504：系统内部错误
  • 登录被取消 LoginCancel 登录被取消
  • 分享成功 ShareSucceed JSON数据 json: 文本 分享成功
  • 分享失败 ShareFailure 消息 massage: 文本 分享失败
  • 分享出错 ShareError 消息 message: 文本, 错误码 code: 数字, 详细信息 detail: 文本 分享异常
  • 分享被取消 ShareCancel 分享被取消
  • 请求出错 RequestAsyncError 请求标识 requestId: 数字, 错误名称 errorName: 文本, 消息 message: 文本 请求异常
  • 请求成功 RequestAsyncSucceed 请求标识 requestId: 数字, JSON数据 json: 文本 请求成功

方法

  • 分享到QQ空间 QzoneShareImageText 标题 title: 文本, 链接地址 targetUrl: 文本, 摘要 summary: 文本, 网络图片URL列表 imageUrlsList: 列表 QQ空间图文信息分享，前三项为必填项第四项如不需要可接空列表
  • 分享音乐 QQShareMusic 标题 title: 文本, 链接地址 targetUrl: 文本, 网络音乐URL audioUrl: 文本, 摘要 summary: 文本, 网络图片URL imageUrl: 文本, 应用名称 appName: 文本, 是否显示分享到QZone按钮 openQzoneFlag: 布尔 title为必填项，分享的标题, 最长30个字符。 targetUrl为必填项，这条分享消息被好友点击后的跳转URL。 audioUrl为必填项，音乐文件的远程链接, 以URL的形式传入, 不支持本地音乐。 summary为选填项，分享的消息摘要，最长40个字。 imageUrl为选填项，分享图片的URL或者本地路径。 appName为选填项，手Q客户端顶部，替换“返回”按钮文字，如果为空，用返回代替。 openQzoneFlag如果为真，则分享时自动打开分享到QZone的对话框，否则分享时隐藏分享到QZone按钮
  • 分享图片 QQShareImage 本地图片路径 imageLocalUrl: 文本, 应用名称 appName: 文本, 是否显示分享到QZone按钮 openQzoneFlag: 布尔 imageLocalUrl为必填项，需要分享的本地图片路径。appName为选填项，手Q客户端顶部，替换“返回”按钮文字，如果为空，用返回代替openQzoneFlag如果为真，则分享时自动打开分享到QZone的对话框，否则分享时隐藏分享到QZone按钮
  • 分享图文 QQShareDefault 标题 title: 文本, 链接地址 targetUrl: 文本, 摘要 summary: 文本, 网络图片URL imageUrl: 文本, 应用名称 appName: 文本, 是否显示分享到QZone按钮 openQzoneFlag: 布尔 图文消息分享，title为必填项，分享的标题, 最长30个字符。targetUrl为必填项，这条分享消息被好友点击后的跳转URL。summary为选填项，分享的消息摘要，最长40个字。imageUrl为选填项，分享图片的URL或者本地路径appName为选填项，手Q客户端顶部，替换“返回”按钮文字，如果为空，用返回代替openQzoneFlag如果为真，则分享时自动打开分享到QZone的对话框，否则分享时隐藏分享到QZone按钮
  • 生成获取信息的URL BuildRequestUrl 文本 类别 type: 文本 构建请求URL，如获取用户信息需填写“get_user_info”，将获取OpenAPI的请求地址，需要使用web客户端请求实际数据，具体参数类型可登录http://wiki.connect.qq.com/api%E5%88%97%E8%A1%A8查询
  • 开始登录 Login 权限范围 scope: 文本 用户使用QQ账号登录应用需要获得哪些接口的权限，由“,”分隔，例如：SCOPE = “get_user_info,add_topic”；如果需要所有权限则使用"all"。
  • 开始服务器端登录 LoginServerSide 权限范围 scope: 文本 通过调用Tencent类的loginServerSide函数发起Server-Side模式登录。 调用该接口，会启动一个交互界面，完成用户登录和授权的交互流程， 当安装了手机QQ时，SDK会启用手机QQ的特定Activity，通过此Activity完成登录和授权功能。 当没有找到此Activity时，SDK会执行Oauth2.0的User-Agent流程，即显示一个包含WebView的对话框， 通过加载登录授权网页来完成登录和授权的交互流程。
  • 重新授权 Reauth 权限范围 scope: 文本 当应用调用API返回没有权限（返回码为100030)时，可以调用增量授权函数让用户重新进行授权。调用时所使用的参数跟登录是一样的，只是在授权页面那里只会显示要增量授权的项，即所传的scope参数。 注意：这里的scope参数跟登录时所传的scope参数作用是不一样的，这里只需要传需要增量授权的项，即用户之前没有授权的项。一般来说，就是前面调用失败的那个API的scope。
  • 退出登录 Logout 用户希望登录的QQ账号退出应用
  • 获取Unionid GetUnionid 获取Unionid（平台统一ID信息），如果开发者拥有多个移动应用、网站应用和公众帐号，可通过获取用户基本信息中的unionid来区分用户的唯一性，因为同一用户，对同一个QQ互联下的不同应用（移动应用、网站应用和公众帐号），unionid是相同的。，若成功获取则调用GotUnionid事件，若失败则调用与GotUnionidFailure事件
  • 发送异步请求 RequestAsync 数字 图片路径 graphPath: 文本, 参数列表 parameters: 列表, HTTP方法 httpMethod: 文本 异步发送请求，请根据本函数返回的ID值在事件“请求出错”和“请求成功”中做判断处理
  • 检查会话缓存是否可用 CheckSessionValid 布尔 检查Token缓存是否可用，若返回false，说明token过期，请调用登录接口拉起手Q授权登录
  • 加载会话缓存 LoadSession 文本 提取Token缓存的json
  • 从JSON加载缓存的会话 InitSessionCache JSON数据 json: 文本 通过缓存的JSON信息加载会话
  • 检查会话是否可用 IsSessionValid 布尔 判断会话可用性
  • 是否已安装手机QQ IsQQInstalled 布尔 判断是否装有手机QQ
  • 是否准备就绪 IsReady 布尔 暂无描述
  • 是否支持单点登录 IsSupportSSOLogin 布尔 是否支持SSO登录

联系人选择框 ContactPicker

一个按钮，点击后显示可供选择的联系人列表。用户选择后，以下属性将设置为所选联系人的信息：

属性

  • 背景颜色 BackgroundColor 颜色 将ContactPicker的背景颜色指定为一个包含alpha（透明度）、红、绿、蓝的整数。如果已设置图像，则在移除图像之前，颜色更改将不可见。
  • 背景图片 BackgroundImage 文本 按钮上显示的图像。
  • 背景图片模糊度 BackgroundImageBlurRate 数字 指定ContactPicker的背景图像模糊率[0.0, 1.0]。
  • Base64字符串背景图片 BackgroundImageinBase64 文本 只代码, 只写 以Base64格式设置背景图片
  • 位图对象背景图片 BackgroundImageinBitmap android.graphics.Bitmap 只代码, 只写 使用Bitmap对象设置背景图像
  • 字节列表背景图片 BackgroundImageinBytes 列表 只代码, 只写 以字节格式设置背景图像
  • 是否启用点击 Clickable 布尔 指定联系人选择器（ContactPicker）是否可点击。
  • 联系人姓名 ContactName 文本 只代码, 只读 返回所选联系人的全名，如果联系人没有姓名，则返回空字符串。
  • 联系人URI ContactUri 文本 只代码, 只读 返回一个URI，该URI指定了设备上联系人的位置。
  • 邮箱地址 EmailAddress 文本 只代码, 只读 返回所选联系人的主要电子邮件地址；若电子邮件地址不可用，则返回空字符串。
  • 电子邮件地址列表 EmailAddressList 列表 只代码, 只读 返回与所选联系人相关联的电子邮件地址列表。
  • 是否启用 Enabled 布尔 如果已设置，用户可以点击“联系人选择器”以触发操作。
  • 是否粗体 FontBold 布尔 指定联系人选择器的文本是否应加粗。某些字体不支持加粗。
  • 是否斜体 FontItalic 布尔 指定联系人选择器的文本是否应使用斜体。某些字体不支持斜体。
  • 字号 FontSize 数字 指定联系人选择器的文本字体大小，以sp（独立于缩放的像素）为单位。
  • 字体 FontTypeface 文本 联系人选择器文本的字体族。
  • 高度 Height 数字 只代码 指定 ContactPicker 的垂直高度，以像素为单位。
  • 百分比高 HeightPercent 数字 只代码, 只写 将联系人选择器的垂直高度指定为屏幕高度的百分比。
  • 是否原点在中心 OriginAtCenter 布尔 只代码 暂无描述
  • 电话号码 PhoneNumber 文本 只代码, 只读 返回与所选联系人相关联的主要电话号码，如果该联系人没有相关联的电话号码，则返回空字符串。
  • 电话号码列表 PhoneNumberList 列表 只代码, 只读 返回与所选联系人相关联的电话号码列表。
  • 图片 Picture 文本 只代码, 只读 返回所选联系人的图片URI，该URI可用于检索联系人的照片和其他字段。
  • 旋转角度 RotationAngle 数字 只代码 暂无描述
  • 形状 Shape 数字 指定 ContactPicker 的形状。此属性的有效值为 0（默认）、1（圆形）、2（矩形）和 3（椭圆形）。如果使用了图像，则形状将不可见。
  • 是否显示交互效果 ShowFeedback 布尔 指定当按下带有指定图像的ContactPicker时，是否应显示视觉反馈。
  • 文本 Text 文本 指定联系人选择器显示的文本。
  • 文本对齐 TextAlignment 数字 指定 ContactPicker 文本的对齐方式。有效值为：0（正常；例如，如果文本是从左向右书写的，则为左对齐）、1（居中）或 2（相反；例如，如果文本是从左向右书写的，则为右对齐）。
  • 文本颜色 TextColor 颜色 将联系人选择器的文本颜色指定为一个包含阿尔法通道、红色、绿色和蓝色的整数。
  • 不透明度 ViewAlpha 数字 只代码 暂无描述
  • 显示顺序 ViewIndex 数字 只代码 在设置属性时，容器内组件的顺序，1表示第一个，0表示最后一个
  • 模板类型 ViewType 数字 暂无描述
  • 是否显示 Visible 布尔 指定联系人选择器（ContactPicker）是否应在屏幕上可见。如果联系人选择器正在显示，则值为true；如果隐藏，则值为false。
  • 宽度 Width 数字 只代码 指定联系人选择器的水平宽度，以像素为单位。
  • 百分比宽 WidthPercent 数字 只代码, 只写 将联系人选择器的水平宽度指定为屏幕宽度的百分比。
  • X坐标 XCoord 数字 只代码, 只读 暂无描述
  • Y坐标 YCoord 数字 只代码, 只读 暂无描述
  • Z坐标 ZCoord 数字 只代码 暂无描述

事件

  • 被点击 Click 暂无描述
  • 被长按 LongClick 暂无描述
  • 触摸点移动 TouchMoving 触摸点序号 pointerId: 数字, 起点X坐标 startX: 数字, 起点Y坐标 startY: 数字, 前点X坐标 prevX: 数字, 前点Y坐标 prevY: 数字, 当前X坐标 currentX: 数字, 当前Y坐标 currentY: 数字 暂无描述
  • 被按下 TouchDown 触摸点序号 pointerId: 数字, X坐标 x: 数字, Y坐标 y: 数字 表示联系人选择器已被按下。
  • 被松开 TouchUp 触摸点序号 pointerId: 数字, X坐标 x: 数字, Y坐标 y: 数字 表示 ContactPicker 已被释放。
  • 获得焦点 GotFocus 表示光标已移至联系人选择器上方，现在可以点击它了。
  • 失去焦点 LostFocus 表示光标已离开联系人选择器，因此现在无法再点击它。
  • 准备选择 BeforePicking 当单击联系人选择器（ContactPicker）或使用 Open 方法显示选择器时，会引发此事件。此事件在选择器显示之前发生，可用于在选择器显示之前进行准备。
  • 选择完成 AfterPicking 在ContactPicker活动返回其结果且属性已填写完毕后，将触发此事件。

方法

  • 设置 SetupEventHandler 回调函数 handler: 过程 暂无描述
  • 删除回调函数 RemoveEventHandler 暂无描述
  • 自删除 SelfDelete 暂无描述
  • 移动到 MoveToContainer 容器 container: 布局 暂无描述
  • 设置位置 SetPosition X坐标 x: 数字, Y坐标 y: 数字 暂无描述
  • 打开选框 Open 打开选择器，就像用户点击了它一样。
  • 显示联系人 ViewContact URI uri: 文本 通过联系人的URI查看联系人

邮箱地址选择框 EmailPicker

EmailPicker是一种文本框。如果用户开始输入联系人的姓名或电子邮件地址，手机将显示一个下拉菜单，其中包含完成输入的选项。如果有很多联系人，下拉列表可能需要几秒钟才能出现，并且可以在计算匹配时显示中间结果。

属性

  • 背景颜色 BackgroundColor 颜色 输入框的背景颜色。您可以在设计器或块编辑器中按名称选择颜色。默认背景颜色为“默认”（具有阴影的三维外观）。
  • 是否启用点击 Clickable 布尔 指定 EmailPicker 是否可点击。
  • 是否启用 Enabled 布尔 如果已设置，用户可以在EmailPicker中输入文本。
  • 是否可获得焦点 Focusable 布尔 用户是否能聚焦此输入框。默认情况下，这是允许的。
  • 是否粗体 FontBold 布尔 指定 EmailPicker 的文本是否应该加粗。有些字体不支持加粗。
  • 是否斜体 FontItalic 布尔 指定 EmailPicker 的文本是否应使用斜体。某些字体不支持斜体。
  • 字号 FontSize 数字 指定EmailPicker的文本字体大小，以sp（独立于缩放的像素）为单位。
  • 字体 FontTypeface 文本 文本的字体。该值可在设计器中更改。
  • 高度 Height 数字 只代码 指定 EmailPicker 的垂直高度，以像素为单位。
  • 百分比高 HeightPercent 数字 只代码, 只写 将EmailPicker的垂直高度设置为屏幕高度的百分比。
  • 提示 Hint 文本 用户提示：EmailPicker。
  • 提示颜色 HintColor 颜色 指定 EmailPicker 提示框的颜色。
  • 动作类型 ImeOption 数字 设置输入法软键盘的动作按键类型
  • 是否原点在中心 OriginAtCenter 布尔 只代码 暂无描述
  • 旋转角度 RotationAngle 数字 只代码 暂无描述
  • 文本 Text 文本 EmailPicker中的文本可由程序员在设计器或块编辑器中设置，也可由用户输入（除非Enabled属性为false）。
  • 文本对齐 TextAlignment 数字 文本应该左对齐、居中还是右对齐。默认情况下，文本是左对齐的。
  • 文本颜色 TextColor 颜色 将EmailPicker的文本颜色指定为一个包含红绿蓝三原色的整数。
  • 不透明度 ViewAlpha 数字 只代码 暂无描述
  • 显示顺序 ViewIndex 数字 只代码 在设置属性时，容器内组件的顺序为：1表示第一个，0表示最后一个
  • 模板类型 ViewType 数字 暂无描述
  • 是否显示 Visible 布尔 指定 EmailPicker 是否应在屏幕上可见。如果 EmailPicker 显示，则值为 true；如果隐藏，则值为 false。
  • 宽度 Width 数字 只代码 指定 EmailPicker 的水平宽度，以像素为单位。
  • 百分比宽 WidthPercent 数字 只代码, 只写 将EmailPicker的水平宽度指定为屏幕宽度的百分比。
  • X坐标 XCoord 数字 只代码, 只读 暂无描述
  • Y坐标 YCoord 数字 只代码, 只读 暂无描述
  • Z坐标 ZCoord 数字 只代码 暂无描述

事件

  • 被点击 Click 暂无描述
  • 被按下 TouchDown 触摸点序号 pointerId: 数字, X坐标 x: 数字, Y坐标 y: 数字 暂无描述
  • 被松开 TouchUp 触摸点序号 pointerId: 数字, X坐标 x: 数字, Y坐标 y: 数字 暂无描述
  • 触摸点移动 TouchMoving 触摸点序号 pointerId: 数字, 起点X坐标 startX: 数字, 起点Y坐标 startY: 数字, 前点X坐标 prevX: 数字, 前点Y坐标 prevY: 数字, 当前X坐标 currentX: 数字, 当前Y坐标 currentY: 数字 暂无描述
  • 失去焦点 LostFocus 当不再选择 EmailPicker 作为输入时（例如，用户触摸了另一个文本框），会引发此事件。
  • 文本改变 AfterTextChanged 文本更改后。
  • 输入完成 EditorAction 动作标识 actionId: 数字 单行输入模式，按下软键盘的回车键时触发
  • 获得焦点 GotFocus 当此组件被选中作为输入时（例如通过）引发的事件

方法

  • 设置 SetupEventHandler 回调函数 handler: 过程 暂无描述
  • 删除回调函数 RemoveEventHandler 暂无描述
  • 自删除 SelfDelete 暂无描述
  • 移动到 MoveToContainer 容器 container: 布局 暂无描述
  • 设置位置 SetPosition X坐标 x: 数字, Y坐标 y: 数字 暂无描述
  • 取得输入焦点 RequestFocus 请求将焦点切换至当前的EmailPicker。
  • 光标移动到 MoveCursorTo 位置 position: 数字 在给定索引位置（从1开始）的字符之前重新定位文本框的光标。如果给定位置大于文本框的长度，则光标将移动到文本末尾；如果给定位置小于或等于1，则光标将移动到文本开头。
  • 光标移动到结束 MoveCursorToEnd 将光标移动到EmailPicker文本的末尾。
  • 光标移动到开始 MoveCursorToStart 将光标重新定位到EmailPicker文本的开头。

电话拨号器 PhoneCall

打个电话。

属性

  • 电话号码 PhoneNumber 文本 指定要拨打的电话号码。

事件

  • 开始通话 PhoneCallStarted 状态 status: 数字, 号码 phoneNumber: 文本 表示电话呼叫已开始的事件。状态可以是以下任一状态：1：来电铃声响起2：拨出电话
  • 通话结束 PhoneCallEnded 状态 status: 数字, 号码 phoneNumber: 文本 表示电话已结束的事件。状态可以是以下任何一种：1：未接或拒绝来电2：接听来电并挂断3：挂断呼出电话。
  • 接听电话 IncomingCallAnswered 号码 phoneNumber: 文本 表示接听来电的事件。phoneNumber是来电电话号码。

方法

  • 打开拨号窗口 MakePhoneCall 启动默认拨号程序应用程序集，使用PhoneNumber属性中的号码拨打电话。
  • 直接拨打电话 MakePhoneCallDirect 使用PhoneNumber属性中的号码直接发起电话呼叫，绕过用户交互以开始呼叫。大多数应用程序应该使用MakePhoneCall，它不需要任何权限。

电话号选择框 PhoneNumberPicker

一个按钮，点击后显示联系人的电话号码列表以供选择。用户选择后，以下属性将设置为所选联系人的信息：

属性

  • 背景颜色 BackgroundColor 颜色 将PhoneNumberPicker的背景颜色指定为alpha红绿蓝整数。如果已设置图像，则在删除图像之前，颜色变化将不可见。
  • 背景图片 BackgroundImage 文本 按钮上显示的图像。
  • 背景图片模糊度 BackgroundImageBlurRate 数字 指定ContactPicker的背景图像模糊率[0.0, 1.0]。
  • Base64字符串背景图片 BackgroundImageinBase64 文本 只代码, 只写 以Base64格式设置背景图片
  • 位图对象背景图片 BackgroundImageinBitmap android.graphics.Bitmap 只代码, 只写 使用Bitmap对象设置背景图像
  • 字节列表背景图片 BackgroundImageinBytes 列表 只代码, 只写 以字节格式设置背景图像
  • 是否启用点击 Clickable 布尔 指定选择器是否应可点击。
  • 联系人姓名 ContactName 文本 只代码, 只读 返回所选联系人的全名，如果姓名不可用，则返回空字符串。
  • 联系人URI ContactUri 文本 只代码, 只读 返回一个URI，该URI指定联系人位于设备上的位置。
  • 邮箱地址 EmailAddress 文本 只代码, 只读 返回所选联系人的主电子邮件地址，如果电子邮件地址不可用，则返回空字符串。
  • 电子邮件地址列表 EmailAddressList 列表 只代码, 只读 返回与所选联系人关联的电子邮件地址列表。
  • 是否启用 Enabled 布尔 指定PhoneNumberPicker是否应处于活动状态且可点击。
  • 是否粗体 FontBold 布尔 指定PhoneNumberPicker的文本是否应加粗。某些字体不支持粗体。
  • 是否斜体 FontItalic 布尔 指定PhoneNumberPicker的文本是否应为斜体。某些字体不支持斜体。
  • 字号 FontSize 数字 指定PhoneNumberPicker的文本字体大小，以sp（与比例无关的像素）为单位。
  • 字体 FontTypeface 文本 联系人选择器文本的字体族。
  • 高度 Height 数字 只代码 指定PhoneNumberPicker的垂直高度，以像素为单位。
  • 百分比高 HeightPercent 数字 只代码, 只写 将PhoneNumberPicker的垂直高度指定为屏幕高度的百分比。
  • 是否原点在中心 OriginAtCenter 布尔 只代码 暂无描述
  • 电话号码 PhoneNumber 文本 只代码, 只读 返回与所选联系人关联的主电话号码，如果没有与联系人关联的电话号码，则返回空字符串。
  • 电话号码列表 PhoneNumberList 列表 只代码, 只读 返回与所选联系人关联的电话号码列表。
  • 图片 Picture 文本 只代码, 只读 返回所选联系人的图片URI，该URI可用于检索联系人的照片和其他字段。
  • 旋转角度 RotationAngle 数字 只代码 暂无描述
  • 形状 Shape 数字 指定PhoneNumberPicker的形状。此属性的有效值为0（默认值）、1（圆角）、2（矩形）和3（椭圆形）。如果使用图像，形状将不可见。
  • 是否显示交互效果 ShowFeedback 布尔 指定按下具有指定图像的PhoneNumberPicker时是否应显示视觉反馈。
  • 文本 Text 文本 指定PhoneNumberPicker显示的文本。
  • 文本对齐 TextAlignment 数字 指定PhoneNumberPicker文本的对齐方式。有效值为：0（正常；例如，如果文本从左向右书写，则左对齐）、1（居中）或2（相反；例如，当文本从左向左书写时，则右对齐）。
  • 文本颜色 TextColor 颜色 将PhoneNumberPicker的文本颜色指定为一个包含alpha（透明度）、红、绿、蓝的整数。
  • 不透明度 ViewAlpha 数字 只代码 暂无描述
  • 显示顺序 ViewIndex 数字 只代码 在设置属性时，容器内组件的顺序，1表示第一个，0表示最后一个
  • 模板类型 ViewType 数字 暂无描述
  • 是否显示 Visible 布尔 指定PhoneNumberPicker是否应在屏幕上可见。如果显示PhoneNumberPicker，则该值为true；如果隐藏，则为false。
  • 宽度 Width 数字 只代码 指定PhoneNumberPicker的水平宽度，以像素为单位。
  • 百分比宽 WidthPercent 数字 只代码, 只写 将PhoneNumberPicker的水平宽度指定为屏幕宽度的百分比。
  • X坐标 XCoord 数字 只代码, 只读 暂无描述
  • Y坐标 YCoord 数字 只代码, 只读 暂无描述
  • Z坐标 ZCoord 数字 只代码 暂无描述

事件

  • 被点击 Click 暂无描述
  • 被长按 LongClick 暂无描述
  • 触摸点移动 TouchMoving 触摸点序号 pointerId: 数字, 起点X坐标 startX: 数字, 起点Y坐标 startY: 数字, 前点X坐标 prevX: 数字, 前点Y坐标 prevY: 数字, 当前X坐标 currentX: 数字, 当前Y坐标 currentY: 数字 暂无描述
  • 被按下 TouchDown 触摸点序号 pointerId: 数字, X坐标 x: 数字, Y坐标 y: 数字 表示电话号码选择器已被按下。
  • 被松开 TouchUp 触摸点序号 pointerId: 数字, X坐标 x: 数字, Y坐标 y: 数字 表示PhoneNumberPicker已发布。
  • 获得焦点 GotFocus 表示光标已移至PhoneNumberPicker上方，现在可以点击它了。
  • 失去焦点 LostFocus 表示光标已从PhoneNumberPicker移开，因此现在无法再单击它。
  • 准备选择 BeforePicking 单击PhoneNumberPicker或使用Open方法显示选择器时引发的事件。此事件发生在选择器显示之前，可用于在显示选择器之前对其进行准备。
  • 选择完成 AfterPicking 在PhoneNumberPicker活动返回结果并填写属性后引发的事件。

方法

  • 设置 SetupEventHandler 回调函数 handler: 过程 暂无描述
  • 删除回调函数 RemoveEventHandler 暂无描述
  • 自删除 SelfDelete 暂无描述
  • 移动到 MoveToContainer 容器 container: 布局 暂无描述
  • 设置位置 SetPosition X坐标 x: 数字, Y坐标 y: 数字 暂无描述
  • 打开选框 Open 打开PhoneNumberPicker，就像用户点击了它一样。
  • 显示联系人 ViewContact URI uri: 文本 在设备的默认“联系人”应用中打开所选联系人的条目。

信息分享器 Sharing

共享是一个不可见的组件，它允许在您的应用程序和设备上安装的其他应用程序之间共享文件和/或消息。该组件将显示可以处理所提供信息的已安装应用程序的列表，并允许用户选择一个与之共享内容的应用程序，例如邮件应用程序、社交网络应用程序、短信应用程序等。

方法

  • 分享信息 ShareMessage 消息 message: 文本 通过显示可用应用程序的列表并允许用户从列表中选择一个，通过手机上安装的任何功能强大的应用程序共享消息。所选应用程序将打开，并插入消息。
  • 分享文件 ShareFile 文件 file: 文本 通过显示可用应用程序的列表并允许用户从列表中选择一个，通过手机上安装的任何功能强大的应用程序共享文件。所选应用程序将打开并插入文件。
  • 分享文件及信息 ShareFileWithMessage 文件 file: 文本, 消息 message: 文本 通过显示可用应用程序列表并允许用户从列表中选择一个，通过手机上安装的任何功能强大的应用程序共享文件和消息。所选应用程序将打开，并插入文件和消息。

短信收发器 Texting

发送短信。

属性

  • 是否使用谷歌短信 GoogleVoiceEnabled 布尔 如果为真，则 SendMessage 将尝试使用 Google Voice 通过 Wifi 发送消息。这要求必须在手机或平板电脑上安装并设置 Google Voice 应用，并拥有 Google Voice 帐户。如果 GoogleVoiceEnabled 为假，则设备必须具有电话和短信服务才能使用此组件发送或接收消息。
  • 短信 Message 文本 调用 SendMessage 方法时将发送的消息。标准短信的最大长度通常为 170 个字符。对于使用变音符号的语言，长度可能会更短。
  • 电话号码 PhoneNumber 文本 调用SendMessage方法时消息将发送到的号码。该数字是具有指定数字的文本字符串（例如6505551212）。可以包括虚线、点和括号（例如，（650）-555-1212），但将被忽略；不应包含空格。如果用逗号分隔，则可以包含多个数字。
  • 启用短信事件 ReceivingEnabled 数字 如果设置为1（OFF），则不会收到任何消息。如果设置为2（FOREGROUND）或3（ALWAYS），则组件在运行时将对消息做出响应。在2（FOREGROUND）的情况下，应用程序未运行时收到的消息将被丢弃。在3（总是）的情况下，应用程序未运行时收到的消息将显示通知。选择通知将打开应用程序并发出MessageReceived事件的信号。应用程序处于休眠状态时收到的消息将被排队，因此应用程序唤醒时可能会出现多个MessageReceived事件。作为一名应用程序开发人员，最好让用户控制此属性，这样他们就可以在安装应用程序时让手机忽略短信。

事件

  • 收到消息 MessageReceived 号码 phoneNumber: 文本, 消息内容 messageText: 文本 当手机收到短信时触发的事件。使用此代码块会添加危险权限，如果您的应用提交到Google Play商店，这些权限将需要额外的批准。

方法

  • 发送消息 SendMessage 启动手机的默认短信应用程序，并预先填充消息和电话号码。
  • 直接发送短信 SendMessageDirect 发送短信。使用此功能块将添加危险权限，如果您的应用提交到Google Play商店，这些权限将需要额外的审批。