GtkStyleProperties

GtkStyleProperties — Хранилище информации о свойствах стиля

Функции

void	gtk_style_properties_clear ()
void	gtk_style_properties_get ()
gboolean	gtk_style_properties_get_property ()
void	gtk_style_properties_get_valist ()
GtkSymbolicColor *	gtk_style_properties_lookup_color ()
gboolean	gtk_style_properties_lookup_property ()
void	gtk_style_properties_map_color ()
void	gtk_style_properties_merge ()
GtkStyleProperties *	gtk_style_properties_new ()
gboolean	(*GtkStylePropertyParser) ()
void	gtk_style_properties_register_property ()
void	gtk_style_properties_set ()
void	gtk_style_properties_set_property ()
void	gtk_style_properties_set_valist ()
void	gtk_style_properties_unset_property ()

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

struct

GtkStyleProperties

Файлы заголовков

#include <gtk/gtk.h>

Описание

GtkStyleProperties предоставляет хранилище информации о стиле, используемой GtkStyleContext и другими реализациями GtkStyleProvider.

Перед тем, как свойства стиля могут быть сохранены в GtkStyleProperties, они должны быть зарегистрированы с помощью gtk_style_properties_register_property().

Если вы не пишете реализацию GtkStyleProvider, вам, скорее всего, не придётся использовать этот API напрямую, так как gtk_style_context_get() и его варианты являются предпочтительным способом доступа к информации о стилизации из реализаций виджетов, а реализации механизмов оформления должны использовать API, предоставляемые GtkThemingEngine вместо этого.

GtkStyleProperties устарел в GTK 3.16. Механизм CSS больше не использует его, и все пользователи этого объекта устарели.

Функции

gtk_style_properties_clear ()

void
gtk_style_properties_clear (GtkStyleProperties *props);

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

GtkStyleProperties устарели.

Очищает всю информацию о стиле из props.

Параметры

props

a GtkStyleProperties

gtk_style_properties_get ()

void
gtk_style_properties_get (GtkStyleProperties *props,
                          GtkStateFlags state,
                          ...);

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

GtkStyleProperties устарели.

Извлекает несколько значений свойств стиля из props для заданного состояния.

Параметры

props	a GtkStyleProperties
state	состояние для извлечения значений свойств
...	пары имя свойства / возвращаемое значение, за которыми следует `NULL`

С: 3.0

gtk_style_properties_get_property ()

gboolean
gtk_style_properties_get_property (GtkStyleProperties *props,
                                   const gchar *property,
                                   GtkStateFlags state,
                                   GValue *value);

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

GtkStyleProperties устарели.

Получает свойство стиля из props для данного состояния. По завершении работы с value, необходимо вызвать g_value_unset() для освобождения выделенной памяти.

Параметры

props	a GtkStyleProperties
property	имя свойства стиля
state	состояние для получения значения свойства
value	место для возврата значения свойства стиля.	[out][transfer full]

Возвращаемое значение

TRUE если свойство существует в props, FALSE в противном случае

С: 3.0

gtk_style_properties_get_valist ()

void
gtk_style_properties_get_valist (GtkStyleProperties *props,
                                 GtkStateFlags state,
                                 va_list args);

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

GtkStyleProperties устарели.

Извлекает несколько значений свойств стиля из props для заданного состояния.

Параметры

props	a GtkStyleProperties
state	состояние для извлечения значений свойств
args	va_list пар имя свойства/место возврата, за которыми следует `NULL`

С: 3.0

gtk_style_properties_lookup_color ()

GtkSymbolicColor *
gtk_style_properties_lookup_color (GtkStyleProperties *props,
                                   const gchar *name);

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

GtkSymbolicColor устарело.

Возвращает символический цвет, который сопоставлен с name.

Параметры

props	a GtkStyleProperties
name	имя цвета для поиска

Возвращаемое значение

Сопоставленный цвет.

[transfer none]

С: 3.0

gtk_style_properties_lookup_property ()

gboolean
gtk_style_properties_lookup_property (const gchar *property_name,
                                      GtkStylePropertyParser *parse_func,
                                      GParamSpec **pspec);

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

Этот код мог искать только пользовательские свойства, которые также устарели.

Возвращает TRUE если свойство зарегистрировано, если pspec или parse_func не NULL, функция GParamSpec и разбора соответственно возвращаются.

[skip]

Параметры

property_name	имя свойства для поиска
parse_func	место для возврата функции разбора.	[out]
pspec	место для возврата GParamSpec.	[out][transfer none]

Возвращаемое значение

