图像翻阅器组件实例讲解

作者：创世魂

注意：本类位于“安卓基本类”模块中，必须添加此模块才能使用。

界面准备：

打开启动类“界面设计器”，设计如下界面。

组件依次为“按钮1”，“图像翻阅器1”。

设置“图像翻阅器1”宽度为“匹配父组件宽度”，高度为“匹配内容高度”。

“适配器(读)”帮助文档：

本属性返回值为“图片组适配器”，翻阅器项目的操作方法都是基于本适配器。

“插入列表项”帮助文档：

本方法共有四个参数，用于插入在翻阅器中插入一个项目。

参数1：提供一个可绘制对象类的图像。

参数2：提供脚注文本。

参数3：提供脚注文本颜色。

参数4：提供插入位置，留空则插入到最后。

注意：本方法是继承自“图片组适配器”的方法。

“到下一视图”帮助文档：

在图像翻阅器中，无法通过手势滑动切换视图，所以需要通过本方法进行切换。

代码编写如下图：

1、按钮1点击后，调用“到下一视图()”方法进行视图切换。

2、在“通知_被创建”虚拟方法下，利用“适配器”属性的“插入列表项()”方法循环插入3个项目。

运行效果如下图（GIF）：

按钮点击后，当前翻阅器会向下一个项目切换，如果切换到最后一个项目会返回第一个项目。

帮助文档如下图：

顾名思义，本方法用于切换到上一个视图。

如果已经是第一个视图，则返回到最后一个视图。

代码编写如下图：

按钮被点击后，调用本方法进行切换。

运行效果如下图（GIF）：

最终可看到翻阅器会进行向上切换效果。

帮助文档如下图：

本方法继承自“图片组适配器”和“插入列表项”的区别是，本方法的参数1为可绘制资源。

代码编写如下图：

1、定义类型为“可绘制资源”的常量，初始值引用图片。

2、调用“适配器.插入列表项2()”就可以进行插入项目操作。

运行效果如下图（GIF）：

最终项目被插入到当前翻阅器组件中。

“脚注字体尺寸(写)”帮助文档：

本属性用于设置脚注字体尺寸，单位SP，类型为小数。

本属性设置后不会立刻刷新，需要调用“通知内容被改变()”方法才会刷新。

“通知内容被改变”帮助文档：

本方法用于刷新组件内容显示。

代码编写如下图：

按钮被点击后，设置脚注尺寸为20，并调用“适配器.通知内容被改变()”方法刷新组件。

运行效果如下图（GIF）：

最终可看到按钮被点击后，脚注文本尺寸发生变化。

“脚注字体类型(写)”帮助文档：

本属性用于设置脚注字体类型，调用方式为“常用字体类型.XX”。

在“常用字体类型”中共有五个类型可供使用。

“刷新显示内容(事件)”帮助文档：

调用“脚注字体尺寸”、“脚注字体类型”和“脚注字体风格”这三个属性都会触发本事件。

代码编写如下图：

1、通过“适配器”属性取出“图片组适配器”对象。

2、对适配器变量进行挂接事件操作，否则事件将不会触发。

3、通过适配器变量设置脚注字体类型。

4、最后添加“图片组适配器_刷新显示内容”事件，判断来源后调用“通知内容被改变()”方法刷新组件显示。

运行效果如下图（GIF）：

仔细观察脚注文本会发现文字被加粗。

“脚注字体风格(写)”帮助文档：

本属性用于设置字体风格，调用方法“字体风格.XX”。

打开字体风格，可看到本类中共提供了四种风格可以选择。

“刷新显示”帮助文档：

本方法是组件方法，也可以用于刷新组件内容。

代码编写如下图：

1、设置脚注字体风格为“粗斜体”。

2、调用“刷新显示()”方法刷新组件。

运行效果如下图（GIF）：

最终可看到脚注文本被加粗变斜。

帮助文档如下图：

本方法的作用和“插入列表项”作用一致，不同支持为参数类型不同。

参数1：需要提供当前模板类型对应的实际数据类型。

参数2：提供插入索引位置，默认插入到最后。

参数3：是否立刻刷新组件，默认立刻刷新。

