GtkStyleContext

gtk_style_context_add_provider ()

void
gtk_style_context_add_provider (GtkStyleContext *context,
                                GtkStyleProvider *provider,
                                guint priority);

Добавляет поставщик стилей к context для использования в построении стиля. Обратите внимание, что поставщик стилей, добавленный этой функцией, влияет только на стиль виджета, к которому принадлежит context. Если вы хотите повлиять на стиль всех виджетов, используйте gtk_style_context_add_provider_for_display().

Примечание: если приоритеты совпадают, GtkStyleProvider, добавленный этой функцией, имеет приоритет над другим, добавленным через gtk_style_context_add_provider_for_display().

gtk_style_context_add_provider_for_display ()

void
gtk_style_context_add_provider_for_display
                               (GdkDisplay *display,
                                GtkStyleProvider *provider,
                                guint priority);

Добавляет глобальный поставщик стилей к display, который будет использоваться в построении стиля для всех GtkStyleContext под display.

GTK использует это для предоставления информации о стиле из GtkSettings.

Примечание: если приоритеты совпадают, GtkStyleProvider, добавленный через gtk_style_context_add_provider(), имеет приоритет над другим, добавленным этой функцией.

gtk_style_context_get_display ()

GdkDisplay *
gtk_style_context_get_display (GtkStyleContext *context);

Возвращает GdkDisplay, к которому прикреплен context.

gtk_style_context_get_state ()

GtkStateFlags
gtk_style_context_get_state (GtkStyleContext *context);

Возвращает состояние, используемое для сопоставления стилей.

Этот метод следует использовать только для получения GtkStateFlags для передачи методам GtkStyleContext, таким как gtk_style_context_get_padding(). Если вам нужно получить текущее состояние GtkWidget, используйте gtk_widget_get_state_flags().

gtk_style_context_get_color ()

void
gtk_style_context_get_color (GtkStyleContext *context,
                             GdkRGBA *color);

Получает цвет переднего плана для заданного состояния.

gtk_style_context_get_border ()

void
gtk_style_context_get_border (GtkStyleContext *context,
                              GtkBorder *border);

Получает границу для заданного состояния как GtkBorder.

gtk_style_context_get_padding ()

void
gtk_style_context_get_padding (GtkStyleContext *context,
                               GtkBorder *padding);

Получает отступ для заданного состояния как GtkBorder.

gtk_style_context_get_margin ()

void
gtk_style_context_get_margin (GtkStyleContext *context,
                              GtkBorder *margin);

Получает отступ для заданного состояния как GtkBorder.

gtk_style_context_lookup_color ()

gboolean
gtk_style_context_lookup_color (GtkStyleContext *context,
                                const char *color_name,
                                GdkRGBA *color);

Ищет и разрешает имя цвета в карте цветов context.

gtk_style_context_remove_provider ()

void
gtk_style_context_remove_provider (GtkStyleContext *context,
                                   GtkStyleProvider *provider);

Удаляет provider из списка поставщиков стилей в context.

gtk_style_context_remove_provider_for_display ()

void
gtk_style_context_remove_provider_for_display
                               (GdkDisplay *display,
                                GtkStyleProvider *provider);

Удаляет provider из глобального списка поставщиков стилей в display.

gtk_style_context_restore ()

void
gtk_style_context_restore (GtkStyleContext *context);

Восстанавливает состояние context до предыдущей стадии. См. gtk_style_context_save().

gtk_style_context_save ()

void
gtk_style_context_save (GtkStyleContext *context);

Сохраняет состояние context, чтобы временные изменения, внесённые через gtk_style_context_add_class(), gtk_style_context_remove_class(), gtk_style_context_set_state() и т.п., можно было быстро откатить в один приём через gtk_style_context_restore().

Соответствующий вызов gtk_style_context_restore() должен быть выполнен до возвращения GTK в основной цикл.

gtk_style_context_add_class ()

void
gtk_style_context_add_class (GtkStyleContext *context,
                             const char *class_name);

Добавляет класс стиля к context, чтобы последующее использование контекста стиля использовало этот новый класс для форматирования.

В формате файлов CSS, GtkEntry с определением класса “search”, соотносился бы с:

В то время как любой виджет, определяющий класс “search”, соотносился бы с:

entry.search { ... }

gtk_style_context_remove_class ()

void
gtk_style_context_remove_class (GtkStyleContext *context,
                                const char *class_name);

Удаляет class_name из context.

gtk_style_context_has_class ()

gboolean
gtk_style_context_has_class (GtkStyleContext *context,
                             const char *class_name);

Возвращает TRUE, если context в данный момент определил заданное имя класса.

gtk_style_context_set_display ()

void
gtk_style_context_set_display (GtkStyleContext *context,
                               GdkDisplay *display);

Присоединяет context к указанному дисплею.

Дисплей используется для добавления информации о стиле из «глобальных» поставщиков стилей, таких как экземпляр GtkSettings дисплея.

Если вы используете GtkStyleContext, возвращённый gtk_widget_get_style_context(), вам не нужно вызывать это самим.

gtk_style_context_set_state ()

void
gtk_style_context_set_state (GtkStyleContext *context,
                             GtkStateFlags flags);

Устанавливает состояние для использования при сопоставлении стилей.

gtk_style_context_set_scale ()

void
gtk_style_context_set_scale (GtkStyleContext *context,
                             int scale);

