GtkStatusIcon

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);

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

Обратите внимание, что возвращаемый размер имеет смысл только во время встраивания значка статуса (см. 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