TRUE если свойство зарегистрировано, FALSE в противном случае

С: 3.0

gtk_style_properties_map_color ()

void
gtk_style_properties_map_color (GtkStyleProperties *props,
                                const gchar *name,
                                GtkSymbolicColor *color);

gtk_style_properties_map_color устарел начиная с версии 3.8 и не должен использоваться в новом коде.

GtkSymbolicColor устарел.

Сопоставляет color, чтобы его можно было использовать с name. См. gtk_style_properties_lookup_color()

Параметры

props	структура GtkStyleProperties
name	имя цвета
color	GtkSymbolicColor для сопоставления с `name`

С момента: 3.0

gtk_style_properties_merge ()

void
gtk_style_properties_merge (GtkStyleProperties *props,
                            const GtkStyleProperties *props_to_merge,
                            gboolean replace);

gtk_style_properties_merge устарел начиная с версии 3.16 и не должен использоваться в новом коде.

GtkStyleProperties устарели.

Объединяет в props всю информацию о стиле, содержащуюся в props_to_merge. Если replace равно TRUE, значения будут перезаписаны, если FALSE, будут сохранены старые значения.

Параметры

props	структура GtkStyleProperties
props_to_merge	вторая структура GtkStyleProperties
replace	заменять ли значения

С момента: 3.0

gtk_style_properties_new ()

GtkStyleProperties *
gtk_style_properties_new (void);

gtk_style_properties_new устарел начиная с версии 3.16 и не должен использоваться в новом коде.

GtkStyleProperties устарели.

Возвращает вновь созданную структуру GtkStyleProperties

Возвращает

новую структуру GtkStyleProperties

GtkStylePropertyParser ()

gboolean
(*GtkStylePropertyParser) (const gchar *string,
                           GValue *value,
                           GError **error);

gtk_style_properties_register_property ()

void
gtk_style_properties_register_property
                               (GtkStylePropertyParser parse_func,
                                GParamSpec *pspec);

gtk_style_properties_register_property устарел начиная с версии 3.8 и не должен использоваться в новом коде.

Код должен использовать свойства по умолчанию, предоставляемые CSS.

Регистрирует свойство, чтобы его можно было использовать в формате файла CSS. Эта функция является низкоуровневым эквивалентом gtk_theming_engine_register_property(). Если вы реализуете движок оформления, следует использовать эту функцию.

[skip]

Параметры

parse_func	функция разбора для использования, или `NULL`.	[nullable]
pspec	параметр GParamSpec для нового свойства

С момента: 3.0

gtk_style_properties_set ()

void
gtk_style_properties_set (GtkStyleProperties *props,
                          GtkStateFlags state,
                          ...);

gtk_style_properties_set устарел начиная с версии 3.16 и не должен использоваться в новом коде.

GtkStyleProperties устарели.

Устанавливает несколько свойств стиля для props.

Параметры

props	структура GtkStyleProperties
state	состояние для установки значений
...	названия/значения свойств, за которыми следует `NULL`

С момента: 3.0

gtk_style_properties_set_property ()

void
gtk_style_properties_set_property (GtkStyleProperties *props,
                                   const gchar *property,
                                   GtkStateFlags state,
                                   const GValue *value);

gtk_style_properties_set_property устарел начиная с версии 3.16 и не должен использоваться в новом коде.

GtkStyleProperties устарели.

Устанавливает свойство стиля для props.

Параметры

props	структура GtkStyleProperties
property	свойство стиля для установки
state	состояние для установки значения
value	новое значение свойства

С момента: 3.0

gtk_style_properties_set_valist ()

void
gtk_style_properties_set_valist (GtkStyleProperties *props,
                                 GtkStateFlags state,
                                 va_list args);

gtk_style_properties_set_valist устарел начиная с версии 3.16 и не должен использоваться в новом коде.

GtkStyleProperties устарели.

Устанавливает несколько свойств стиля для props.

Параметры

props	структура GtkStyleProperties
state	состояние для установки значений
args	список аргументов вариативных свойств имя/значение, за которым следует `NULL`

С момента: 3.0

gtk_style_properties_unset_property ()

void
gtk_style_properties_unset_property (GtkStyleProperties *props,
                                     const gchar *property,
                                     GtkStateFlags state);

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

GtkStyleProperties устарели.

Снимает стиль свойства в props.

Параметры

props	a GtkStyleProperties
property	свойство для снятия
state	состояние для снятия

С: 3.0

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

struct GtkStyleProperties

struct GtkStyleProperties {
};

© 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-GtkStyleProperties.html