gtkcolorselection

			gtk+ reference manual
top \| description \| object hierarchy \| implemented interfaces \| properties \| signals

gtkcolorselection — виджет используемый для выбора цвета

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

#include <gtk/gtk.h>


            gtkcolorselection;
gtkwidget*  gtk_color_selection_new         (void);
void        gtk_color_selection_set_update_policy

                                            (gtkcolorselection *colorsel,
                                             gtkupdatetype policy);
void        gtk_color_selection_set_has_opacity_control
                                            (gtkcolorselection *colorsel,
                                             gboolean has_opacity);

gboolean    gtk_color_selection_get_has_opacity_control
                                            (gtkcolorselection *colorsel);
void        gtk_color_selection_set_has_palette
                                            (gtkcolorselection *colorsel,
                                             gboolean has_palette);

gboolean    gtk_color_selection_get_has_palette
                                            (gtkcolorselection *colorsel);
guint16     gtk_color_selection_get_current_alpha
                                            (gtkcolorselection *colorsel);
void        gtk_color_selection_set_current_alpha

                                            (gtkcolorselection *colorsel,
                                             guint16 alpha);
void        gtk_color_selection_get_current_color
                                            (gtkcolorselection *colorsel,
                                             gdkcolor *color);
void        gtk_color_selection_set_current_color

                                            (gtkcolorselection *colorsel,
                                             const gdkcolor *color);
guint16     gtk_color_selection_get_previous_alpha
                                            (gtkcolorselection *colorsel);
void        gtk_color_selection_set_previous_alpha

                                            (gtkcolorselection *colorsel,
                                             guint16 alpha);
void        gtk_color_selection_get_previous_color
                                            (gtkcolorselection *colorsel,
                                             gdkcolor *color);
void        gtk_color_selection_set_previous_color

                                            (gtkcolorselection *colorsel,
                                             const gdkcolor *color);
gboolean    gtk_color_selection_is_adjusting
                                            (gtkcolorselection *colorsel);

gboolean    gtk_color_selection_palette_from_string
                                            (const gchar *str,
                                             gdkcolor **colors,
                                             gint *n_colors);
gchar*      gtk_color_selection_palette_to_string

                                            (const gdkcolor *colors,
                                             gint n_colors);
gtkcolorselectionchangepalettefunc gtk_color_selection_set_change_palette_hook
                                            (gtkcolorselectionchangepalettefunc func);
void        (*gtkcolorselectionchangepalettefunc)
                                            (const gdkcolor *colors,
                                             gint n_colors);

gtkcolorselectionchangepalettewithscreenfunc gtk_color_selection_set_change_palette_with_screen_hook
                                            (gtkcolorselectionchangepalettewithscreenfunc func);
void        (*gtkcolorselectionchangepalettewithscreenfunc)
                                            (gdkscreen *screen,
                                             const gdkcolor *colors,
                                             gint n_colors);
void        gtk_color_selection_set_color   (gtkcolorselection *colorsel,
                                             gdouble *color);
void        gtk_color_selection_get_color   (gtkcolorselection *colorsel,
                                             gdouble *color);

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

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

               +----gtkwidget
                     +----gtkcontainer
                           +----gtkbox
                                 +----gtkvbox
                                       +----gtkcolorselection

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

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

свойства

  "current-alpha"        guint                 : read / write
  "current-color"        gdkcolor              : read / write
  "has-opacity-control"  gboolean              : read / write
  "has-palette"          gboolean              : read / write

сигналы

"color-changed"
            void        user_function      (gtkcolorselection *colorselection,
                                            gpointer           user_data)           : run first

описание

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

детали

gtkcolorselection

typedef struct _gtkcolorselection gtkcolorselection;

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

gtk_color_selection_new ()

gtkwidget*  gtk_color_selection_new         (void);

создаёт новый gtkcolorselection.

возвращает :

новый gtkcolorselection

gtk_color_selection_set_update_policy ()

void        gtk_color_selection_set_update_policy
                                            (gtkcolorselection *colorsel,
                                             gtkupdatetype policy);

внимание

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

устанавливает политику контроля за изданием сигнала color_changed. допустимой политикой являются:

gtk_update_continuous – беспрерывная отправка сигнала пока изменяется цвет.
gtk_update_discontinuous – сигнал отправляется только когда отпущена кнопка мыши.
gtk_update_delayed – сигнал отправляется когда кнопка мыши отпущена или когда мышь неподвижна в период времени.

`colorsel` :	gtkcolorselection.
`policy` :	gtkupdatetype значение указывающее желательную политику.

gtk_color_selection_set_has_opacity_control ()

void        gtk_color_selection_set_has_opacity_control
                                            (gtkcolorselection *colorsel,
                                             gboolean has_opacity);

устанавливает colorsel для использования или не использования прозрачности.

`colorsel` :	gtkcolorselection.
`has_opacity` :	`true` если `colorsel` может установить прозрачность, иначе `false`.

gtk_color_selection_get_has_opacity_control ()

gboolean    gtk_color_selection_get_has_opacity_control
                                            (gtkcolorselection *colorsel);

