Spec-Zone.ru › GTK 3.22

GtkSymbolicColor

GtkSymbolicColor — Символьные цвета

Функции

GtkSymbolicColor * gtk_symbolic_color_new_literal ()
GtkSymbolicColor * gtk_symbolic_color_new_name ()
GtkSymbolicColor * gtk_symbolic_color_new_shade ()
GtkSymbolicColor * gtk_symbolic_color_new_alpha ()
GtkSymbolicColor * gtk_symbolic_color_new_mix ()
GtkSymbolicColor * gtk_symbolic_color_new_win32 ()
GtkSymbolicColor * gtk_symbolic_color_ref ()
void gtk_symbolic_color_unref ()
gboolean gtk_symbolic_color_resolve ()
char * gtk_symbolic_color_to_string ()

Типы и значения

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

коэффициент

коэффициент затемнения, применяемый к color

Возвращает

Новый созданный 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

коэффициент

коэффициент, применяемый к альфа-каналу color

Возвращает

Новый созданный 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

Параметры

цвет

a GtkSymbolicColor

Возвращает

тот же color

С версии: 3.0

gtk_symbolic_color_unref ()

void
gtk_symbolic_color_unref (GtkSymbolicColor *color);

gtk_symbolic_color_unref было устаревшим с версии 3.8 и не должно использоваться в новых кодах.

GtkSymbolicColor устарело.

Уменьшает счётчик ссылок на color, освобождая его память, если счётчик ссылок достигнет 0.

Параметры

color

a GtkSymbolicColor

С: 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

a GtkSymbolicColor

props

GtkStyleProperties для использования при разрешении именованных цветов или NULL.

[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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API