Устанавливает масштаб для использования при получении ресурсов изображений для стиля.

gtk_style_context_get_scale ()

int
gtk_style_context_get_scale (GtkStyleContext *context);

Возвращает используемый масштаб для ресурсов.

gtk_style_context_to_string ()

char *
gtk_style_context_to_string (GtkStyleContext *context,
                             GtkStyleContextPrintFlags flags);

Преобразует контекст стиля в строковое представление.

Строковое представление всегда включает информацию об имени, состоянии, идентификаторе, видимости и классах стиля узла CSS, который поддерживает context. В зависимости от флагов, может быть включена дополнительная информация.

Эта функция предназначена для тестирования и отладки реализации CSS в GTK. Нет гарантий относительно формата возвращаемой строки, она может изменяться.

gtk_border_new ()

GtkBorder *
gtk_border_new (void);

Выделяет новую GtkBorder и инициализирует её элементы нулём.

gtk_border_copy ()

GtkBorder *
gtk_border_copy (const GtkBorder *border_);

Копирует GtkBorder.

gtk_border_free ()

void
gtk_border_free (GtkBorder *border_);

Освобождает GtkBorder.

gtk_render_arrow ()

void
gtk_render_arrow (GtkStyleContext *context,
                  cairo_t *cr,
                  double angle,
                  double x,
                  double y,
                  double size);

Отрисовывает стрелку, указывающую на angle .

Типичная отрисовка стрелки в 0, 1⁄2 π;, π; и 3⁄2 π:

gtk_render_background ()

void
gtk_render_background (GtkStyleContext *context,
                       cairo_t *cr,
                       double x,
                       double y,
                       double width,
                       double height);

Отрисовывает фон элемента.

Типичная отрисовка фона, демонстрирующая эффект background-image, border-width и border-radius.

gtk_render_check ()

void
gtk_render_check (GtkStyleContext *context,
                  cairo_t *cr,
                  double x,
                  double y,
                  double width,
                  double height);

Отрисовывает галочку (как в GtkCheckButton).

Состояние GTK_STATE_FLAG_CHECKED определяет, установлена ли галочка, а GTK_STATE_FLAG_INCONSISTENT — является ли она неопределённой.

Типичная отрисовка галочки:

gtk_render_expander ()

void
gtk_render_expander (GtkStyleContext *context,
                     cairo_t *cr,
                     double x,
                     double y,
                     double width,
                     double height);

Отрисовывает раскрывающийся элемент (как в GtkTreeView и GtkExpander) в области, заданной x , y , width , height . Состояние GTK_STATE_FLAG_CHECKED определяет, свернут или развернут элемент.

Типичная отрисовка раскрывающегося элемента:

gtk_render_focus ()

void
gtk_render_focus (GtkStyleContext *context,
                  cairo_t *cr,
                  double x,
                  double y,
                  double width,
                  double height);

Отрисовывает индикатор фокуса на прямоугольнике, заданном x , y , width , height .

Типичная отрисовка фокуса:

gtk_render_frame ()

void
gtk_render_frame (GtkStyleContext *context,
                  cairo_t *cr,
                  double x,
                  double y,
                  double width,
                  double height);

Отображает рамку вокруг прямоугольника, определяемого x, y, width, height.

Примеры рендеринга рамки, демонстрирующие влияние border-image, border-color, border-width, border-radius и соединений:

gtk_render_handle ()

void
gtk_render_handle (GtkStyleContext *context,
                   cairo_t *cr,
                   double x,
                   double y,
                   double width,
                   double height);

Отображает маркер (как в GtkPaned и в маркерах изменения размера GtkWindow), в прямоугольнике, определяемом x, y, width, height.

Маркеры, отображаемые для панелей и маркеров изменения размера:

gtk_render_layout ()

void
gtk_render_layout (GtkStyleContext *context,
                   cairo_t *cr,
                   double x,
                   double y,
                   PangoLayout *layout);

Отображает layout по координатам x, y

gtk_render_line ()

void
gtk_render_line (GtkStyleContext *context,
                 cairo_t *cr,
                 double x0,
                 double y0,
                 double x1,
                 double y1);

Отображает линию от (x0, y0) до (x1, y1).

gtk_render_option ()

void
gtk_render_option (GtkStyleContext *context,
                   cairo_t *cr,
                   double x,
                   double y,
                   double width,
                   double height);

Отображает отметку опции (как в радиокнопке), состояние GTK_STATE_FLAG_CHECKED определяет, включена ли опция, а GTK_STATE_FLAG_INCONSISTENT указывает, следует ли обозначить её как неопределённую.

Типичный рендеринг отметки опции:

gtk_render_activity ()

void
gtk_render_activity (GtkStyleContext *context,
                     cairo_t *cr,
                     double x,
                     double y,
                     double width,
                     double height);

Отображает индикатор активности (например, в GtkSpinner). Состояние GTK_STATE_FLAG_CHECKED определяет, происходит ли активность.

gtk_render_icon ()

void
gtk_render_icon (GtkStyleContext *context,
                 cairo_t *cr,
                 GdkTexture *texture,
                 double x,
                 double y);

Отображает значок в texture в указанных координатах x и y.

Эта функция отобразит значок в texture в точном соответствии с его размером, независимо от масштабирования, что может быть неподходящим при отрисовке на дисплеях с высокой плотностью пикселей.