GtkSymbolicColor
GtkSymbolicColor — Символьные цвета
Функции
Типы и значения
Файлы
#include <gtk/gtk.h>
Описание
GtkSymbolicColor — это упакованный тип, представляющий символьный цвет. Он является результатом разбора выражения цвета. Для получения цвета, представленного GtkSymbolicColor, его необходимо разрешить с помощью gtk_symbolic_color_resolve(), который заменяет все ссылки на символьные цвета на цвета, к которым они относятся (в данном контексте), и вычисляет смешивания, оттенки и другие выражения, что приводит к значению GdkRGBA.
Обычно нет необходимости непосредственно работать с GtkSymbolicColors, так как они в основном используются за кулисами 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 устарело.
Создаёт символьный цвет, указывающий на буквальный цвет.
Параметры
цвет | 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().
Параметры
имя | имя цвета |
Возвращает
новый созданный 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 — более тёмному.
[конструктор]
Параметры
цвет | другой GtkSymbolicColor | |
коэффициент | коэффициент затемнения, применяемый к |
Возвращает
Новый созданный 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 — более непрозрачному.
[конструктор]
Параметры
цвет | другой GtkSymbolicColor | |
коэффициент | коэффициент, применяемый к альфа-каналу |
Возвращает
Новый созданный 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.
[конструктор]
Параметры
цвет1 | смешиваемый цвет | |
цвет2 | ещё один смешиваемый цвет | |
коэффициент | коэффициент смешивания |
Возвращает
Новый созданный 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.
[конструктор]
Параметры
класс_темы | Класс темы, из которого нужно получить цвет | |
идентификатор | Идентификатор цвета |
Возвращает
Новый созданный GtkSymbolicColor
С версии: 3.4
gtk_symbolic_color_ref ()
GtkSymbolicColor *
gtk_symbolic_color_ref (GtkSymbolicColor *color); gtk_symbolic_color_ref было устарело с версии 3.8 и не должно использоваться в новом коде.
GtkSymbolicColor устарело.
Увеличивает счётчик ссылок на 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, но гарантируется, что GTK парсер CSS сможет прочитать строку и создать из неё тот же символический цвет.
Параметры
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.22/gtk3-GtkSymbolicColor.html