查看源代码 wxColourPickerCtrl (wx v2.4.3)

此控件允许用户选择颜色。

通用实现是一个按钮，单击该按钮会弹出 wxColourDialog。原生实现可能有所不同，但通常是一个（小）部件，用于访问颜色选择器对话框。仅当 wxUSE_COLOURPICKERCTRL 设置为 1（默认值）时才可用。

样式

此类支持以下样式

wxCLRP_DEFAULT_STYLE：默认样式：0。
wxCLRP_USE_TEXTCTRL：在选择器按钮的左侧创建一个文本控件，该控件完全由 wxColourPickerCtrl 管理，并且用户可以使用它来指定颜色（请参阅 SetColour）。文本控件会自动与按钮的值同步。使用 wxPickerBase 中定义的函数来修改文本控件。
wxCLRP_SHOW_LABEL：以 HTML 形式 (AABBCC) 将颜色显示为颜色按钮标签（而不是完全没有标签）。
wxCLRP_SHOW_ALPHA：允许在颜色选择器中选择不透明度（在 wxGTK 和 wxOSX 下有效）。

参见

此类派生自以下类，并可以使用其中的函数

wxWidgets 文档：wxColourPickerCtrl

事件

此类发出的事件类型

command_colourpicker_changed

概要

类型

wxColourPickerCtrl()

函数

create(This, Parent, Id)

等效于 create(This, Parent, Id, [])。

create/4

使用给定的参数创建颜色选择器。

destroy(This)

销毁对象

getColour(This)

返回当前选择的颜色。

new()

new(Parent, Id)

等效于 new(Parent, Id, [])。

new/3

初始化对象并使用所有参数调用 create/4。

setColour/2

设置当前选择的颜色。

类型

wxColourPickerCtrl()

-type wxColourPickerCtrl() :: wx:wx_object().

函数

create(This, Parent, Id)

-spec create(This, Parent, Id) -> boolean()
                when This :: wxColourPickerCtrl(), Parent :: wxWindow:wxWindow(), Id :: integer().

等效于 create(This, Parent, Id, [])。

create/4

-spec create(This, Parent, Id, [Option]) -> boolean()
                when
                    This :: wxColourPickerCtrl(),
                    Parent :: wxWindow:wxWindow(),
                    Id :: integer(),
                    Option ::
                        {col, wx:wx_colour()} |
                        {pos, {X :: integer(), Y :: integer()}} |
                        {size, {W :: integer(), H :: integer()}} |
                        {style, integer()} |
                        {validator, wx:wx_object()}.

使用给定的参数创建颜色选择器。

返回：如果控件创建成功则返回 true，如果创建失败则返回 false。

destroy(This)

-spec destroy(This :: wxColourPickerCtrl()) -> ok.

销毁对象

getColour(This)

-spec getColour(This) -> wx:wx_colour4() when This :: wxColourPickerCtrl().

返回当前选择的颜色。

new()

-spec new() -> wxColourPickerCtrl().

new(Parent, Id)

-spec new(Parent, Id) -> wxColourPickerCtrl() when Parent :: wxWindow:wxWindow(), Id :: integer().

等效于 new(Parent, Id, [])。

new/3

-spec new(Parent, Id, [Option]) -> wxColourPickerCtrl()
             when
                 Parent :: wxWindow:wxWindow(),
                 Id :: integer(),
                 Option ::
                     {col, wx:wx_colour()} |
                     {pos, {X :: integer(), Y :: integer()}} |
                     {size, {W :: integer(), H :: integer()}} |
                     {style, integer()} |
                     {validator, wx:wx_object()}.

初始化对象并使用所有参数调用 create/4。

setColour/2

-spec setColour(This, Colname) -> ok when This :: wxColourPickerCtrl(), Colname :: unicode:chardata();
               (This, Col) -> ok when This :: wxColourPickerCtrl(), Col :: wx:wx_colour().

设置当前选择的颜色。

请参阅 wxColour::Set()（未在 wx 中实现）。