определяет имеет ли colorsel контроль прозрачности.

`colorsel` :	gtkcolorselection.
возвращает :	`true` если `colorsel` имеет контроль прозрачности. `false` если нет.

gtk_color_selection_set_has_palette ()

void        gtk_color_selection_set_has_palette
                                            (gtkcolorselection *colorsel,
                                             gboolean has_palette);

показывает и скрывает палитру основанную на значении has_palette.

`colorsel` :	gtkcolorselection.
`has_palette` :	`true` если палитра должна быть видима, иначе `false`.

gtk_color_selection_get_has_palette ()

gboolean    gtk_color_selection_get_has_palette
                                            (gtkcolorselection *colorsel);

определяет имеет ли селектор выбора цветовую палитру.

`colorsel` :	gtkcolorselection.
возвращает :	`true` если селектор имеет палитру. `false` если не имеет.

gtk_color_selection_get_current_alpha ()

guint16     gtk_color_selection_get_current_alpha
                                            (gtkcolorselection *colorsel);

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

`colorsel` :	gtkcolorselection.
возвращает :	целочисленное в пределах от 0 до 65535.

gtk_color_selection_set_current_alpha ()

void        gtk_color_selection_set_current_alpha
                                            (gtkcolorselection *colorsel,
                                             guint16 alpha);

устанавливает текущую прозрачность равную значению alpha. при первом вызове, она также устанавливает исходную прозрачность в значение alpha.

`colorsel` :	gtkcolorselection.
`alpha` :	целочисленное в пределах от 0 до 65535.

gtk_color_selection_get_current_color ()

void        gtk_color_selection_get_current_color
                                            (gtkcolorselection *colorsel,
                                             gdkcolor *color);

устанавливает color значением текущемго цвета в виджете gtkcolorselection.

`colorsel` :	gtkcolorselection.
`color` :	gdkcolor для установки текущемго цвета.

gtk_color_selection_set_current_color ()

void        gtk_color_selection_set_current_color
                                            (gtkcolorselection *colorsel,
                                             const gdkcolor *color);

устанавливает текущий цвет в значение color. при первом вызове, она так же устанавливает исходный цвет в значение color.

`colorsel` :	gtkcolorselection.
`color` :	gdkcolor для установки текущемго цвета.

gtk_color_selection_get_previous_alpha ()

guint16     gtk_color_selection_get_previous_alpha
                                            (gtkcolorselection *colorsel);

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

`colorsel` :	gtkcolorselection.
возвращает :	целочисленное в пределах от 0 до 65535.

gtk_color_selection_set_previous_alpha ()

void        gtk_color_selection_set_previous_alpha
                                            (gtkcolorselection *colorsel,
                                             guint16 alpha);

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

`colorsel` :	gtkcolorselection.
`alpha` :	целочисленное в пределах от 0 до 65535.

gtk_color_selection_get_previous_color ()

void        gtk_color_selection_get_previous_color
                                            (gtkcolorselection *colorsel,
                                             gdkcolor *color);

заполняет color изначальным значением цвета.

`colorsel` :	gtkcolorselection.
`color` :	gdkcolor для заполнения оригинального значения цвета.

gtk_color_selection_set_previous_color ()

void        gtk_color_selection_set_previous_color
                                            (gtkcolorselection *colorsel,
                                             const gdkcolor *color);

устанавливает 'предыдущий' цвет в значение color. эту функцию необходимо вызывать с некоторым перерывом, поскольку наличие изменения в цвете может казаться запутывающим. вызов gtk_color_selection_set_current_color() также установит цвет в первоначальное значение.

`colorsel` :	gtkcolorselection.
`color` :	gdkcolor для установки первоначального цвета.

gtk_color_selection_is_adjusting ()

gboolean    gtk_color_selection_is_adjusting
                                            (gtkcolorselection *colorsel);

выдаёт текущеме состояние colorsel.

`colorsel` :	gtkcolorselection.
возвращает :	`true` если пользователь в текущий момент перемещает цветовой круг, и `false` если выбор остановлен.

gtk_color_selection_palette_from_string ()

gboolean    gtk_color_selection_palette_from_string
                                            (const gchar *str,
                                             gdkcolor **colors,
                                             gint *n_colors);

анализирует строку цветовой палитры; строка представляет список разделенных двоеточиями имён цветов, читаемый функцией gdk_color_parse().

`str` :	строка кодов цветов палитры.
`colors` :	место хранения возвращаемого массива gdkcolor.
`n_colors` :	место хранения возвращаемого значения длины массива.
возвращает :	`true` если палитра полностью проанализирована.

gtk_color_selection_palette_to_string ()

gchar*      gtk_color_selection_palette_to_string
                                            (const gdkcolor *colors,
                                             gint n_colors);

кодирует палитру как строку, полезно для надёжного хранения.

`colors` :	массив цветов.
`n_colors` :	длина массива.
возвращает :	строка закодированной палитры.

gtk_color_selection_set_change_palette_hook ()

gtkcolorselectionchangepalettefunc gtk_color_selection_set_change_palette_hook
                                            (gtkcolorselectionchangepalettefunc func);

