Spec-Zone.ru › GTK 3.22

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 ()

Свойства

GdkRGBA * rgba Чтение / Запись
gboolean use-alpha Чтение / Запись

Сигналы

void color-activated Выполняется первым

Типы и значения

GtkColorChooser

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

    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

a GtkColorChooser

color

a GdkRGBA для заполнения текущим цветом.

[out]

С: 3.4

gtk_color_chooser_set_rgba ()

void
gtk_color_chooser_set_rgba (GtkColorChooser *chooser,
                            const GdkRGBA *color);

Устанавливает цвет.

Параметры

chooser

a GtkColorChooser

color

новый цвет

С: 3.4

gtk_color_chooser_get_use_alpha ()

gboolean
gtk_color_chooser_get_use_alpha (GtkColorChooser *chooser);

Возвращает, отображает ли цветовой выборщик альфа-канал.

Параметры

chooser

a GtkColorChooser

Возвращает

TRUE, если цветовой выборщик использует альфа-канал, FALSE — в противном случае

С: 3.4

gtk_color_chooser_set_use_alpha ()

void
gtk_color_chooser_set_use_alpha (GtkColorChooser *chooser,
                                 gboolean use_alpha);

Устанавливает, должен ли цветовой выборщик использовать альфа-канал.

Параметры

chooser

a GtkColorChooser

use_alpha

TRUE, если цветовой выборщик должен использовать альфа-канал, FALSE — в противном случае

С: 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

a GtkColorChooser

orientation

GTK_ORIENTATION_HORIZONTAL, если палитра должна отображаться по строкам, GTK_ORIENTATION_VERTICAL — для столбцов

colors_per_line

количество цветов, отображаемых в каждой строке/столбце

n_colors

общее количество элементов в colors

colors

цвета палитры или NULL.

[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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API