GtkСтатусИконка

gtk_status_icon_new ()

GtkStatusIcon *
gtk_status_icon_new (void);

Создаёт пустой объект значка статуса.

С версии: 2.10

gtk_status_icon_new_from_pixbuf ()

GtkStatusIcon *
gtk_status_icon_new_from_pixbuf (GdkPixbuf *pixbuf);

Создаёт значок статуса, отображающий pixbuf .

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

С версии: 2.10

gtk_status_icon_new_from_file ()

GtkStatusIcon *
gtk_status_icon_new_from_file (const gchar *filename);

Создаёт значок статуса, отображающий файл filename .

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

С версии: 2.10

gtk_status_icon_new_from_stock ()

GtkStatusIcon *
gtk_status_icon_new_from_stock (const gchar *stock_id);

Создаёт значок статуса, отображающий значок из набора. Примеры имён значков из набора: GTK_STOCK_OPEN, GTK_STOCK_QUIT. Вы можете зарегистрировать свои собственные имена значков из набора, см. gtk_icon_factory_add_default() и gtk_icon_factory_add().

С версии: 2.10

gtk_status_icon_new_from_icon_name ()

GtkStatusIcon *
gtk_status_icon_new_from_icon_name (const gchar *icon_name);

Создаёт значок статуса, отображающий значок из текущей темы оформления. Если тема оформления изменится, значок будет обновлён соответствующим образом.

С версии: 2.10

gtk_status_icon_new_from_gicon ()

GtkStatusIcon *
gtk_status_icon_new_from_gicon (GIcon *icon);

Создаёт значок статуса, отображающий GIcon. Если значок является значком из темы оформления, он будет обновлён при изменении темы.

С версии: 2.14

gtk_status_icon_set_from_pixbuf ()

void
gtk_status_icon_set_from_pixbuf (GtkStatusIcon *status_icon,
                                 GdkPixbuf *pixbuf);

Заставляет status_icon отображать pixbuf . См. gtk_status_icon_new_from_pixbuf() для подробностей.

С версии: 2.10

gtk_status_icon_set_from_file ()

void
gtk_status_icon_set_from_file (GtkStatusIcon *status_icon,
                               const gchar *filename);

Заставляет status_icon отображать файл filename . См. gtk_status_icon_new_from_file() для подробностей.

С версии: 2.10

gtk_status_icon_set_from_stock ()

void
gtk_status_icon_set_from_stock (GtkStatusIcon *status_icon,
                                const gchar *stock_id);

Заставляет status_icon отображать значок из набора с идентификатором stock_id . См. gtk_status_icon_new_from_stock() для подробностей.

С версии: 2.10

gtk_status_icon_set_from_icon_name ()

void
gtk_status_icon_set_from_icon_name (GtkStatusIcon *status_icon,
                                    const gchar *icon_name);

Заставляет status_icon отображать значок с именем icon_name из текущей темы оформления. См. gtk_status_icon_new_from_icon_name() для подробностей.

С версии: 2.10

gtk_status_icon_set_from_gicon ()

void
gtk_status_icon_set_from_gicon (GtkStatusIcon *status_icon,
                                GIcon *icon);

Отображает status_icon GIcon. См. gtk_status_icon_new_from_gicon() для получения подробностей.

С: 2.14

gtk_status_icon_get_storage_type ()

GtkImageType
gtk_status_icon_get_storage_type (GtkStatusIcon *status_icon);

Получает тип представления, используемый GtkStatusIcon для хранения данных изображения. Если у GtkStatusIcon нет данных изображения, возвращаемое значение будет GTK_IMAGE_EMPTY.

С: 2.10

gtk_status_icon_get_pixbuf ()

GdkPixbuf *
gtk_status_icon_get_pixbuf (GtkStatusIcon *status_icon);

Получает GdkPixbuf, отображаемый GtkStatusIcon. Тип хранения значка состояния должен быть GTK_IMAGE_EMPTY или GTK_IMAGE_PIXBUF (см. gtk_status_icon_get_storage_type()). Звонящий функция не владеет ссылкой на возвращённый pixbuf.

С: 2.10

gtk_status_icon_get_stock ()

const gchar *
gtk_status_icon_get_stock (GtkStatusIcon *status_icon);

Получает идентификатор значка по умолчанию, отображаемого GtkStatusIcon. Тип хранения значка состояния должен быть GTK_IMAGE_EMPTY или GTK_IMAGE_STOCK (см. gtk_status_icon_get_storage_type()). Возвращённая строка принадлежит GtkStatusIcon и не должна освобождаться или изменяться.

С: 2.10

gtk_status_icon_get_icon_name ()

const gchar *
gtk_status_icon_get_icon_name (GtkStatusIcon *status_icon);

Получает имя значка, отображаемого GtkStatusIcon. Тип хранения значка состояния должен быть GTK_IMAGE_EMPTY или GTK_IMAGE_ICON_NAME (см. gtk_status_icon_get_storage_type()). Возвращённая строка принадлежит GtkStatusIcon и не должна освобождаться или изменяться.

