Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Implemented Interfaces  |  Properties  |  Signals

GtkColorSelection

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. Допустимой политикой являются:

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 :

Пользовательские данные устанавливаемые при подключении обработчика сигнала.