GtkВыборЦвета
GtkColorSelection — Устаревшее виджет для выбора цвета
Функции
Свойства
| guint | current-alpha | Чтение / Запись |
| GdkColor * | current-color | Чтение / Запись |
| GdkRGBA * | current-rgba | Чтение / Запись |
| gboolean | has-opacity-control | Чтение / Запись |
| gboolean | has-palette | Чтение / Запись |
Сигналы
| void | color-changed | Run First |
Типы и значения
| struct | GtkColorSelection |
| struct | GtkColorSelectionClass |
Иерархия объектов
GObject ╰── GInitiallyUnowned ╰── GtkWidget ╰── GtkContainer ╰── GtkBox ╰── GtkColorSelection
Реализованные интерфейсы
GtkColorSelection реализует интерфейсы AtkImplementorIface, GtkBuildable и GtkOrientable.
Включаемые файлы
#include <gtk/gtk.h>
Описание
Виджет GtkColorSelection используется для выбора цвета. Он состоит из цветового круга и нескольких ползунков и полей ввода для параметров цвета, таких как оттенок, насыщенность, значение, красный, зеленый, синий и непрозрачность. Он используется в стандартном диалоговом окне выбора цвета GtkColorSelectionDialog.
Функции
gtk_color_selection_new ()
GtkWidget *
gtk_color_selection_new (void); gtk_color_selection_new устарело и не должно использоваться в новом коде.
Создаёт новый GtkColorSelection.
Возвращает
новый GtkColorSelection
gtk_color_selection_set_has_opacity_control ()
void gtk_color_selection_set_has_opacity_control (GtkColorSelection *colorsel,gboolean has_opacity);
gtk_color_selection_set_has_opacity_control устарело и не должно использоваться в новом коде.
Устанавливает colorsel для использования или отключения непрозрачности.
gtk_color_selection_get_has_opacity_control ()
gboolean
gtk_color_selection_get_has_opacity_control
(GtkColorSelection *colorsel); gtk_color_selection_get_has_opacity_control устарело и не должно использоваться в новом коде.
Определяет, имеет ли colorsel управление непрозрачностью.
Параметры
colorsel |
gtk_color_selection_set_has_palette ()
void gtk_color_selection_set_has_palette (GtkColorSelection *colorsel,gboolean has_palette);
gtk_color_selection_set_has_palette устарело и не должно использоваться в новом коде.
Отображает и скрывает палитру в зависимости от значения has_palette.
gtk_color_selection_get_has_palette ()
gboolean
gtk_color_selection_get_has_palette (GtkColorSelection *colorsel); gtk_color_selection_get_has_palette устарело и не должно использоваться в новом коде.
Определяет, имеет ли селектор цвета палитру.
Параметры
colorsel |
gtk_color_selection_get_current_alpha ()
guint16
gtk_color_selection_get_current_alpha (GtkColorSelection *colorsel); gtk_color_selection_get_current_alpha устарело и не должно использоваться в новом коде.
Возвращает текущее значение альфа-канала.
Параметры
colorsel |
Возвращает
целое число от 0 до 65535
gtk_color_selection_set_current_alpha ()
void gtk_color_selection_set_current_alpha (GtkColorSelection *colorsel,guint16 alpha);
gtk_color_selection_set_current_alpha устарело и не должно использоваться в новом коде.
Устанавливает текущую непрозрачность на alpha.
При первом вызове также установит исходную непрозрачность на alpha.
Параметры
colorsel | ||
alpha | целое число от 0 до 65535 |
gtk_color_selection_get_current_color ()
void gtk_color_selection_get_current_color (GtkColorSelection *colorsel,GdkColor *color);
gtk_color_selection_get_current_color устарело с версии 3.4 и не должно использоваться в новом коде.
Используйте gtk_color_selection_get_current_rgba() вместо этого.
Устанавливает color в качестве текущего цвета в виджете GtkColorSelection.
Параметры
colorsel | ||
color | GdkColor для заполнения текущим цветом. | [out] |
gtk_color_selection_set_current_color ()
void gtk_color_selection_set_current_color (GtkColorSelection *colorsel,const GdkColor *color);
gtk_color_selection_set_current_color устарело с версии 3.4 и не должно использоваться в новом коде.
Используйте gtk_color_selection_set_current_rgba() вместо этого.
Устанавливает текущий цвет на color.
При первом вызове также установит исходный цвет на color.
Параметры
colorsel | ||
color | a GdkColor для установки текущего цвета |
gtk_color_selection_get_previous_alpha ()
guint16
gtk_color_selection_get_previous_alpha
(GtkColorSelection *colorsel); gtk_color_selection_get_previous_alpha устарело и не должно использоваться в новом коде.
Возвращает предыдущее значение альфа-канала.
Параметры
colorsel |
Возвращает
целое число от 0 до 65535
gtk_color_selection_set_previous_alpha ()
void gtk_color_selection_set_previous_alpha (GtkColorSelection *colorsel,guint16 alpha);
gtk_color_selection_set_previous_alpha устарело и не должно использоваться в новом коде.
Устанавливает “предыдущую” непрозрачность на alpha.
Эту функцию следует использовать с осторожностью, так как изменение альфа-канала может показаться запутанным.
Параметры
colorsel | ||
alpha | целое число от 0 до 65535 |
gtk_color_selection_get_previous_color ()
void gtk_color_selection_get_previous_color (GtkColorSelection *colorsel,GdkColor *color);
gtk_color_selection_get_previous_color устарел начиная с версии 3.4 и не должен использоваться в новом коде.
Используйте gtk_color_selection_get_previous_rgba() вместо этого.
Заполняет color исходным значением цвета.
Параметры
colorsel | ||
color | a GdkColor для заполнения исходным значением цвета. | [out] |
gtk_color_selection_set_previous_color ()
void gtk_color_selection_set_previous_color (GtkColorSelection *colorsel,const GdkColor *color);
gtk_color_selection_set_previous_color устарел начиная с версии 3.4 и не должен использоваться в новом коде.
Используйте gtk_color_selection_set_previous_rgba() вместо этого.
Устанавливает «предыдущий» цвет на color .
Эта функция должна вызываться с осторожностью, так как изменение этого цвета может показаться запутанным. Вызов gtk_color_selection_set_current_color() также установит этот цвет при первом вызове.
Параметры
colorsel | ||
color | a GdkColor для установки предыдущего цвета |
gtk_color_selection_get_current_rgba ()
void gtk_color_selection_get_current_rgba (GtkColorSelection *colorsel,GdkRGBA *rgba);
gtk_color_selection_get_current_rgba устарел и не должен использоваться в новом коде.
Устанавливает rgba в качестве текущего цвета в виджете GtkColorSelection.
Параметры
colorsel | ||
rgba | a GdkRGBA для заполнения текущим цветом. | [out] |
С: 3.0
gtk_color_selection_set-current-rgba ()
void gtk_color_selection_set_current_rgba (GtkColorSelection *colorsel,const GdkRGBA *rgba);
gtk_color_selection_set_current_rgba устарел и не должен использоваться в новом коде.
Устанавливает текущий цвет на rgba.
При первом вызове он также установит исходный цвет на rgba.
Параметры
colorsel | ||
rgba | A GdkRGBA для установки текущего цвета |
С: 3.0
gtk_color_selection_get_previous_rgba ()
void gtk_color_selection_get_previous_rgba (GtkColorSelection *colorsel,GdkRGBA *rgba);
gtk_color_selection_get_previous_rgba устарел и не должен использоваться в новом коде.
Заполняет rgba исходным значением цвета.
Параметры
colorsel | ||
rgba | a GdkRGBA для заполнения исходным значением цвета. | [out] |
С: 3.0
gtk_color_selection_set_previous_rgba ()
void gtk_color_selection_set_previous_rgba (GtkColorSelection *colorsel,const GdkRGBA *rgba);
gtk_color_selection_set_previous_rgba устарел и не должен использоваться в новом коде.
Устанавливает «предыдущий» цвет на rgba.
Эта функция должна вызываться с осторожностью, так как изменение этого цвета может показаться запутанным. Вызов gtk_color_selection_set_current_rgba() также установит этот цвет при первом вызове.
Параметры
colorsel | ||
rgba | a GdkRGBA для установки предыдущего цвета |
С: 3.0
gtk_color_selection_is_adjusting ()
gboolean
gtk_color_selection_is_adjusting (GtkColorSelection *colorsel); gtk_color_selection_is_adjusting устарел и не должен использоваться в новом коде.
Получает текущее состояние colorsel.
Параметры
colorsel |
gtk_color_selection_palette_from_string ()
gboolean gtk_color_selection_palette_from_string (const gchar *str,GdkColor **colors,gint *n_colors);
gtk_color_selection_palette_from_string устарел и не должен использоваться в новом коде.
Парсит строку палитры; строка представляет собой список имён цветов, разделённых двоеточием, читаемых с помощью gdk_color_parse().
Параметры
str | строка, кодирующая цветовую палитру | |
colors | место для возвращаемого массива GdkColor. | [out][array length=n_colors] |
n_colors | место для возвращаемой длины массива |
Возвращает
TRUE если палитра была успешно проанализирована
gtk_color_selection_palette_to_string ()
gchar * gtk_color_selection_palette_to_string (const GdkColor *colors,gint n_colors);
gtk_color_selection_palette_to_string устарел и не должен использоваться в новом коде.
Кодирует палитру в строку, что полезно для сохранения.
Параметры
colors | массив цветов. | [массив длина=n_colors] |
n_colors | длина массива |
Возвращает
выделенная строка, кодирующая палитру
GtkColorSelectionChangePaletteFunc ()
void (*GtkColorSelectionChangePaletteFunc) (const GdkColor *colors,gint n_colors);
GtkColorSelectionChangePaletteFunc устарел начиная с версии 3.4 и не должен использоваться в новом коде.
Параметры
colors | Массив цветов. | [массив длина=n_colors] |
n_colors | Количество цветов в массиве |
gtk_color_selection_set_change_palette_with_screen_hook ()
GtkColorSelectionChangePaletteWithScreenFunc
gtk_color_selection_set_change_palette_with_screen_hook
(GtkColorSelectionChangePaletteWithScreenFunc func); gtk_color_selection_set_change_palette_with_screen_hook устарел и не должен использоваться в новом коде.
Устанавливает глобальную функцию, которая вызывается всякий раз, когда пользователь пытается изменить палитру в окне выбора цвета.
Эта функция должна сохранять содержимое новой палитры и обновлять свойство “gtk-color-palette” GtkSettings, чтобы все виджеты GtkColorSelection были изменены.
[пропуск]
Параметры
func | функция, которая вызывается, когда необходимо сохранить пользовательскую палитру |
Возвращает
предыдущий обработчик изменения палитры (который был заменен)
С: 2.2
GtkColorSelectionChangePaletteWithScreenFunc ()
void (*GtkColorSelectionChangePaletteWithScreenFunc) (GdkScreen *screen,const GdkColor *colors,gint n_colors);
GtkColorSelectionChangePaletteWithScreenFunc устарел начиная с версии 3.4 и не должен использоваться в новом коде.
Параметры
colors | Массив цветов. | [массив длина=n_colors] |
n_colors | Количество цветов в массиве |
С: 2.2
Типы и значения
struct GtkColorSelection
struct GtkColorSelection;
struct GtkColorSelectionClass
struct GtkColorSelectionClass {
GtkBoxClass parent_class;
void (*color_changed) (GtkColorSelection *color_selection);
};
Члены
|
Подробное описание свойств
Свойство “current-alpha”
“current-alpha” guint
Текущее значение непрозрачности (0 полностью прозрачный, 65535 полностью непрозрачный).
Флаги: Чтение / Запись
Допустимые значения: <= 65535
Значение по умолчанию: 65535
Свойство “current-color”
“current-color” GdkColor *
Текущий цвет GdkColor.
GtkColorSelection:current-color устарел начиная с версии 3.4 и не должен использоваться в новом коде.
Используйте “current-rgba” вместо этого.
Флаги: Чтение / Запись
Свойство “has-opacity-control”
“has-opacity-control” gboolean
Указывает, разрешено ли изменение непрозрачности в селекторе цвета.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Свойство “has-palette”
“has-palette” gboolean
Использовать ли палитру.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Подробное описание сигналов
Сигнал “color-changed”
void user_function (GtkColorSelection *colorselection, gpointer user_data)
Этот сигнал испускается при изменении цвета в GtkColorSelection в соответствии с политикой обновления.
Параметры
colorselection | объект, получивший сигнал. | |
user_data | данные пользователя, установленные при подключении обработчика сигнала. |
Флаги: Run First
© 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/GtkColorSelection.html