С: 2.10

gtk_status_icon_get_gicon ()

GIcon *
gtk_status_icon_get_gicon (GtkStatusIcon *status_icon);

Возвращает GIcon, отображаемый GtkStatusIcon. Тип хранения значка состояния должен быть GTK_IMAGE_EMPTY или GTK_IMAGE_GICON (см. gtk_status_icon_get_storage_type()). Звонящий функция не владеет ссылкой на возвращённый GIcon.

Если функция завершится неудачно, icon остаётся без изменений;

С: 2.14

gtk_status_icon_get_size ()

gint
gtk_status_icon_get_size (GtkStatusIcon *status_icon);

Получает размер в пикселях, доступный для изображения. Значки по умолчанию и именованные значки автоматически адаптируют свой размер, если размер области уведомления изменяется. Для других типов хранения можно использовать сигнал size-changed для реакции на изменения размера.

Обратите внимание, что возвращаемый размер имеет смысл только при встраивании значка состояния (см. gtk_status_icon_is_embedded()).

С: 2.10

gtk_status_icon_set_screen ()

void
gtk_status_icon_set_screen (GtkStatusIcon *status_icon,
                            GdkScreen *screen);

Устанавливает GdkScreen, на котором отображается status_icon; если значок уже отображается, он будет скрыт, а затем повторно отображен на новом экране.

С: 2.12

gtk_status_icon_get_screen ()

GdkScreen *
gtk_status_icon_get_screen (GtkStatusIcon *status_icon);

Возвращает GdkScreen, связанный с status_icon.

С: 2.12

gtk_status_icon_set_tooltip_text ()

void
gtk_status_icon_set_tooltip_text (GtkStatusIcon *status_icon,
                                  const gchar *text);

Устанавливает text в качестве содержимого всплывающей подсказки.

Эта функция позаботится о установке “has-tooltip” в TRUE и обработки по умолчанию для сигнала “query-tooltip”.

См. также свойство “tooltip-text” и gtk_tooltip_set_text().

С: 2.16

gtk_status_icon_get_tooltip_text ()

gchar *
gtk_status_icon_get_tooltip_text (GtkStatusIcon *status_icon);

Получает содержимое всплывающей подсказки для status_icon.

С: 2.16

gtk_status_icon_set_tooltip_markup ()

void
gtk_status_icon_set_tooltip_markup (GtkStatusIcon *status_icon,
                                    const gchar *markup);

Устанавливает markup в качестве содержимого всплывающей подсказки, которое форматируется с помощью языка разметки текста Pango.

Эта функция позаботится о установке “has-tooltip” в TRUE и обработки по умолчанию для сигнала “query-tooltip”.

См. также свойство “tooltip-markup” и gtk_tooltip_set_markup().

С: 2.16

gtk_status_icon_get_tooltip_markup ()

gchar *
gtk_status_icon_get_tooltip_markup (GtkStatusIcon *status_icon);

Получает содержимое всплывающей подсказки для status_icon.

С: 2.16

gtk_status_icon_set_has_tooltip ()

void
gtk_status_icon_set_has_tooltip (GtkStatusIcon *status_icon,
                                 gboolean has_tooltip);

Устанавливает свойство has-tooltip для status_icon в значение has_tooltip. Подробнее см. “has-tooltip”.

С: 2.16

gtk_status_icon_get_has_tooltip ()

gboolean
gtk_status_icon_get_has_tooltip (GtkStatusIcon *status_icon);

Возвращает текущее значение свойства has-tooltip. Подробнее см. “has-tooltip”.

С: 2.16

gtk_status_icon_set_title ()

void
gtk_status_icon_set_title (GtkStatusIcon *status_icon,
                           const gchar *title);

Устанавливает заголовок этого значка подноса. Это должна быть короткая, понятная пользователю, локализованная строка, описывающая значок подноса. Она может использоваться инструментами, такими как программы для чтения с экрана, для отображения значка подноса.

С: 2.18

gtk_status_icon_get_title ()

const gchar *
gtk_status_icon_get_title (GtkStatusIcon *status_icon);

Возвращает заголовок этого значка подноса. См. gtk_status_icon_set_title().

С: 2.18

gtk_status_icon_set_name ()

void
gtk_status_icon_set_name (GtkStatusIcon *status_icon,
                          const gchar *name);

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

С: 2.20

gtk_status_icon_set_visible ()

void
gtk_status_icon_set_visible (GtkStatusIcon *status_icon,
                             gboolean visible);

Отображает или скрывает значок подноса.

С: 2.10

gtk_status_icon_get_visible ()

gboolean
gtk_status_icon_get_visible (GtkStatusIcon *status_icon);

Возвращает, виден ли значок подноса или нет. Обратите внимание, что видимость не гарантирует, что пользователь сможет фактически увидеть значок, см. также gtk_status_icon_is_embedded().

С: 2.10

gtk_status_icon_is_embedded ()

