Spec-Zone.ru › GTK 3.20

GtkNumerableIcon

GtkNumerableIcon — Значок GIcon, позволяющий использовать числовые эмблемы

Функции

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 Чтение / Запись
gchar * background-icon-name Чтение / Запись
gint count Чтение / Запись
gchar * 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

a GtkStyleContext

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

новый 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 GtkNumerableIcon

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

GIcon, или NULL.

[передача ничто]

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

a GtkNumerableIcon

icon

a GIcon, или NULL.

[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

a GtkNumerableIcon

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

имя иконки, или NULL

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

a GtkNumerableIcon

icon_name

имя иконки, или NULL.

[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

a GtkNumerableIcon

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

текущее отображаемое значение

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

a 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

a GtkNumerableIcon

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

текущая отображаемая метка

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

a GtkNumerableIcon

label

короткая метка или NULL.

[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

a GtkNumerableIcon

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

GtkStyleContext или NULL. Этот объект является внутренним для GTK+ и не должен быть освобождён. Используйте g_object_ref(), если хотите сохранить его.

[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

a GtkNumerableIcon

style

a GtkStyleContext

С: 3.0

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

struct GtkNumerableIcon

struct GtkNumerableIcon;

Подробности свойств

Свойство “background-icon”

  “background-icon”          GIcon *

Значок для фона эмблемы числа.

Флаги: Чтение/Запись

Свойство “background-icon-name”

  “background-icon-name”     gchar *

Имя значка для фона эмблемы числа.

Флаги: Чтение/Запись

Значение по умолчанию: NULL

Свойство “count”

  “count”                    gint

Количество, отображаемое на эмблеме.

Флаги: Чтение/Запись

Допустимые значения: [-99,99]

Значение по умолчанию: 0

Свойство “label”

  “label”                    gchar *

Метка, отображаемая поверх значка.

Флаги: Чтение/Запись

Значение по умолчанию: NULL

Свойство “style-context”

  “style-context”            GtkStyleContext *

Контекст стиля для оформления внешнего вида значка.

Флаги: Чтение/Запись

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.20/GtkNumerableIcon.html

Spec-Zone.ru

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