檢視原始碼 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 中實作）。