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 | a 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 | массив цветов. | [массив length=n_colors] |
n_colors | длина массива |
Возвращает
выделенная строка, кодирующая палитру
GtkColorSelectionChangePaletteFunc ()
void (*GtkColorSelectionChangePaletteFunc) (const GdkColor *colors,gint n_colors);
GtkColorSelectionChangePaletteFunc устарел начиная с версии 3.4 и не должен использоваться в новом коде.
Параметры
colors | Массив цветов. | [массив length=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 | Массив цветов. | [массив length=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 | пользовательские данные, установленные при подключении обработчика сигналов. |
Флаги: Первое выполнение
© 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/GtkColorSelection.html