GtkSymbolicColor
GtkSymbolicColor — Символьные цвета
Функции
Типы и значения
Файлы заголовков
#include <gtk/gtk.h>
Описание
GtkSymbolicColor — это упакованный тип, представляющий собой символьный цвет. Он является результатом разбора выражения цвета. Для получения цвета, представленного GtkSymbolicColor, его необходимо разрешить с помощью gtk_symbolic_color_resolve(), который заменяет все символьные ссылки на цвета, на которые они ссылаются (в данном контексте), и вычисляет смешивание, оттенки и другие выражения, что приводит к значению GdkRGBA.
Обычно нет необходимости работать напрямую с GtkSymbolicColor, поскольку они в основном используются в качестве вспомогательного инструмента GtkStyleContext и GtkCssProvider.
GtkSymbolicColor устарел. Символьные цвета считаются деталью реализации GTK+.
Функции
gtk_symbolic_color_new_literal ()
GtkSymbolicColor *
gtk_symbolic_color_new_literal (const GdkRGBA *color); gtk_symbolic_color_new_literal было устарело с версии 3.8 и не должно использоваться в новом коде.
GtkSymbolicColor устарело.
Создаёт символический цвет, указывающий на буквальный цвет.
Параметры
color | a GdkRGBA |
Возвращает
новый созданный GtkSymbolicColor
С: 3.0
gtk_symbolic_color_new_name ()
GtkSymbolicColor *
gtk_symbolic_color_new_name (const gchar *name); gtk_symbolic_color_new_name было устарело с версии 3.8 и не должно использоваться в новом коде.
GtkSymbolicColor устарело.
Создаёт символический цвет, указывающий на неразрешённый цвет с именем. См. gtk_style_context_lookup_color() и gtk_style_properties_lookup_color().
Параметры
name | имя цвета |
Возвращает
новый созданный GtkSymbolicColor
С: 3.0
gtk_symbolic_color_new_shade ()
GtkSymbolicColor * gtk_symbolic_color_new_shade (GtkSymbolicColor *color,gdouble factor);
gtk_symbolic_color_new_shade было устарело с версии 3.8 и не должно использоваться в новом коде.
GtkSymbolicColor устарело.
Создаёт символический цвет, определённый как оттенок другого цвета. Коэффициент > 1.0 соответствует более светлому цвету, а < 1.0 — более тёмному.
[конструктор]
Параметры
color | другой GtkSymbolicColor | |
factor | коэффициент тонирования, применяемый к |
Возвращает
Новый созданный GtkSymbolicColor
С: 3.0
gtk_symbolic_color_new_alpha ()
GtkSymbolicColor * gtk_symbolic_color_new_alpha (GtkSymbolicColor *color,gdouble factor);
gtk_symbolic_color_new_alpha было устарело с версии 3.8 и не должно использоваться в новом коде.
GtkSymbolicColor устарело.
Создаёт символический цвет, изменяя относительное значение альфы color . Значение коэффициента < 1.0 соответствует более прозрачному цвету, а > 1.0 — более непрозрачному.
[конструктор]
Параметры
color | другой GtkSymbolicColor | |
factor | коэффициент, применяемый к альфе |
Возвращает
Новый созданный GtkSymbolicColor
С: 3.0
gtk_symbolic_color_new_mix ()
GtkSymbolicColor * gtk_symbolic_color_new_mix (GtkSymbolicColor *color1,GtkSymbolicColor *color2,gdouble factor);
gtk_symbolic_color_new_mix было устарело с версии 3.8 и не должно использоваться в новом коде.
GtkSymbolicColor устарело.
Создаёт символический цвет, определённый как смесь двух других цветов. Значение коэффициента смешивания 0 соответствует color1 , а 1 — color2 .
[конструктор]
Параметры
color1 | цвет для смешивания | |
color2 | ещё один цвет для смешивания | |
factor | коэффициент смешивания |
Возвращает
Новый созданный GtkSymbolicColor
С: 3.0
gtk_symbolic_color_new_win32 ()
GtkSymbolicColor * gtk_symbolic_color_new_win32 (const gchar *theme_class,gint id);
gtk_symbolic_color_new_win32 было устарело с версии 3.8 и не должно использоваться в новом коде.
GtkSymbolicColor устарело.
Создаёт символический цвет на основе текущей темы win32.
Обратите внимание, что, хотя этот вызов доступен на всех платформах, фактическое возвращаемое значение не надёжно на платформах, отличных от win32.
[конструктор]
Параметры
theme_class | Класс темы для извлечения цвета | |
id | Идентификатор цвета |
Возвращает
Новый созданный GtkSymbolicColor
С: 3.4
gtk_symbolic_color_ref ()
GtkSymbolicColor *
gtk_symbolic_color_ref (GtkSymbolicColor *color); gtk_symbolic_color_ref было устарело с версии 3.8 и не должно использоваться в новом коде.
GtkSymbolicColor устарело.
Увеличивает счётчик ссылок color
Параметры
color |
Возвращает
тот же color
С: 3.0
gtk_symbolic_color_unref ()
void
gtk_symbolic_color_unref (GtkSymbolicColor *color); gtk_symbolic_color_unref было устарело с версии 3.8 и не должно использоваться в новом коде.
GtkSymbolicColor устарело.
Уменьшает счётчик ссылок color , освобождая память, если счётчик ссылок достигнет 0.
Параметры
color |
С: 3.0
gtk_symbolic_color_resolve ()
gboolean gtk_symbolic_color_resolve (GtkSymbolicColor *color,GtkStyleProperties *props,GdkRGBA *resolved_color);
gtk_symbolic_color_resolve устарело с версии 3.8 и не должно использоваться в новых кодах.
GtkSymbolicColor устарело.
Если color разрешим, resolved_color будет заполнен разрешённым цветом, и будет возвращено TRUE. В целом, если color не может быть разрешён, это связано с тем, что он определён на основе имени цвета, которого нет в props.
Когда props равен NULL, разрешение именованных цветов не удастся, поэтому, если ваш color ссылается на такой цвет, эта функция вернёт FALSE.
Параметры
color | ||
props | GtkStyleProperties для использования при разрешении именованных цветов, или | [allow-none] |
resolved_color | место возврата разрешённого цвета. | [out] |
Возвращаемое значение
TRUE, если цвет был разрешён
С: 3.0
gtk_symbolic_color_to_string ()
char *
gtk_symbolic_color_to_string (GtkSymbolicColor *color); gtk_symbolic_color_to_string устарело с версии 3.8 и не должно использоваться в новых кодах.
GtkSymbolicColor устарело.
Преобразует заданный color в строковое представление. Это полезно как для отладки, так и для сериализации строк. Формат строки может меняться в разных версиях GTK, но гарантируется, что парсер CSS GTK сможет прочитать строку и создать из неё тот же символьный цвет.
Параметры
color | цвет для преобразования в строку |
Возвращаемое значение
новая строка, представляющая color
Типы и значения
GtkSymbolicColor
typedef struct _GtkSymbolicColor GtkSymbolicColor;
© 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/gtk3-GtkSymbolicColor.html