Spec-Zone.ru › GTK 3.24

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.

Обычно нет необходимости работать напрямую с 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

коэффициент тонирования, применяемый к 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 — более непрозрачному.

[конструктор]

Параметры

color

другой GtkSymbolicColor

factor

коэффициент, применяемый к альфе 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.

[конструктор]

Параметры

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

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, но гарантируется, что парсер 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

Spec-Zone.ru

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