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 () |
Сигналы
| void | color-activated | Выполняется первым |
Типы и значения
Иерархия объектов
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 |
Возвращает
TRUE если виджет выбора цвета использует альфа-канал, FALSE если нет
С: 3.4
gtk_color_chooser_set_use_alpha ()
void gtk_color_chooser_set_use_alpha (GtkColorChooser *chooser,gboolean use_alpha);
Устанавливает, использовать ли виджету выбора цвета альфа-канал.
Параметры
chooser | ||
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 вертикальная, цвета группируются по столбцам.
По умолчанию палитра виджета GtkColorChooserWidget содержит 27 цветов, организованных в столбцах по 3 цвета. По умолчанию серая палитра содержит 9 оттенков серого в одной строке.
Макет виджета выбора цвета лучше всего работает, когда палитры содержат 9-10 столбцов.
Первый вызов этой функции удаляет из виджета выбора цвета стандартные палитры цветов и серого.
Если colors является пустым, удаляются все ранее добавленные палитры.
Параметры
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. Это свойство можно установить, чтобы программно изменить текущий выбор.
Владелец: GtkColorChooser
Флаги: Чтение / Запись
С версии: 3.4
Свойство “use-alpha”
“use-alpha” gboolean
Когда ::use-alpha TRUE, цвета могут содержать информацию об альфа-канале (прозрачности). Когда оно FALSE, структура GdkRGBA, полученная через свойство “rgba”, будет принудительно иметь alpha == 1.
Ожидается, что реализации будут отображать альфа-канал, рендеря цвет поверх неравномерного фона (например, с использованием шашечной паттерны).
Владелец: GtkColorChooser
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
С версии: 3.4
Подробности сигналов
Сигнал “color-activated”
void user_function (GtkColorChooser *chooser, GdkRGBA *color, gpointer user_data)
Издается, когда цвет активируется в диалоге выбора цвета. Обычно это происходит, когда пользователь нажимает на цветовой образец или когда цвет выбирается, а пользователь нажимает клавиши Пробел, Shift+Пробел, Возврат или Enter.
Параметры
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.24/GtkColorChooser.html