本文档目前提供葡萄牙语版本。其他语言的翻译正在准备中。
UI — 构建界面
在 CrossFly 中搭建界面的指南 + 参考:widget、布局、导航、主题、动画、图像/图形与表单。
屏幕上的组件排布——网格、垂直、水平与响应式,每页一种布局,配示例和示意图。
在一个轴上以相等的间距分布子组件,同时保留每个组件的尺寸。
按分数比例划分列的网格布局,每一行的高度由该行最高的内容决定。
把子组件从左到右并排排列,每个都占满容器的高度,适合工具栏和按钮组。
无自动排布——手动定位(setBounds)或相对定位(setRelativeBounds)。
通过锚点进行定位和调整尺寸——相对于容器或相对于另一个组件。
如何让任何布局都能适应屏幕尺寸、像素密度和系统字体大小的变化。
把子组件从上到下依次堆叠,每个都占满容器的宽度,是表单最常用的布局。
窗口、导航栈与对话框:如何打开和关闭页面,并在页面之间回传数据。
文本框、输入掩码、键盘、焦点,以及表单中输入值的读取与校验。
颜色、明暗主题与皮肤——CrossFly 外观的三个层次,以及各自的适用场景。
过渡与视觉反馈:透明度、位置和循环动画器,以及页面之间的转场。
用 ImageView 显示图片、在 Whiteboard 上自由绘制,以及用 Paint 做自定义绘图。
CrossFly 可视组件目录:按钮、输入框、选择器、弹窗与各类 picker,每个都附带可运行的示例。
锚定在屏幕底部的 iOS 风格操作表,用于让用户从若干动作中选择一个。
模态对话框,包含标题、消息正文和一到多个操作按钮,会阻断当前交互。
通过设备摄像头读取条形码与二维码的抽象类,由各平台提供具体实现。
可点击的按钮,显示文本和/或图标,带按下状态和 onAction。
图表——折线、面积、柱状、堆叠柱状/面积、饼图、环形图和组合图——共享一个渲染核心。
通过色相×饱和度矩阵加亮度滑块选择颜色,并回传所选的色值。
在月历视图中选择日期,支持限定可选范围,并回传选中的那一天。
ComboBox —— 带箭头的按钮,点击后展开列表以进行单选。
如何在不使用 Spacer 的情况下为组件设置间距 —— 使用 Gap、ingap/outgap 和布局分数。
预留组件——2026 API 中的空骨架,目前不会产生任何结果,仅占位。
使 Options/Switches 互斥(单选按钮)的逻辑注册表。
非模态的短暂通知,用来替代 Toast 与 ToolTip,显示后会自行消失。
显示 Image,可配置缩放模式(ImageSize)和对齐方式。
数字键盘与计算器窗口,会锚定到当前获得焦点的 TextField 上方。
用于显示文本(带自动换行)和/或只读图标的非交互式组件。
现成的列表项卡片 —— 仅标签(SINGLE)或复选框 + 标签(MULTIPLE)。
可滚动、可嵌入其他布局的文本项列表,支持单选与多选两种模式。
将 ListView 包裹在 Window 中的模态弹窗,用于在浮动窗口中进行选择。
在带 GPS 的地图上选择地理坐标,并把经纬度回传给调用方。
以文本形式显示 GPS 坐标(纬度、经度、定位时间、速度、方向),并周期性更新。
带交叉淡入淡出动画的复选框/单选框 —— 单独使用时为复选框,在 Group 中为单选框。
面向 VirtualListView 的分页 DataAdapter,带页面 LRU 缓存和异步加载。
调用设备摄像头拍摄照片或录制视频,并返回生成文件的路径。
所有 picker 的基类 —— getAnswer() + show(onAnswer) 模式。
进度指示器:可显示确定百分比的进度条、无限循环动画或旋转图标。
在给定区间内选择一个 float 值,可以连续滑动,也可以按固定步进取值。
开关切换器,带动画滑轨和可选的文字标签,用于表达开启或关闭两种状态。
标签栏,带动画指示器,内容可水平滚动并按页对齐吸附。
多行文本字段,支持自动换行、垂直滚动、按行图标和可滚动的只读模式。
单行文本字段,支持掩码、EditMode、密码模式、可点击图标和浮动 caption。
文本输入的抽象基类 —— 光标、选择、剪贴板、焦点和键盘,为 TextField 和 TextArea 所共有。
通过模拟时钟表盘或数字网格选择小时与分钟,并回传选中的时间。
高性能虚拟化列表,回收利用组件,风格类似 RecyclerView。
在 UI 中嵌入原生 webview(HTML/JS)—— 通过 IWebView 接口,依赖于平台。
自由手绘表面,笔迹经过平滑处理,颜色与粗细均可配置,适合签名场景。