gboolean
gtk_status_icon_is_embedded (GtkStatusIcon *status_icon);

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

С: 2.10

gtk_status_icon_position_menu ()

void
gtk_status_icon_position_menu (GtkMenu *menu,
                               gint *x,
                               gint *y,
                               gboolean *push_in,
                               gpointer user_data);

Функция позиционирования меню, используемая с gtk_menu_popup() для позиционирования menu, выровненного по значку подноса user_data.

С: 2.10

gtk_status_icon_get_geometry ()

gboolean
gtk_status_icon_get_geometry (GtkStatusIcon *status_icon,
                              GdkScreen **screen,
                              GdkRectangle *area,
                              GtkOrientation *orientation);

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

См. gtk_status_icon_position_menu() для более удобного способа позиционирования меню.

Обратите внимание, что некоторые платформы не позволяют GTK+ предоставлять эту информацию, и даже на платформах, которые это позволяют, информация не является надёжной, если значок состояния не встроен в область уведомлений, см. gtk_status_icon_is_embedded().

С: 2.10

gtk_status_icon_get_x11_window_id ()

guint32
gtk_status_icon_get_x11_window_id (GtkStatusIcon *status_icon);

Эта функция полезна только на платформе X11/freedesktop.org. Она возвращает идентификатор окна виджета в реализации значка состояния. Это полезно для службы уведомлений Galago, которая может отправлять идентификатор окна в протоколе, чтобы сервер мог надёжно позиционировать окна уведомлений, указывающие на значок состояния.

Эта функция не предназначена для других случаев использования, которые скорее всего будут удовлетворены одним из методов, не специфичных для X11, таких как gtk_status_icon_position_menu().

С: 2.14

Сигнал “activate”

void
user_function (GtkStatusIcon *status_icon,
               gpointer       user_data)

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

В отличие от большинства сигналов G_SIGNAL_ACTION, этот сигнал предназначен для использования приложениями и должен быть обернут языковыми связками.

Флаги: Действие

С версии: 2.10

Сигнал “button-press-event”

gboolean
user_function (GtkStatusIcon *status_icon,
               GdkEvent      *event,
               gpointer       user_data)

Сигнал ::button-press-event будет выпущен при нажатии кнопки (обычно мыши).

Выпуск этого события зависит от платформы. Вместо него используйте сигналы ::activate и ::popup-menu.

Флаги: Выполнить последним

С версии: 2.14

Сигнал “button-release-event”

gboolean
user_function (GtkStatusIcon *status_icon,
               GdkEvent      *event,
               gpointer       user_data)

Сигнал ::button-release-event будет выпущен при отпускании кнопки (обычно мыши).

Выпуск этого события зависит от платформы. Вместо него используйте сигналы ::activate и ::popup-menu.

Флаги: Выполнить последним

С версии: 2.14

Сигнал “popup-menu”

void
user_function (GtkStatusIcon *status_icon,
               guint          button,
               guint          activate_time,
               gpointer       user_data)

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

Параметры button и activate_time должны передаваться как последние аргументы в gtk_menu_popup().

В отличие от большинства сигналов G_SIGNAL_ACTION, этот сигнал предназначен для использования приложениями и должен быть обернут языковыми связками.

Флаги: Действие

С версии: 2.10

Сигнал “query-tooltip”

gboolean
user_function (GtkStatusIcon *status_icon,
               gint           x,
               gint           y,
               gboolean       keyboard_mode,
               GtkTooltip    *tooltip,
               gpointer       user_data)

Выполняется, когда тайм-аут наведения курсора истек, и курсор находится над status_icon; или когда status_icon получил фокус в режиме клавиатуры.

Используя заданные координаты, обработчик сигнала должен определить, следует ли отображать всплывающую подсказку для status_icon . В случае необходимости, следует вернуть TRUE, в противном случае - FALSE. Обратите внимание, что если keyboard_mode равно TRUE, значения x и y не определены и не должны использоваться.

Обработчик сигнала свободен манипулировать tooltip с помощью соответствующих вызовов функций.

Выпуск этого сигнала зависит от платформы. Для обычных текстовых всплывающих подсказок используйте свойство “tooltip-text” вместо него.

Флаги: Выполнить последним

С версии: 2.16

Сигнал “scroll-event”

gboolean
user_function (GtkStatusIcon *status_icon,
               GdkEvent      *event,
               gpointer       user_data)

Сигнал ::scroll-event генерируется при нажатии кнопки в диапазоне от 4 до 7. Колесиковые мыши обычно настроены так, чтобы генерировать события нажатия кнопок 4 и 5 при вращении колесика.

Выдача этого события зависит от платформы.

Флаги: Run Last

С версии: 2.16

Сигнал “size-changed”

gboolean
user_function (GtkStatusIcon *status_icon,
               gint           size,
               gpointer       user_data)

Генерируется, когда изменяется размер, доступный для изображения, например, из-за изменения размера области уведомлений.

Флаги: Run Last

С версии: 2.10