GtkNumerableIcon
GtkNumerableIcon — Иконка с возможностью отображения номера
Функции
| GIcon * | gtk_numerable_icon_new () |
| GIcon * | gtk_numerable_icon_new_with_style_context () |
| GIcon * | gtk_numerable_icon_get_background_gicon () |
| void | gtk_numerable_icon_set_background_gicon () |
| const gchar * | gtk_numerable_icon_get_background_icon_name () |
| void | gtk_numerable_icon_set_background_icon_name () |
| gint | gtk_numerable_icon_get_count () |
| void | gtk_numerable_icon_set_count () |
| const gchar * | gtk_numerable_icon_get_label () |
| void | gtk_numerable_icon_set_label () |
| GtkStyleContext * | gtk_numerable_icon_get_style_context () |
| void | gtk_numerable_icon_set_style_context () |
Свойства
| GIcon * | background-icon | Чтение / Запись |
| char * | background-icon-name | Чтение / Запись |
| int | count | Чтение / Запись |
| char * | label | Чтение / Запись |
| GtkStyleContext * | style-context | Чтение / Запись |
Типы и значения
| struct | GtkNumerableIcon |
Иерархия объектов
GObject
╰── GEmblemedIcon
╰── GtkNumerableIcon
Реализованные интерфейсы
GtkNumerableIcon реализует GIcon.
Файлы
#include <gtk/gtk.h>
Описание
GtkNumerableIcon — подкласс GEmblemedIcon, который может отображать число или короткую строку в качестве эмблемы. Число может быть наложено поверх другой эмблемы, если необходимо.
Он поддерживает настройку, получая информацию о шрифте и цвете от предоставленного GtkStyleContext; см. gtk_numerable_icon_set_style_context().
Типичные иконки с числом:
Функции
gtk_numerable_icon_new ()
GIcon * gtk_numerable_icon_new (GIcon *base_icon);
gtk_numerable_icon_new было устаревшим с версии 3.14 и не должно использоваться в новых кодах.
Создаёт новый, нетематизированный GtkNumerableIcon.
Параметры
base_icon | a GIcon для наложения |
Возвращаемое значение
новый GIcon.
[перенос полный]
С: 3.0
gtk_numerable_icon_new_with_style_context ()
GIcon * gtk_numerable_icon_new_with_style_context (GIcon *base_icon,GtkStyleContext *context);
gtk_numerable_icon_new_with_style_context было устаревшим с версии 3.14 и не должно использоваться в новых кодах.
Создаёт новый GtkNumerableIcon, который будет тематизирован в соответствии с переданным GtkStyleContext. Это конструктор по умолчанию, который вызывает gtk_numerable_icon_set_style_context() внутри.
Параметры
base_icon | a GIcon для наложения | |
context |
Возвращаемое значение
новый GIcon.
[перенос полный]
С: 3.0
gtk_numerable_icon_get_background_gicon ()
GIcon *
gtk_numerable_icon_get_background_gicon
(GtkNumerableIcon *self); gtk_numerable_icon_get_background_gicon было устаревшим с версии 3.14 и не должно использоваться в новых кодах.
Возвращает GIcon, установленный в качестве базового изображения фона, или NULL, если такового нет. Звонящий функция не владеет ссылкой на возвращённый GIcon.
Параметры
self |
Возвращаемое значение
a GIcon, или NULL.
[nullable][перенос ничто]
С: 3.0
gtk_numerable_icon_set_background_gicon ()
void gtk_numerable_icon_set_background_gicon (GtkNumerableIcon *self,GIcon *icon);
gtk_numerable_icon_set_background_gicon было устаревшим с версии 3.14 и не должно использоваться в новых кодах.
Обновляет значок, чтобы использовать icon как базовое изображение фона. Если icon является NULL, self вернётся к использованию информации о стиле или стандартной тематизации для изображения фона.
Если этот метод вызывается и имя значка уже было установлено как фон для значка, icon будет использоваться, т.е. последний вызванный метод между gtk_numerable_icon_set_background_gicon() и gtk_numerable_icon_set_background_icon_name() имеет приоритет.
Параметры
self | ||
icon | a GIcon, или | [allow-none] |
С: 3.0
gtk_numerable_icon_get_background_icon_name ()
const gchar *
gtk_numerable_icon_get_background_icon_name
(GtkNumerableIcon *self); gtk_numerable_icon_get_background_icon_name было устаревшим с версии 3.14 и не должно использоваться в новых кодах.
Возвращает имя значка, используемого в качестве базового изображения фона, или NULL, если такового нет.
Параметры
self |
Возвращаемое значение
имя значка, или NULL.
[nullable]
С: 3.0
gtk_numerable_icon_set_background_icon_name ()
void gtk_numerable_icon_set_background_icon_name (GtkNumerableIcon *self,const gchar *icon_name);
gtk_numerable_icon_set_background_icon_name было устаревшим с версии 3.14 и не должно использоваться в новых кодах.
Обновляет значок, чтобы использовать значок с именем icon_name из текущей темы значков как базовое изображение фона. Если icon_name является NULL, self вернётся к использованию информации о стиле или стандартной тематизации для изображения фона.
Если этот метод вызывается и GIcon уже был установлен как фон для значка, icon_name будет использоваться, т.е. последний вызванный метод между gtk_numerable_icon_set_background_icon_name() и gtk_numerable_icon_set_background_gicon() имеет приоритет.
Параметры
self | ||
icon_name | имя значка, или | [allow-none] |
С: 3.0
gtk_numerable_icon_get_count ()
gint
gtk_numerable_icon_get_count (GtkNumerableIcon *self); gtk_numerable_icon_get_count было устаревшим с версии 3.14 и не должно использоваться в новых кодах.
Возвращает значение, отображаемое в данный момент self.
Параметры
self |
Возвращаемое значение
текущее отображаемое значение
С: 3.0
gtk_numerable_icon_set_count ()
void gtk_numerable_icon_set_count (GtkNumerableIcon *self,gint count);
gtk_numerable_icon_set_count устарело с версии 3.14 и не должно использоваться в новом коде.
Устанавливает текущее отображаемое значение self на count.
Числовое значение всегда ограничено диапазоном от -99 до 99. Установка значения 0 удаляет эмблему. Если этот метод вызывается, и для значка уже задана метка, она будет автоматически сброшена до NULL перед отрисовкой числа, т.е. последний вызванный метод между gtk_numerable_icon_set_count() и gtk_numerable_icon_set_label() всегда имеет приоритет.
Параметры
self | объект GtkNumerableIcon | |
count | число от -99 до 99 |
С: 3.0
gtk_numerable_icon_get_label ()
const gchar *
gtk_numerable_icon_get_label (GtkNumerableIcon *self); gtk_numerable_icon_get_label устарело с версии 3.14 и не должно использоваться в новом коде.
Возвращает текущую отображаемую метку значка или NULL.
Параметры
self | объект GtkNumerableIcon |
Возвращаемое значение
текущая отображаемая метка.
[nullable]
С: 3.0
gtk_numerable_icon_set_label ()
void gtk_numerable_icon_set_label (GtkNumerableIcon *self,const gchar *label);
gtk_numerable_icon_set_label устарело с версии 3.14 и не должно использоваться в новом коде.
Устанавливает текущее отображаемое значение self на строку в label . Установка пустой метки удаляет эмблему.
Обратите внимание, что это предназначено для отображения коротких меток, таких как римские цифры или отдельные буквы. Для римских цифр следует использовать символы Юникода U+2160 - U+217F. Строки длиннее двух символов, вероятно, не будут отображаться корректно.
Если этот метод вызывается, и для значка уже задано число, оно будет автоматически сброшено до нуля перед отрисовкой метки, т.е. последний вызванный метод между gtk_numerable_icon_set_label() и gtk_numerable_icon_set_count() всегда имеет приоритет.
Параметры
self | объект GtkNumerableIcon | |
label | короткая метка, или | [allow-none] |
С: 3.0
gtk_numerable_icon_get_style_context ()
GtkStyleContext *
gtk_numerable_icon_get_style_context (GtkNumerableIcon *self); gtk_numerable_icon_get_style_context устарело с версии 3.14 и не должно использоваться в новом коде.
Возвращает GtkStyleContext, используемый значком для оформления, или NULL если такового нет.
Параметры
self | объект GtkNumerableIcon |
Возвращаемое значение
объект GtkStyleContext или NULL. Этот объект внутренний для GTK+ и не должен быть удалён. Используйте g_object_ref() если хотите сохранить его.
[nullable][transfer none]
С: 3.0
gtk_numerable_icon_set_style_context ()
void gtk_numerable_icon_set_style_context (GtkNumerableIcon *self,GtkStyleContext *style);
gtk_numerable_icon_set_style_context устарело с версии 3.14 и не должно использоваться в новом коде.
Обновляет значок, чтобы получить информацию о теме из заданного GtkStyleContext.
Параметры
self | объект GtkNumerableIcon | |
style | объект GtkStyleContext |
С: 3.0
Типы и значения
struct GtkNumerableIcon
struct GtkNumerableIcon;
Подробности свойств
Свойство “background-icon”
“background-icon” GIcon *
Значок для фона эмблемы числа.
Владелец: GtkNumerableIcon
Флаги: Чтение / Запись
Свойство “background-icon-name”
“background-icon-name” char *
Имя значка для фона эмблемы числа.
Владелец: GtkNumerableIcon
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “count”
“count” int
Количество, отображаемое на эмблеме.
Владелец: GtkNumerableIcon
Флаги: Чтение / Запись
Допустимые значения: [-99,99]
Значение по умолчанию: 0
Свойство “label”
“label” char *
Метка, отображаемая над значком.
Владелец: GtkNumerableIcon
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “style-context”
“style-context” GtkStyleContext *
Контекст стиля для оформления внешнего вида значка.
Владелец: GtkNumerableIcon
Флаги: Чтение / Запись
© 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/GtkNumerableIcon.html