краткое описание

#include <gtk/gtk.h>


            gtkcolorbutton;
gtkwidget*  gtk_color_button_new            (void);
gtkwidget*  gtk_color_button_new_with_color (const gdkcolor *color);
void        gtk_color_button_set_color      (gtkcolorbutton *color_button,
                                             const gdkcolor *color);
void        gtk_color_button_get_color      (gtkcolorbutton *color_button,
                                             gdkcolor *color);
void        gtk_color_button_set_alpha      (gtkcolorbutton *color_button,
                                             guint16 alpha);

guint16     gtk_color_button_get_alpha      (gtkcolorbutton *color_button);
void        gtk_color_button_set_use_alpha  (gtkcolorbutton *color_button,
                                             gboolean use_alpha);

gboolean    gtk_color_button_get_use_alpha  (gtkcolorbutton *color_button);
void        gtk_color_button_set_title      (gtkcolorbutton *color_button,
                                             const gchar *title);
const gchar* gtk_color_button_get_title     (gtkcolorbutton *color_button);

иерархия объектов

  gobject
   +----ginitiallyunowned
         +----gtkobject

               +----gtkwidget
                     +----gtkcontainer
                           +----gtkbin
                                 +----gtkbutton
                                       +----gtkcolorbutton

реализуемые интерфейсы

gtkcolorbutton реализует atkimplementoriface.

свойства

  "alpha"                guint                 : read / write
  "color"                gdkcolor              : read / write
  "title"                gchararray            : read / write
  "use-alpha"            gboolean              : read / write

сигналы

"color-set" void        user_function      (gtkcolorbutton *widget,
                                            gpointer        user_data)      : run first

описание

gtkcolorbutton это кнопка которая отображает текущий выбранный цвет и позволяет открывать диалог выбора цвета для его изменения. это удобный виджет для выбора цвета в диалоге параметров.

детали

gtkcolorbutton

typedef struct _gtkcolorbutton gtkcolorbutton;

структура gtkcolorbutton содержит только закрытые данные и должна использоваться только функциями описанными ниже.

gtk_color_button_new ()

gtkwidget*  gtk_color_button_new            (void);

создаёт новую кнопку выбора цвета. возвращается виджет в форме небольшой кнопки содержащей образец текущемго выбранного цвета. при нажатии на кнопку открывается диалог выбора цвета, позволяющий пользователю выбрать цвет. образец на кнопке будет отражать новый цвет после того как пользователь завершит выбор.

начиная с версии 2.4

gtk_color_button_new_with_color ()

gtkwidget*  gtk_color_button_new_with_color (const gdkcolor *color);

создаёт новую кнопку выбора цвета.

начиная с версии 2.4

gtk_color_button_set_color ()

void        gtk_color_button_set_color      (gtkcolorbutton *color_button,
                                             const gdkcolor *color);

устанавливает текущий цвет в значение color.

начиная с версии 2.4

gtk_color_button_get_color ()

void        gtk_color_button_get_color      (gtkcolorbutton *color_button,
                                             gdkcolor *color);

устанавливает color в текущий цвет в виджете gtkcolorbutton.

начиная с версии 2.4

gtk_color_button_set_alpha ()

void        gtk_color_button_set_alpha      (gtkcolorbutton *color_button,
                                             guint16 alpha);

устанавливает текущую прозрачность в значение alpha.

начиная с версии 2.4

gtk_color_button_get_alpha ()

guint16     gtk_color_button_get_alpha      (gtkcolorbutton *color_button);

возвращает текущеме значение альфа канала.

начиная с версии 2.4

gtk_color_button_set_use_alpha ()

void        gtk_color_button_set_use_alpha  (gtkcolorbutton *color_button,
                                             gboolean use_alpha);

устанавливает должна ли кнопка использовать альфа канал.

начиная с версии 2.4

gtk_color_button_get_use_alpha ()

gboolean    gtk_color_button_get_use_alpha  (gtkcolorbutton *color_button);

использует ли диалог выбора цвета альфа канал?

начиная с версии 2.4

gtk_color_button_set_title ()

void        gtk_color_button_set_title      (gtkcolorbutton *color_button,
                                             const gchar *title);

устанавливает заголовок для диалога выбора цвета.

начиная с версии 2.4

gtk_color_button_get_title ()

const gchar* gtk_color_button_get_title     (gtkcolorbutton *color_button);

возвращает заголовок диалога выбора цвета.

начиная с версии 2.4

детали свойств

свойство "alpha"

  "alpha"                guint                 : read / write

выбранное значение прозрачности (0 полная прозрачность, 65535 полностью непрозрачный).

допустимые значения: <= 65535

значение по умолчанию: 65535

начиная с версии 2.4

свойство "color"

  "color"                gdkcolor              : read / write

выбранный цвет.

начиная с версии 2.4

свойство "title"

  "title"                gchararray            : read / write

заголовок диалога выбора цвета.

значение по умолчанию: "pick a color"

начиная с версии 2.4

свойство "use-alpha"

  "use-alpha"            gboolean              : read / write

если это свойство установлено в значение true, образец цвета на кнопке изображается сквозь шахматный фон для отображения его прозрачности, а ползунок прозрачности отображается в диалоге выбора цвета.

значение по умолчанию: false

начиная с версии 2.4

детали сигнала

сигнал "color-set"

void        user_function                  (gtkcolorbutton *widget,
                                            gpointer        user_data)      : run first

сигнал ::color-set издаётся когда пользователь выбрал цвет. когда обрабатывается этот сигнал, используются gtk_color_button_get_color() и gtk_color_button_get_alpha() для обнаружения цвета который был выбран.

помните, сигнал издаётся только когда пользователь изменяет цвет. если вам нужна реакция на программное изменение цвета, используйте сигнал notify::color.

начиная с версии 2.4

смотрите также

gtkcolorselectiondialog, gtkfontbutton