Spec-Zone.ru › GTK 3.24

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 вертикальная, цвета группируются по столбцам.

По умолчанию палитра виджета GtkColorChooserWidget содержит 27 цветов, организованных в столбцах по 3 цвета. По умолчанию серая палитра содержит 9 оттенков серого в одной строке.

Макет виджета выбора цвета лучше всего работает, когда палитры содержат 9-10 столбцов.

Первый вызов этой функции удаляет из виджета выбора цвета стандартные палитры цветов и серого.

Если colors является пустым, удаляются все ранее добавленные палитры.

Параметры

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. Это свойство можно установить, чтобы программно изменить текущий выбор.

Владелец: 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

Spec-Zone.ru

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