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

Возвращает размер в пикселях, доступный для изображения. Значки из набора и значки по имени автоматически адаптируют свой размер, если размер области уведомлений меняется. Для других типов хранения можно использовать сигнал 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 при вращении колеса.

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

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

С: 2.16

Сигнал “size-changed”

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

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

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

С: 2.10