单选框（radiobutton）

选择器： radiobutton · 设计器组件： 单选框 · 按名称： radiobutton#名称 或 #名称
用途： 同组互斥选项。

硬约束与叠画

1. 控件名来自窗口 XML「名称」；属性赋值无括号（如 标题 = "确定"），方法调用必须带括号（如 刷新()）。
2. 事件写 函数 控件名.事件名(参数…)，形参类型以本页事件表为准。
3. 任意控件客户区叠画用支持库 绘制类：绘制类 g → g.绑组件(本控件名)（组件名无引号）。画布场景编辑见 画布控件。
4. 字体对象见绘制文档中的字体类；置字体(字体类) 将字体应用到本控件。
5. 不要虚构未列出的方法；YSS 键见下文与 YSS.md。

属性

设计器属性面板与代码侧可读可写属性（来源：组件类库）。

属性	类型	读写	说明
提示	文本	读写	鼠标悬停时的提示文字
鼠标指针	文本	读写	空=默认；可用 arrow/hand/ibeam/cross/wait/no/sizeall 等预设，或.cur/.ani 路径（如 资源/press.cur）
左边	小数	读写	相对窗体左边的位置（像素）
顶边	小数	读写	相对窗体顶边的位置（像素）
宽度	小数	读写	控件宽度（像素）
高度	小数	读写	控件高度（像素）
停靠	整数	读写	0无 1上 2下 3左 4右 5填充；菜单/工具/状态栏仍用专用吸附
可见	逻辑	读写	真=显示，假=隐藏
启用	逻辑	读写	真=可用，假=禁用
句柄	长整数	只读	组件逻辑句柄（1 起，供动画类等绑定；非 HWND）；只读
标题	文本	读写	复选框/单选框旁显示的文字
字体	文本	读写	字体名称，如 微软雅黑；读写：组件.字体 / 组件.字体 = “…”
字号	整数	读写	像素；读写：组件.字号 / 组件.字号 = 16
粗体	逻辑	读写	真=粗体；读写：组件.粗体 / 组件.粗体 = 真
斜体	逻辑	读写	真=斜体；读写：组件.斜体 / 组件.斜体 = 真
文字色	文本	读写	如 #FFFFFF 或 #RRGGBB
选中	逻辑	读写	真=选中，假=未选中
分组	整数	读写	同容器内同编号互斥；不同分组框内互不影响

方法

组件类库方法（调用必须带括号）。下表为带类型签名。

方法	签名	返回	说明
置边框	无 置边框([逻辑 显示边框=真], [整数 边框大小=1], [文本 边框颜色], [整数 描边样式])	无	描边：0实 1虚 2点 3点划 4双点划
置选中	无 置选中([逻辑 选中=真])	无	也可属性 选中；开关：真=ON
移动	无 移动(小数 左边, 小数 顶边, [小数 宽度], [小数 高度])	无	可选同时改宽高
置焦点	无 置焦点()	无
刷新	无 刷新()	无
显示 / 隐藏	无 显示() / 无 隐藏()	无	等同 可见 = 真/假
置字体	逻辑 置字体(字体类 字体)	逻辑	见 painter.md

单选框1.置选中(真)

事件

在代码中写 函数 控件名.事件名(...) 处理。

事件	参数	说明
选中改变	整数 X, 整数 Y, 整数 状态	选中状态发生变化；参数「状态」：1=选中，0=未选中，-1=不确定（单选框仅 0/1）。

函数 单选框1.选中改变 (整数 X, 整数 Y, 整数 状态) {
    // …
}

YSS 样式

以下为样式表（.yss）键与示例；写样式前请先读窗体 XML 取控件 名称 与 typeId，见 window-xml.md。

样式概览

视觉分 外壳 与 指示器（圆点 / 圆角点 / 胶囊整卡 / 纯文字）。

伪状态与映射

伪状态： :checked · :hover · :disabled · :focus

子控件： radiobutton:indicator

分组： 窗体 XML 属性 分组（整数）；同组号互斥。YSS 不改分组号。

伪态映射（ 必读）：

在伪态块中写的键	实际含义
:checked { background-color; color }	作用于外壳（胶囊/纯文字选中高亮），不是圆点填充
圆点选中色	必须用 mark-color（或选中图）
圆点底渐变	用 indicator-background-gradient（选中时绘制）

属性说明（逐键）

标签文字

属性	作用	取值 / 范围	说明与注意
color	标签文字色	颜色	pill 未选中时常为灰；选中时在 :checked 里改白。
font-size / font-family / font-bold / font-italic	字体	同其它控件
hover-color / hover-text-color	悬停文字	颜色	二者等效
disabled-color	禁用文字	颜色

外壳

