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.24/gtk3-GtkSymbolicColor.html