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 | данные пользователя, установленные при подключении обработчика сигнала. |
Флаги: Run First
С: 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.20/GtkColorChooser.html