社交应用组件
目录：
联系人选择框
单击该按钮后，会显示可供选择的联系人列表。用户做出选择后，以下属性将设置为有关所选联系人的信息：
联系人姓名：联系人姓名邮箱地址：联系人的主要电子邮件地址邮箱地址列表：联系人电子邮件地址列表联系人URI：设备上联系人的 URI电话号码：联系人的主要电话号码（在更高版本的 Android 版本上）电话号码列表：联系人电话号码列表（在更高版本的 Android 版本上）图片：包含联系人图片的文件的名称，可用作 图像.图片属性值 或 图像精灵.图片 属性值。
其他属性影响按钮外观（文本对齐、背景颜色等）以及是否可以单击（启用）。
联系人选择框组件可能不适用于所有手机。例如，在3.0之前的Android系统上，它无法选择电话号码，并且电子邮件地址列表将仅包含一封电子邮件。
属性
- 背景颜色
- 设置
联系人选择框的背景颜色，使用RGBA数值表示，如果设置了图像属性，则不能显示背景颜色直到删除图像属性为止。 - 联系人姓名
- 返回所选联系人的全名，如果名称不可用，则返回空字符串。
- 联系人URI
- 返回指定联系人在设备上的位置的 URI。
- 邮箱地址
- 返回所选联系人的主电子邮件地址，如果电子邮件地址不可用，则返回空字符串。
- 邮箱地址列表
- 返回与所选联系人关联的电子邮件地址列表。
- 启用
- 设置
联系人选择框是否可以被激活和点击。 - 粗体
- 设置
联系人选择框的显示字体是否是粗体。（注：有些字体不支持粗体）。 - 斜体
- 设置
联系人选择框的显示字体是否是斜体。（注：有些字体不支持斜体）。 - 字体大小
- 设置
联系人选择框的字体大小，以像素px为单位。 - 字体
- 设置
联系人选择框的字体，目前支持的字体有：default, serif, sans serif, 和 monospace。要使用自定义字体，请将 .ttf 字体文件上传并选中它。
- 高度
- 设置
联系人选择框的垂直高度，以像素px为单位。 - 高度百分比
- 设置
联系人选择框的垂直高度相对于整个屏幕高度的百分比。 - 图像
- 设置
联系人选择框图像的路径，如果同时设置了图像和背景颜色，则仅图像可见。 - 电话号码
- 返回与所选联系人关联的主要电话号码，如果没有与该联系人关联的电话号码，则返回空字符串。
- 电话号码列表
- 返回与所选联系人关联的电话号码列表。
- 图片
- 返回所选联系人的图片 URI，可用于检索联系人的照片和其他字段。
- 形状
- 设置
联系人选择框的形状，此属性的有效值为：0（默认）1（圆形）2（矩形）3（椭圆形）。如果设置了
图像，则形状将不可见。 - 显示反馈
- 设置
联系人选择框指定图像后被按压是否显示视觉反馈。 - 文本
- 设置
联系人选择框的显示文本。 - 文本对齐
- 设置
联系人选择框文本的对齐方式，有效值有：0（正常；例如，如果文本从左到右书写，则左对齐）1（居中）2（相反；例如，如果文本从左到右书写，则右对齐）。 - 文本颜色
- 设置
联系人选择框的文本颜色，使用RGBA数值表示。 - 可见性
- 设置
联系人选择框是否显示在屏幕上，值是真则联系人选择框显示，假则隐藏。 - 宽度
- 设置
联系人选择框的水平宽度，以像素px为单位。 - 宽度百分比
- 设置
联系人选择框的水平宽度相对于屏幕宽度的百分比。
事件
- 选择完成()
- 在
联系人选择框活动返回其结果且属性已填写后触发该事件。 - 准备选择()
- 单击
联系人选择框或使用 打开选框 方法显示选择器时触发该事件。此事件发生在选择器显示之前，可用于在显示选择器之前准备好选择器。
- 获得焦点()
- 表示光标移到
联系人选择框上方，因此现在可以单击它。 - 失去焦点()
- 表示光标已从
联系人选择框移开，因此现在无法再单击它。 - 被按压()
- 表示
联系人选择框已被按下。 - 被松开()
- 表示
联系人选择框按压已释放。
方法
- 打开选框()
- 打开
联系人选择框选框，就像用户单击它一样。 - 查看联系人(URI)
- 在设备的默认联系人App中打开所选联系人的条目。
邮箱地址选择框
邮箱地址选择框是一种文本框。如果用户开始输入联系人的姓名或电子邮件地址，手机将显示完成输入的选项下拉菜单。如果有很多联系人，则下拉列表可能需要几秒钟的时间才能显示，并且可以在计算匹配时显示中间结果。
文本框的初始内容和用户输入后的内容位于 文本 属性中。如果 文本 属性最初为空，则 提示 属性的内容将隐约显示在文本框中，作为对用户的提示。
其他属性影响文本框的外观（文本对齐、背景颜色等）以及是否可以使用（启用）。
像这样的文本框通常与 按钮 组件一起使用，用户在文本输入完成后单击按钮。
属性
- 背景颜色
邮箱地址选择框的背景色，可以在“界面设计”视图或“程序设计”视图中通过颜色名字选择一个颜色，默认背景颜色为：default（阴影 3-D 外观）。- 启用
- 如果设置为
真则用户可以在邮箱地址选择框中输入文本。 - 粗体
- 设置
邮箱地址选择框的显示字体是否是粗体。（注：有些字体不支持粗体）。 - 斜体
- 设置
邮箱地址选择框的显示字体是否是粗体。（注：有些字体不支持粗体）。 - 字体大小
- 设置
邮箱地址选择框的字体大小，以像素px为单位。 - 字体
- 设置
邮箱地址选择框的字体，目前支持的字体有：0(default),1(serif),2(sansserif), 和3(monospace)。要使用自定义字体，请将 .ttf 字体文件上传并选中它。
- 高度
- 设置
邮箱地址选择框的垂直高度，以像素px为单位。 - 高度百分比
- 设置
邮箱地址选择框的垂直高度相对于整个屏幕高度的百分比。 - 提示
- 设置
邮箱地址选择框的提示信息，如果文本为空，则该提示信息在框中显示为浅淡色文本。 - 文本
邮箱地址选择框中的文本，可以在“界面设计”视图或“程序设计”视图中设置，或由用户输入（除非启用属性为假）。- 文本对齐
- 设置
邮箱地址选择框文本的对齐方式，有效值有：0（正常；例如，如果文本从左到右书写，则左对齐）1（居中）2（相反；例如，如果文本从左到右书写，则右对齐）。 - 文本颜色
- 设置
邮箱地址选择框的文本颜色，使用RGBA数值表示。 - 可见性
- 设置
邮箱地址选择框是否显示在屏幕上，值是真则邮箱地址选择框显示，假则隐藏。 - 宽度
- 设置
邮箱地址选择框的水平宽度，以像素px为单位。 - 宽度百分比
- 设置
邮箱地址选择框的水平宽度相对于屏幕宽度的百分比。
事件
- 获得焦点()
- 选择
邮箱地址选择框进行输入（例如用户触摸它）时触发该事件。 - 失去焦点()
- 当不再选择
邮箱地址选择框进行输入时触发该事件，例如用户触摸不同的文本框。
方法
- 焦点请求()
- 请求焦点到当前的
邮箱地址选择框。
电话拨号器
一个不可见的组件，用于拨打 电话号码 属性中指定的号码，该属性可以在界面设计或程序设计视图中设置。
该组件有一个 拨打电话 方法，使程序能够发起电话呼叫。
您还可以使用 直接拨打电话 直接发起电话呼叫，无需用户交互。但是，使用此块的应用程序如果提交到应用商店，可能需要进一步审核，因此建议改用 拨打电话。
通常，此组件与 联系人选择框 组件一起使用，该组件允许用户从手机上存储的联系人中选择联系人，并将 电话号码 属性设置为 联系人选择框.电话号码 属性。
要直接指定电话号码（例如 021-12345678），请将 电话号码 属性设置为具有指定数字的文本（例如“02112345678”）。
属性
- 电话号码
- 指定要拨打的电话号码。
事件
- 来电已接听时(电话号码)
- 指示来电已接听的事件。
电话号码是来电电话号码。 - 通话结束时(状态,电话号码)
- 指示电话通话已结束的事件。
状态可以是以下任意一种：1：来电未接或被拒绝2：来电已接听并挂断3：拨出电话已挂断。
- 开始通话时(状态,电话号码)
- 指示电话呼叫已开始的事件。
状态可以是以下任意一个：1：来电正在响铃2: 拨出电话
方法
- 拨打电话()
- 启动默认拨号器应用程序，设置为使用
电话号码属性中的号码发起电话呼叫。 - 直接拨打电话()
- 使用
电话号码属性中的号码直接发起电话呼叫，绕过用户交互来启动呼叫。大多数应用程序应使用
拨打电话，这不需要任何权限。
电话号选择框
单击该按钮后，会显示联系人电话号码列表以供选择。
用户做出选择后，以下属性将设置为有关所选联系人的信息：
其他属性会影响按钮的外观（文本对齐、背景颜色等)以及是否可以点击(启用)。
电话号选择框 组件可能不适用于所有 Android 设备。例如，在3.0之前的Android系统上，返回的电话号码和电子邮件地址列表将为空。
属性
- 背景颜色
- 设置
电话号选择框的背景颜色，使用RGBA数值表示，如果设置了图像属性，则不能显示背景颜色直到删除图像属性为止。 - 联系人姓名
- 返回所选联系人的全名，如果名称不可用，则返回空字符串。
- 联系人URI
- 返回指定联系人在设备上的位置的 URI。
- 邮箱地址
- 返回所选联系人的主电子邮件地址，如果电子邮件地址不可用，则返回空字符串。
- 邮箱地址列表
- 返回与所选联系人关联的电子邮件地址列表。
- 启用
- 设置
电话号选择框是否可以被激活和点击。 - 粗体
- 设置
电话号选择框的显示字体是否是粗体。（注：有些字体不支持粗体）。 - 斜体
- 设置
电话号选择框的显示字体是否是斜体。（注：有些字体不支持斜体）。 - 字体大小
- 设置
电话号选择框的字体大小，以像素px为单位。 - 字体
- 设置
电话号选择框的字体，目前支持的字体有：default, serif, sans serif, 和 monospace。要使用自定义字体，请将 .ttf 字体文件上传并选中它。
- 高度
- 设置
电话号选择框的垂直高度，以像素px为单位。 - 高度百分比
- 设置
电话号选择框的垂直高度相对于整个屏幕高度的百分比。 - 图像
- 设置
电话号选择框图像的路径，如果同时设置了图像和背景颜色，则仅图像可见。 - 电话号码
- 返回与所选联系人关联的主要电话号码，如果没有与该联系人关联的电话号码，则返回空字符串。
- 电话号码列表
- 返回与所选联系人关联的电话号码列表。
- 图片
- 返回所选联系人的图片URI，可用于检索联系人的照片和其他字段。
- 形状
- 设置
电话号选择框的形状，此属性的有效值为：0（默认）1（圆形）2（矩形）3（椭圆形）。如果设置了
图像，则形状将不可见。 - 显示反馈
- 设置
电话号选择框指定图像后被按压是否显示视觉反馈。 - 文本
- 设置
电话号选择框的显示文本。 - 文本对齐
- 设置
电话号选择框文本的对齐方式，有效值有：0（正常；例如，如果文本从左到右书写，则左对齐）1（居中）2（相反；例如，如果文本从左到右书写，则右对齐）。 - 文本颜色
- 设置
电话号选择框的文本颜色，使用RGBA数值表示。 - 可见性
- 设置
电话号选择框是否显示在屏幕上，值是真则电话号选择框显示，假则隐藏。 - 宽度
- 设置
电话号选择框的水平宽度，以像素px为单位。 - 宽度百分比
- 设置
电话号选择框的水平宽度相对于屏幕宽度的百分比。
事件
- 选择完成()
- 在
电话号选择框活动返回其结果且属性已填写后触发该事件。 - 准备选择()
- 单击
电话号选择框或使用 打开选框 方法显示选择器时触发该事件。此事件发生在选择器显示之前，可用于在显示选择器之前准备好选择器。
- 获得焦点()
- 表示光标移到
电话号选择框上方，因此现在可以单击它。 - 失去焦点()
- 表示光标已从
电话号选择框移开，因此现在无法再单击它。 - 被按压()
- 表示
电话号选择框已被按下。 - 被松开()
- 表示
电话号选择框按压已释放。
方法
- 打开选框()
- 打开
电话号选择框选框，就像用户单击它一样。 - 查看联系人(URI)
- 在设备的默认联系人App中打开所选联系人的条目。
信息分享器
信息分享器是一个不可见的组件，可以让App和设备上其他App之间共享数据或文件。
该组件将显示已安装的可处理所提供信息的App列表，并允许用户选择一个App来共享内容，例如邮件App、社交网络App、短信App等。
文件路径可以来自其他组件，例如照相机 或 图像选择框，但也可以指定直接从存储中读取。
请注意：不同的设备处理的存储路径可能不同，例如有一个名为 arrow.gif 的文件在文件夹 Appinventor/assets 中，它的表示方式可能是：
"file:///sdcard/Appinventor/assets/arrow.gif"; 或-
"/storage/Appinventor/assets/arrow.gif" 分享消息弹出其他App的界面：弹出的是文档（保存文本到文档）、地图（文本作为搜索地址）、蓝牙（传输文本数据）之类的App，没有打印机相关的，打印机App在分享文件的方式才弹出。
分享文件、分享文件及消息弹出其他App的界面：分享文件的方式弹出的App几乎非常全面了，包括打印机App（打印分享的文件）。分享文件及消息弹出的和分享文件是一致的。
属性
无
事件
无
方法
- 通过显示可用的应用程序列表并允许用户从列表中选择一个，通过手机上安装的任何功能强大的应用程序共享文件。选定的应用程序将打开，向其中传入文件。
- 通过显示可用的应用程序列表并允许用户从列表中选择一个，通过手机上安装的任何功能强大的应用程序共享文件及消息。选定的应用程序将打开，向其中传入文件及消息。
- 通过显示可用的应用程序列表并允许用户从列表中选择一个，通过手机上安装的任何功能强大的应用程序共享消息。所选应用程序将打开，并向其中传入消息。
短信收发器
当调用组件 发送消息 方法时，将启动设备的首选短信应用程序将属性中指定的短信内容发送到 电话号码 属性中指定的电话中。
也可以通过调用 直接发送消息 直接发送短信，而无需进行交互，但前提是应用程序已请求危险权限。
- 如果
启用消息接收属性设为 1，将不会收到消息。 - 如果
启用消息接收属性设为 2，消息将仅在应用程序正在运行的时候才被接收。 - 如果
启用消息接收属性设置 3，则消息将在应用程序正在运行时被接收；当应用程序未运行时，消息将排队给用户显示通知消息。
当消息到达时，将触发 收到消息 事件，并提供发送号码和消息。
包含此组件的应用程序即使在后台也会收到消息（即当它在屏幕上不可见时），而且只要应用程序安装在手机上了，即使没有运行也能收到消息。
如果应用程序不在手机前台运行，收到短信时手机将在通知栏中显示一条通知。选中通知栏的通知将调出该应用程序，作为应用程序开发人员，你可能希望为用户提供控制 启用消息接收 的能力，这样他们就可以让手机忽略短信。
如果 启用谷歌语音 属性为真，则可以通过 Wifi 使用谷歌语音发送消息。
此选项要求用户拥有谷歌语音帐户并且手机手机上安装了语音应用程序，谷歌语音选项仅适用于支持 Android 2.0 (Eclair) 或更高版本。
不幸的是，由于以下原因，谷歌语音App中引入的变更，导致谷歌语音不再被接收。
要指定电话号码（例如 650-555-1212），请将 电话号码 属性设置为文本字符串与指定的数字（例如，6505551212），可能包含破折号、点和括号（例如，(650)-555-1212）会被忽略，但是不能有空格。
应用程序指定电话号码的另一种方法是包含 电话号选择框 组件，它允许用户从手机中存储的电话号码中选择一个联系人。
属性
- 启用GoogleVoice
- 如果此属性为
真，则 发送消息 将尝试使用 Google语音通过 WiFi 发送消息。 - 消息
- 调用
发送消息方法时将发送的消息。标准 SMS 消息的最大长度通常为 170。对于使用变音符号的语言，该长度可能会更短。
- 电话号码
- 调用
发送消息方法时消息将发送到的号码。 - 启用消息接收
- 如果设置为 1（关闭），则不会收到任何消息。
如果设置为 2（前台）或 3（始终），组件将在运行时响应消息。在 2（前台）的情况下，应用程序未运行时收到的消息将被丢弃。在 3（始终）的情况下，应用程序未运行时收到的消息将显示通知。
选择通知将打开应用程序并触发
收到消息事件。应用程序休眠时收到的消息将排队，因此应用程序唤醒时可能会触发多次收到消息事件。作为应用程序开发人员，最好让你的用户控制此属性，这样用户就可以在安装您的应用程序时让手机忽略短信。
事件
- 收到消息(数值,消息内容)
- 手机收到短信时触发该事件。
使用此块将添加危险权限，如果你的应用提交到应用商店，则需要额外批准。
需要请求的权限名称如下：
权限名：
android.permission.READ_SMS。
方法
- 发送消息()
- 启动手机的默认短信应用程序，并预先填充消息和电话号码。
- 直接发送消息()
- 发送一个文本消息。
使用此块将添加危险权限，如果您的应用提交到应用商店，则需要额外批准。
需要请求的权限名称如下：
权限名：
android.permission.SEND_SMS。
免费技术交流群
扫码添加客服咨询
