目录
颜色选择器¶
在 1.7.0 版本加入.
警告
该控件为实验性功能。在移除本警告之前,其使用方式及API可能随时发生变更。
ColorPicker 控件允许用户从色轮中选择颜色,其中可以通过捏合和缩放来改变色轮的饱和度。同时提供了滑块和文本输入框,以便直接输入 RGBA/HSV/HEX 值。
用法:
clr_picker = ColorPicker()
parent.add_widget(clr_picker)
# To monitor changes, we can bind to color property changes
def on_color(instance, value):
print("RGBA = ", str(value)) # or instance.color
print("HSV = ", str(instance.hsv))
print("HEX = ", str(instance.hex_color))
clr_picker.bind(color=on_color)
- class kivy.uix.colorpicker.ColorPicker(**kwargs)[源代码]¶
-
请参阅模块文档。
- color¶
:属性
color保存当前以 rgba 格式选中的颜色。color是一个ListProperty,默认值为 (1, 1, 1, 1)。
- font_name¶
指定 ColorPicker 上使用的字体。
font_name是一个StringProperty,默认值为 'data/fonts/RobotoMono-Regular.ttf'。
- hex_color¶
:属性
hex_color保存当前选中的颜色,以十六进制表示。hex_color是一个AliasProperty,默认值为 #ffffffff。
- hsv¶
:属性
hsv保存了当前以 hsv 格式选中的颜色。hsv是一个ListProperty,默认值为 (1, 1, 1)。
- wheel¶
wheel属性持有颜色轮。wheel是一个ObjectProperty,默认值为 None。
- class kivy.uix.colorpicker.ColorWheel(**kwargs)[源代码]¶
基类:
WidgetColorPicker 的色相环。
在 1.7.1 版本发生变更: font_size、font_name 和 foreground_color 已被移除。现在尺寸与其他控件一致,基于 'sp' 单位。方向也会根据宽高比自动确定。
- a¶
当前所选颜色的Alpha值。
a是一个BoundedNumericProperty,其值范围从 0 到 1。默认值为 0。
- b¶
当前所选颜色的蓝色值。
b是一个BoundedNumericProperty,其值范围从 0 到 1。默认值为 0。
- color¶
保存当前所选颜色的属性。
color是一个ReferenceListProperty,包含 r、g、b、a 值的列表。其默认值为 [0, 0, 0, 0]。
- g¶
当前所选颜色的绿色值。
g是一个BoundedNumericProperty,其值范围从 0 到 1。默认值为 0。
- on_touch_down(touch)[源代码]¶
接收触摸按下事件。
- 参数:
- touch:
MotionEvent类 收到触摸事件。该触摸位于父级坐标系中。关于坐标系统的讨论,请参阅
relativelayout。
- touch:
- 返回:
bool 如果为 True,触摸事件的派发将停止。如果为 False,事件将继续派发给控件树中的其余部分。
- on_touch_move(touch)[源代码]¶
接收触摸移动事件。触摸坐标位于父级坐标系中。
更多信息请参阅
on_touch_down()。
- on_touch_up(touch)[源代码]¶
接收触摸抬起事件。触摸坐标位于父级坐标系中。
更多信息请参阅
on_touch_down()。
- r¶
当前所选颜色的红色值。
r是一个BoundedNumericProperty,其值范围从 0 到 1。默认值为 0。