# UIConstants 的枚举与常量

> dev.crossfly.ui.UIConstants 中枚举、常量与嵌套类型的参考。

Source: https://crossfly.dev/zh/docs/reference/enums-uiconstants — CrossFly documentation. Full docs as one file: https://crossfly.dev/llms-full.txt

# `UIConstants` 的枚举与常量

`UIConstants` 是枚举、常量和共享类型的中枢。由于 `Component`/`Layout`/`Styles`
**实现了** `UIConstants`，这些名称在它们内部**无需限定导入**即可访问。
取值已对照源代码验证（2026 API）。

## 布局与位置
| 枚举 | 取值 |
|---|---|
| `Position` | `START` · `CENTER` · `END` |
| `Orientation` | `HORIZONTAL` · `VERTICAL` |
| `ScreenSize` | `SIZE`（实际尺寸） · `MIN`（较小边） · `MAX`（较大边） |
| `RelPos` | `AUTOPOS` · `AUTOPOSCENTERED` · `START` · `CENTER` · `END` · `BEFORE` · `SAMEPOS` · `AFTER` · `CENTER_OF` · `END_OF` · `KEEPPOS` |
| `RelSize` | `AUTOSIZE` · `FILL` · `FIT` · `SAMESIZE` · `KEEPSIZE` |
| `Transition` | `NONE` · `FADE` · `SLIDE_LEFT` · `SLIDE_RIGHT` · `SLIDE_UP` · `SLIDE_DOWN` · `SCALE` · `SCALE_DOWN` |

## 外观
| 枚举 | 取值 |
|---|---|
| `ImageSize` | `ORIGINAL` · `RATIO` · `STRETCH` · `FIT` · `FIT_WIDTH` · `FIT_HEIGHT` · `FIT_HALF_WIDTH` · `FIT_HALF_HEIGHT` |
| `LineStyle` | `SOLID` · `DOTTED` |
| `Pressable` | `NO` · `YES` · `STICKY` |

## 文本输入
| 枚举 | 取值 |
|---|---|
| `EditMode` | `NORMAL` · `DATE` · `CURRENCY` · `NUMERIC` · `TIME` · `PASSWORD` |
| `Capitalise` | `NORMAL` · `UPPER` · `LOWER` |
| `Keyboard` | `NONE` · `DEFAULT` · `NUMERIC` · `KEYPAD` · `CALCULATOR` · `DATE` · `TIME` |

> `EditMode.getKeyboard()` 将模式映射到隐式键盘（`DATE`→DatePicker、`CURRENCY`→计算器
> Keypad、`TIME`→TimePicker 等）。参见[掩码与键盘](/docs/ui/forms-and-input/masks-and-keyboards)。

## 非枚举常量
| 常量 | 值 | 用途 |
|---|---|---|
| `LAY_AUTO` | `0f` | 内容的自然尺寸（用于 `add()`） |
| `LAY_FILL` | `-1f` | 填充剩余空间（用于 `add()`） |

颜色仍然是 **`int` ARGB**——颜色常量和工具函数位于 `UIConstants`/`Styles` 和
`ColorUtils` 中（参见"颜色"和[速查表](/docs/reference/cheat-sheets)）。

## 嵌套类型（函数式接口 / 标记接口）
`UIConstants` 还嵌套了共享契约：**`Action`**（`run(Component)`）、**`Paintable`**、
**`Icon`**、**`Scrollable`**、**`Checkable`**、**`TextComponent`**、**`TextInputComponent`**。这就是
它们显示为 `UIConstants.Action` 等的原因（2026 迁移将它们移入了 `UIConstants` 内部）。

## 另请参阅
- [速查表](/docs/reference/cheat-sheets) · [Widget 目录](/docs/reference/widget-catalog)