属性	作用	取值 / 范围	说明与注意
background-color / background	外壳底	颜色	indicator-style: pill 时选中态常用此色填满胶囊。
transparent-background	不铺外壳	true/false	pill 未选中时常 true。
border-color / border-width / border-radius / show-border	外壳描边与圆角	同复选	pill 常用 border-radius: 18。
padding / padding-*	内边距	像素	pill 建议 padding: 4 12。
background-gradient	外壳/胶囊渐变	≥2 色
shadow* / box-shadow / shadow-style	外壳阴影	同按钮；hard=soft
inner-shadow*	外壳内阴影	同按钮
outer-glow*	外壳外发光	同按钮
hover-background-color	悬停外壳/胶囊底	颜色
disabled-background-color	禁用外壳底	颜色
focus-border-color / focus-glow-color	焦点	颜色
transition	悬停过渡	如 all 160ms ease-out

指示器样式模式

属性	作用	取值	说明与注意
indicator-style	指示器模式	default（圆点，默认）· pill/capsule（胶囊选中）· none/hidden（隐藏圆点）	pill：选中时整卡胶囊填充，不画左侧圆点；未选中仍可不铺底。none：纯文字+外壳高亮。

指示器几何（default 模式）

属性	作用	取值 / 范围	说明与注意
indicator-size	圆点外径	约 8–48	pill 时忽略圆点绘制。
indicator-radius	设后改圆角矩形点	0–约一半边长	0=像素方点；不设则经典正圆椭圆。
indicator-spacing	圆点与文字间距	约 0–64	pill 时忽略。

指示器颜色与渐变

属性	作用	取值 / 范围	说明与注意
indicator-background-color	圆点底（未选/外环内底）	颜色
indicator-border-color	圆点描边	颜色
indicator-background-gradient	选中时圆点底渐变	≥2 色，如 #A78BFA, #6D28D9	覆盖单色底；再叠 mark-color 中心点（示意「紫渐变环」）。
mark-color	选中中心点颜色	颜色，如 #FFFFFF 或品牌色	不要用 :checked { color } 代替。
hover-indicator-border-color / hover-indicator-background-color	悬停圆点	颜色

指示器图片

属性	作用	说明
indicator-checked-image / checked-image	选中替换图	有图则不画矢量圆点
indicator-unchecked-image / unchecked-image	未选中图

---

使用示例

经典圆点

radiobutton {
    color: #1F2937;
    font-size: 13;
    indicator-size: 16;
    indicator-spacing: 8;
    indicator-style: default;
    mark-color: #2563EB;
    transparent-background: true;
}

紫渐变选中环 + 白点

radiobutton#单选紫渐 {
    indicator-size: 18;
    indicator-border-color: #7C3AED;
    mark-color: #FFFFFF;
    indicator-background-gradient: #A78BFA, #6D28D9;
}
radiobutton#单选紫渐:checked {
    mark-color: #FFFFFF;
    indicator-background-gradient: #A78BFA, #6D28D9;
    indicator-border-color: #6D28D9;
}

胶囊选中

radiobutton#单选框1 {
    indicator-style: pill;
    border-radius: 18;
    color: #6B7280;
    transparent-background: true;
    padding: 4 14;
}
radiobutton#单选框1:checked {
    background-color: #7C3AED;
    color: #FFFFFF;
}

像素方点

radiobutton#像素 {
    indicator-radius: 0;
    indicator-size: 14;
    mark-color: #111827;
    indicator-border-color: #111827;
    indicator-background-color: #FFFFFF;
}
radiobutton#像素:checked {
    indicator-checked-background-color: #FDE047;
    mark-color: #111827;
}

隐藏圆点、纯文字选中

radiobutton#纯文字 {
    indicator-style: none;
    border-radius: 8;
}
radiobutton#纯文字:checked {
    background-color: #3E3E42;
    color: #FFFFFF;
}

---

完整示例

radiobutton {
    color: #B0B0B0;
    font-size: 13;
    indicator-size: 16;
    indicator-spacing: 8;
    indicator-style: default;
    mark-color: #9B6FD0;
    transparent-background: true;
    transition: all 160ms ease-out;
}

radiobutton:hover {
    hover-text-color: #FFFFFF;
}

radiobutton:checked {
    mark-color: #9B6FD0;
    color: #E8E8E8;
}

radiobutton#单选框1 {
    indicator-style: pill;
    border-radius: 18;
    color: #B0B0B0;
    transparent-background: true;
    padding: 4 12;
}

radiobutton#单选框1:checked {
    background-color: #9B6FD0;
    color: #FFFFFF;
}

radiobutton#图标选:checked {
    checked-image: :/img/radio-on.png;
}

---