GtkColorChooser
GtkColorChooser — Интерфейс, реализуемый виджетами для выбора цветов
Функции
| void | gtk_color_chooser_get_rgba () |
| void | gtk_color_chooser_set_rgba () |
| gboolean | gtk_color_chooser_get_use_alpha () |
| void | gtk_color_chooser_set_use_alpha () |
| void | gtk_color_chooser_add_palette () |
Сигналы
Типы и значения
Иерархия объектов
GInterface ╰── GtkColorChooser
Предварительные требования
GtkColorChooser требует GObject.
Известные реализации
GtkColorChooser реализован в GtkColorButton, GtkColorChooserDialog и GtkColorChooserWidget.
Файлы включения
#include <gtk/gtk.h>
Описание
GtkColorChooser — это интерфейс, реализуемый виджетами для выбора цветов. В зависимости от ситуации, цвета могут иметь альфа-канал (прозрачность).
В GTK+ основными виджетами, реализующими этот интерфейс, являются GtkColorChooserWidget, GtkColorChooserDialog и GtkColorButton.
Функции
gtk_color_chooser_get_rgba ()
void gtk_color_chooser_get_rgba (GtkColorChooser *chooser,GdkRGBA *color);
Получает текущий выбранный цвет.
Параметры
chooser | ||
color | a GdkRGBA для заполнения текущим цветом. | [out] |
С: 3.4
gtk_color_chooser_set_rgba ()
void gtk_color_chooser_set_rgba (GtkColorChooser *chooser,const GdkRGBA *color);
Устанавливает цвет.
Параметры
chooser | ||
color | новый цвет |
С: 3.4
gtk_color_chooser_get_use_alpha ()
gboolean
gtk_color_chooser_get_use_alpha (GtkColorChooser *chooser); Возвращает, отображает ли цветовой выборщик альфа-канал.
Параметры
chooser |
С: 3.4
gtk_color_chooser_set_use_alpha ()
void gtk_color_chooser_set_use_alpha (GtkColorChooser *chooser,gboolean use_alpha);
Устанавливает, должен ли цветовой выборщик использовать альфа-канал.
Параметры
С: 3.4
gtk_color_chooser_add_palette ()
void gtk_color_chooser_add_palette (GtkColorChooser *chooser,GtkOrientation orientation,gint colors_per_line,gint n_colors,GdkRGBA *colors);
Добавляет палитру к цветовому выборщику. Если orientation горизонтальна, цвета группируются по строкам, по colors_per_line цветов в каждой строке. Если horizontal — FALSE, цвета группируются по столбцам.
По умолчанию цветовая палитра GtkColorChooserWidget содержит 27 цветов, организованных в столбцы по 3 цвета. Палитра серых цветов по умолчанию содержит 9 оттенков серого в одной строке.
Макет виджета цветового выбора лучше всего работает, когда палитры имеют 9-10 столбцов.
Первый вызов этой функции приводит к удалению стандартных цветовой и серой палитр из цветового выбора.
Если colors — NULL, удаляет все ранее добавленные палитры.
Параметры
chooser | ||
orientation |
| |
colors_per_line | количество цветов, отображаемых в каждой строке/столбце | |
n_colors | общее количество элементов в | |
colors | цвета палитры или | [allow-none][array length=n_colors] |
С: 3.4
Типы и значения
GtkColorChooser
typedef struct _GtkColorChooser GtkColorChooser;
Подробное описание свойств
Свойство “rgba”
“rgba” GdkRGBA *
Свойство ::rgba содержит текущий выбранный цвет в виде структуры GdkRGBA. Свойство можно установить, чтобы программно изменить текущий выбор.
Флаги: Чтение / Запись
С: 3.4
Свойство “use-alpha”
“use-alpha” gboolean
Когда ::use-alpha — TRUE, цвета могут содержать информацию об альфа-канале (прозрачность). Когда оно — FALSE, структура GdkRGBA, полученная через свойство “rgba”, будет принудительно иметь alpha == 1.
Ожидается, что реализации отобразят альфа-канал, нарисовав цвет поверх неравномерного фона (например, шахматного узора).
Флаги: Чтение / Запись
Значение по умолчанию: ИСТИНА
С: 3.4
Подробное описание сигналов
Сигнал “color-activated”
void user_function (GtkColorChooser *chooser, GdkRGBA *color, gpointer user_data)
Используется при активации цвета в цветовом выборщике. Обычно это происходит при щелчке пользователя по образцу цвета или при выборе цвета и нажатии одной из клавиш Пробел, Shift+Пробел, Возврат или Ввод.
Параметры
chooser | объект, получивший сигнал | |
color | цвет | |
user_data | данные пользователя, установленные при подключении обработчика сигналов. |
Флаги: Первое выполнение
С: 3.4
См. также
GtkColorChooserDialog, GtkColorChooserWidget, GtkColorButton
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.22/GtkColorChooser.html