внимание

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

устанавливает глобальную функцию, которая вызывается каждый раз когда пользователь пытается изменить палитру в селекторе цвета. эта функция должна сохранять новое содержимое палитры и обновлять gtksettings свойство "gtk-color-palette", таким образом все gtkcolorselection виджеты будут изменены.

`func` :	функция вызываемая когда необходимо сохранить изменения палитры.
возвращает :	предыдущая обработанная изменяемая палитра (которая заменяется).

gtkcolorselectionchangepalettefunc ()

void        (*gtkcolorselectionchangepalettefunc)
                                            (const gdkcolor *colors,
                                             gint n_colors);

`colors` :
`n_colors` :

gtk_color_selection_set_change_palette_with_screen_hook ()

gtkcolorselectionchangepalettewithscreenfunc gtk_color_selection_set_change_palette_with_screen_hook
                                            (gtkcolorselectionchangepalettewithscreenfunc func);

устанавливает глобальную функцию, которая вызывается каждый раз когда пользователь пытается изменить палитру в селекторе цвета. эта функция должна сохранять новое содержимое палитры, и обновлять gtksettings свойство "gtk-color-palette", таким образом все gtkcolorselection виджеты будут изменены.

`func` :	функция вызываемая когда необходимо сохранить изменения палитры.
возвращает :	предыдущая обработанная изменяемая палитра (которая заменяется).

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

gtkcolorselectionchangepalettewithscreenfunc ()

void        (*gtkcolorselectionchangepalettewithscreenfunc)
                                            (gdkscreen *screen,
                                             const gdkcolor *colors,
                                             gint n_colors);

`screen` :
`colors` :
`n_colors` :

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

gtk_color_selection_set_color ()

void        gtk_color_selection_set_color   (gtkcolorselection *colorsel,
                                             gdouble *color);

внимание

gtk_color_selection_set_color устарела и не должна использоваться во вновь создаваемом коде. вместо неё используйте gtk_color_selection_set_current_color().

устанавливает текущий цвет в значение color. при первом вызове, она также установит оригинальный цвет в значение color.

`colorsel` :	gtkcolorselection.
`color` :	массив четырех пар определяющих красный, зеленый, голубой и прозрачность для установки текущемго цвета.

gtk_color_selection_get_color ()

void        gtk_color_selection_get_color   (gtkcolorselection *colorsel,
                                             gdouble *color);

внимание

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

устанавливает color текущим цветом в виджете gtkcolorselection.

эта функция устарела, вместо неё используйте gtk_color_selection_get_current_color().

`colorsel` :	gtkcolorselection.
`color` :	массив 4 gdouble для заполнения текущемго цвета.

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

свойство "`current-alpha`"

  "current-alpha"        guint                 : read / write

текущее значение прозрачности (0 полная прозрачность, 65535 полная не прозрачность).

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

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

свойство "`current-color`"

  "current-color"        gdkcolor              : read / write

текущий цвет.

свойство "`has-opacity-control`"

  "has-opacity-control"  gboolean              : read / write

позволяет ли селектор цвета установку прозрачности.

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

свойство "`has-palette`"

  "has-palette"          gboolean              : read / write

должна ли использоваться палитра.

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

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

сигнал "color-changed"

void        user_function                  (gtkcolorselection *colorselection,
                                            gpointer           user_data)           : run first

этот сигнал издаётся при изменении цвета в gtkcolorselection согласно политики обновления.

`colorselection` :	объект получающий сигнал.
`user_data` :	пользовательские данные устанавливаемые при подключении обработчика сигнала.

gtkcolorselection

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

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

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

свойства

сигналы

описание

детали

gtkcolorselection

gtk_color_selection_new ()

gtk_color_selection_set_update_policy ()

внимание

gtk_color_selection_set_has_opacity_control ()

gtk_color_selection_get_has_opacity_control ()

gtk_color_selection_set_has_palette ()

gtk_color_selection_get_has_palette ()

gtk_color_selection_get_current_alpha ()

gtk_color_selection_set_current_alpha ()

gtk_color_selection_get_current_color ()

gtk_color_selection_set_current_color ()

gtk_color_selection_get_previous_alpha ()

gtk_color_selection_set_previous_alpha ()

gtk_color_selection_get_previous_color ()

gtk_color_selection_set_previous_color ()

gtk_color_selection_is_adjusting ()

gtk_color_selection_palette_from_string ()

gtk_color_selection_palette_to_string ()

gtk_color_selection_set_change_palette_hook ()

внимание

gtkcolorselectionchangepalettefunc ()

gtk_color_selection_set_change_palette_with_screen_hook ()

gtkcolorselectionchangepalettewithscreenfunc ()

gtk_color_selection_set_color ()

внимание

gtk_color_selection_get_color ()

внимание

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

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

свойство "current-color"

свойство "has-opacity-control"

свойство "has-palette"

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

сигнал "color-changed"

свойство "`current-alpha`"

свойство "`current-color`"

свойство "`has-opacity-control`"

свойство "`has-palette`"