点开“模板类型1”后可看到“图片组适配器”所对应的实际数据类型为“图片浏览列表项”。

点开“图片浏览列表项”后可看到本类共提供了三个变量，为三种数据提供操作。

代码编写如下图：

1、定义类型“图片浏览列表项”的变量，起名“列表项”。

2、定义类型为“可绘制资源”的常量值，引用图片。

3、利用定义的“列表项”变量，分别给“图像”、“脚注文本”和“脚注文本颜色”赋值。

4、最后调用“插入项目()”，将“列表项”变量放入参数1即可。

运行效果如下图（GIF）：

最终可看到当前翻阅器添加了一个项目。

帮助文档如下图：

本方法可用于插入一批项目。

参数1：提供“图片浏览列表项”数组。

参数2：提供插入位置，默认插入到最后。

参数3：是否立刻刷新，默认刷新。

代码编写如下图：

1、按钮被点击后，执行到下一视图方法。

2、在“通知_被创建”虚拟方法下，定义“图片浏览列表项”数组变量，成员数填写3。

3、循环创建每一个成员对象，并设置项目数据。

4、最后调用“插入一批项目()”方法，插入数据。

运行效果如下图（GIF）：

最终可以看到3个项目被插入，并且可进行切换。

帮助文档如下图：

本方法用于取出指定项目索引的项目数据，返回实际数据类型为“图片浏览列表项”。

代码编写如下图：

1、定义类型“图片浏览列表项”的变量，并勾选参考。

2、调用“适配器.取项目()”方法取出索引0的数据对象。

3、最后取出脚注文本显示在信息框中。

运行效果如下图（GIF）：

最终可看到脚注文本被取出。

帮助文档如下图：

调用本方法可修改制定项目索引处的项目数据。

参数1：提供要修改的项目索引。

参数2：提供要修改的项目数据。

参数3：是否立刻刷新，默认刷新。

代码编写如下图：

1、定义类型为“图片浏览列表项”的变量，并设置图像和文本。

2、调用“适配器.修改项目()”修改项目0的数据。

运行效果如下图（GIF）：

最终可看到项目0的数据被修改。

帮助文档如下图：

顾名思义，本方法可用于删除项目。

参数1：填写要删除的索引值，从0开始。

参数2：填写要删除的数量，默认删除1个。

参数3：是否立刻刷新。

代码编写如下图：

按钮被点击后调用本方法，删除项目0。

运行效果如下图（GIF）：

最终可看到脚注文本0被删除。

帮助文档如下图：

顾名思义，用于删除所有项目。

参数为逻辑型，默认为立刻刷新。

代码编写如下图：

按钮被点击后调用本方法实现删除所有项目。

运行效果如下图（GIF）：

最终可看到，图像翻阅器的所有项目被删除。

帮助文档如下图：

本方法用于取出项目数量，返回值为整数。

代码编写如下图：

按钮被点击后，调用本方法取出数量显示在信息框中。

运行效果如下图（GIF）：

最终可看到数量为3.

以上属性都继承自“视图翻阅器基础类”。

“自动开始翻阅(写)”帮助文档：

设置当前组件是否自动翻阅，提供真则自动翻阅，否则停止翻阅。

“自动翻阅周期(写)”帮助文档：

设置自动翻阅周期，即多少毫米翻阅一次。

“正在自动翻阅(读)”帮助文档：

判断当前组件是否处于自动翻阅状态。

代码编写如下图：

在“图像翻阅器1”属性栏，分别设置以上两个属性值。

在“按钮1”被点击下，直接判断“正在自动翻阅”读属性，弹出对应提示。

运行效果如下图（GIF）：

“开始自动翻阅”帮助文档：

顾名思义，执行本方法开始自动翻阅。

“停止自动翻阅”帮助文档：

顾名思义，执行本方法停止自动翻阅。

代码编写如下图：

1、在属性栏设置“自动翻阅周期”属性。

2、在“按钮1”被单击下，判断“正在自动翻阅”属性后，执行对应方法。

运行效果如下图（GIF）：

最终可看到，“按钮1”点击可实现，开始翻阅和停止翻阅两个事件。