2.2.4. Toggle¶
Toggle 控件用于在屏幕上绘制一个开关,通过控制开关的开启与闭合来执行一些具体的操作。
-
toggle_object.
set_text
(string, [color_r, color_g, color_b, color_a, ]align, size)¶ 描述: 设置控件的显示文字
参数: - string (string) – 控件上显示的字符串内容
- [color_r, color_g, color_b, color_a] (list) – 可选参数,需要显示的字符串的颜色,参数分别为显示颜色 r 值、b 值、g 值、透明度,取值范围都为 [0, 255]
- align (enum) – 可选参数,枚举类型,需要显示文字的对齐方式,详细见表格
align
- size (int) – 显示文字的字号大小
返回: 无
示例: my_Toggle.set_text(120, 120, 120, 200, text_anchor.upper_left, 12)
示例说明: 设置文字的 rgb 值为(120, 120, 120),透明度为 200,字体对齐方式为顶端左对齐,字号大小为 12 号
-
toggle_object.
set_text_color
(r, g, b, a)¶ 描述: 设置文字的颜色
参数: - r (int) – 文字颜色的 r 值,范围为 [0, 255]
- g (int) – 文字颜色的 g 值,范围为 [0, 255]
- b (int) – 文字颜色的 b 值,范围为 [0, 255]
- a (int) – 文字颜色的透明度,范围为 [0, 255]
返回: 无
示例: my_Toggle.set_text_color(120, 120, 120, 200)
示例说明: 设置字体的 rgb 值为(120, 120, 120),透明度为 200
-
toggle_object.
set_text_align
(align)¶ 描述: 设置文字的对齐方式 参数: align (enum) – 可选参数,枚举类型,需要显示文字的对齐方式,详细见表格 align
返回: 无 示例: my_Toggle.set_text_align(text_anchor.upper_left)
示例说明: 设置字体的对齐方式为顶端左对齐
-
toggle_object.
set_text_size
(size)¶ 描述: 设置文字的字号大小 参数: size (int) – 文字的字号值 返回: 无 示例: my_Toggle.set_text_size(12)
示例说明: 设置文字的字号为 12 号
-
toggle_object.
set_background_color
(r, g, b, a)¶ 描述: 设置控件的背景色
参数: - r (int) – 背景颜色的 r 值,范围为 [0, 255]
- g (int) – 背景颜色的 g 值,范围为 [0, 255]
- b (int) – 背景颜色的 b 值,范围为 [0, 255]
- a (int) – 背景颜色的透明度,[0, 255]
返回: 无
示例: my_Toggle.set_background_color(200, 200, 200, 230)
示例说明: 设置背景色的 rgb 值为 (200, 200, 200),透明度为 230
-
toggle_object.
set_checkmark_color
(r, g, b, a)¶ 描述: 设置控件选中图标的颜色
参数: - r (int) – 图标颜色的 r 值,范围为 [0, 255]
- g (int) – 图标颜色的 g 值,范围为 [0, 255]
- b (int) – 图标颜色的 b 值,范围为 [0, 255]
- a (int) – 图标颜色的透明度,范围为 [0, 255]
返回: 无
示例: my_Toggle.set_checkmark_color(200, 200, 200, 230)
示例说明: 设置选中图标的 rgb 值为 (200, 200, 200),透明度为 230
-
toggle_object.
set_is_on
(status)¶ 描述: 设置控件的状态 参数: status (bool) – 设置控件是否为打开状态,True 表示打开,False 表示关闭 返回: 无 示例: my_Toggle.set_is_on(True)
示例说明: 设置 Toggle 控件为打开状态