颜色选择器

在 1.7.0 版本加入.

警告

该控件为实验性功能。在移除本警告之前,其使用方式及API可能随时发生变更。

_images/colorpicker.png

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)[源代码]

基类:RelativeLayout

请参阅模块文档。

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)[源代码]

基类:Widget

ColorPicker 的色相环。

在 1.7.1 版本发生变更: font_sizefont_nameforeground_color 已被移除。现在尺寸与其他控件一致,基于 'sp' 单位。方向也会根据宽高比自动确定。

a

当前所选颜色的Alpha值。

a 是一个 BoundedNumericProperty,其值范围从 0 到 1。默认值为 0。

b

当前所选颜色的蓝色值。

b 是一个 BoundedNumericProperty,其值范围从 0 到 1。默认值为 0。

color

保存当前所选颜色的属性。

color 是一个 ReferenceListProperty,包含 rgba 值的列表。其默认值为 [0, 0, 0, 0]

g

当前所选颜色的绿色值。

g 是一个 BoundedNumericProperty,其值范围从 0 到 1。默认值为 0。

on_touch_down(touch)[源代码]

接收触摸按下事件。

参数:
touchMotionEvent

收到触摸事件。该触摸位于父级坐标系中。关于坐标系统的讨论,请参阅 relativelayout

返回:

bool 如果为 True,触摸事件的派发将停止。如果为 False,事件将继续派发给控件树中的其余部分。

on_touch_move(touch)[源代码]

接收触摸移动事件。触摸坐标位于父级坐标系中。

更多信息请参阅 on_touch_down()

on_touch_up(touch)[源代码]

接收触摸抬起事件。触摸坐标位于父级坐标系中。

更多信息请参阅 on_touch_down()

r

当前所选颜色的红色值。

r 是一个 BoundedNumericProperty,其值范围从 0 到 1。默认值为 0。