Spec-Zone.ru › GTK 3.22

GtkImageMenuItem

GtkImageMenuItem — Устаревший виджет для пункта меню с иконкой

Функции

void gtk_image_menu_item_set_image ()
GtkWidget * gtk_image_menu_item_get_image ()
GtkWidget * gtk_image_menu_item_new ()
GtkWidget * gtk_image_menu_item_new_from_stock ()
GtkWidget * gtk_image_menu_item_new_with_label ()
GtkWidget * gtk_image_menu_item_new_with_mnemonic ()
gboolean gtk_image_menu_item_get_use_stock ()
void gtk_image_menu_item_set_use_stock ()
gboolean gtk_image_menu_item_get_always_show_image ()
void gtk_image_menu_item_set_always_show_image ()
void gtk_image_menu_item_set_accel_group ()

Свойства

GtkAccelGroup * accel-group Write
gboolean always-show-image Read / Write / Construct
GtkWidget * image Read / Write
gboolean use-stock Read / Write / Construct

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

struct GtkImageMenuItem
struct GtkImageMenuItemClass

Иерархия объектов

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkMenuItem
                        ╰── GtkImageMenuItem

Реализованные интерфейсы

GtkImageMenuItem реализует AtkImplementorIface, GtkBuildable, GtkActivatable и GtkActionable.

Файлы

#include <gtk/gtk.h>

Описание

GtkImageMenuItem — это пункт меню, у которого рядом с текстовой меткой есть иконка.

Функционально эквивалентен:

Обратите внимание, что пользователь может отключить отображение значков меню с помощью параметра “gtk-menu-images”, поэтому обязательно заполняйте текстовую метку. Если вы хотите гарантировать отображение иконок в пунктах меню, настоятельно рекомендуется использовать GtkMenuItem с GtkImage вместо него.

GtkImageMenuItem устарел с GTK+ 3.10. Если вам нужно отобразить иконку в пункте меню, используйте GtkMenuItem и разместите GtkBox с GtkImage и GtkLabel внутри. Также следует рассмотреть использование GtkBuilder и XML-описания GMenu для создания меню, следуя руководству GMenu. Иконки в пунктах меню следует использовать с осторожностью и только для элементов "объектов" (или "существительных"), таких как закладки, файлы и ссылки; "действия" (или "глаголы") не должны иметь иконок.

Кроме того, если вы хотите отобразить сочетание клавиш, необходимо добавить метку сочетания клавиш в box с помощью gtk_box_pack_end() и выровнять метку, в противном случае сочетание клавиш не будет отображаться должным образом. Следующий фрагмент кода добавляет сочетание клавиш в пункт меню с назначением Ctrl+M:

GtkWidget *box = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 6);
GtkWidget *icon = gtk_image_new_from_icon_name ("folder-music-symbolic", GTK_ICON_SIZE_MENU);
GtkWidget *label = gtk_label_new ("Music");
GtkWidget *menu_item = gtk_menu_item_new ();

gtk_container_add (GTK_CONTAINER (box), icon);
gtk_container_add (GTK_CONTAINER (box), label);

gtk_container_add (GTK_CONTAINER (menu_item), box);

gtk_widget_show_all (menu_item);

Функции

gtk_image_menu_item_set_image ()

void
gtk_image_menu_item_set_image (GtkImageMenuItem *image_menu_item,
                               GtkWidget *image);

gtk_image_menu_item_set_image устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Устанавливает изображение для image_menu_item на заданный виджет. Обратите внимание, что отображение изображения зависит от параметра show-menu-images.

Параметры

image_menu_item

элемент меню GtkImageMenuItem.

image

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

 [allow-none]

gtk_image_menu_item_get_image ()

GtkWidget *
gtk_image_menu_item_get_image (GtkImageMenuItem *image_menu_item);

gtk_image_menu_item_get_image устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Возвращает виджет, который в данный момент используется в качестве изображения для image_menu_item. Смотрите gtk_image_menu_item_set_image().

Параметры

image_menu_item

элемент меню GtkImageMenuItem

Возвращает

виджет, установленный в качестве изображения для image_menu_item.

[transfer none]

gtk_image_menu_item_new ()

GtkWidget *
gtk_image_menu_item_new (void);

gtk_image_menu_item_new устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Используйте gtk_menu_item_new() вместо этого.

Создаёт новый элемент меню GtkImageMenuItem с пустым текстом.

Возвращает

новый элемент меню GtkImageMenuItem

gtk_image_menu_item_new_from_stock ()

GtkWidget *
gtk_image_menu_item_new_from_stock (const gchar *stock_id,
                                    GtkAccelGroup *accel_group);

gtk_image_menu_item_new_from_stock устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Используйте gtk_menu_item_new_with_mnemonic() вместо этого.

Создаёт новый элемент меню GtkImageMenuItem, содержащий изображение и текст из набора стандартных элементов. Некоторые идентификаторы стандартных элементов имеют макросы препроцессора, например, GTK_STOCK_OK и GTK_STOCK_APPLY.

Если требуется возможность изменения акселераторов для этого элемента меню, передайте NULL для параметра accel_group. Затем вызовите gtk_menu_item_set_accel_path() с соответствующим путем для элемента меню, используйте gtk_stock_lookup() для поиска стандартного акселератора для стандартного элемента, и, если он найден, вызовите gtk_accel_map_add_entry() для его регистрации.

Параметры

stock_id

имя стандартного элемента.

accel_group

GtkAccelGroup для добавления акселератора элемента меню, или NULL.

 [allow-none]

Возвращает

новый элемент меню GtkImageMenuItem.

gtk_image_menu_item_new_with_label ()

GtkWidget *
gtk_image_menu_item_new_with_label (const gchar *label);

gtk_image_menu_item_new_with_label устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Используйте gtk_menu_item_new_with_label() вместо этого.

Создаёт новый элемент меню GtkImageMenuItem с заданным текстом.

Параметры

label

текст элемента меню.

Возвращает

новый элемент меню GtkImageMenuItem.

gtk_image_menu_item_new_with_mnemonic ()

GtkWidget *
gtk_image_menu_item_new_with_mnemonic (const gchar *label);

gtk_image_menu_item_new_with_mnemonic устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Используйте gtk_menu_item_new_with_mnemonic() вместо этого.

Создаёт новый элемент меню GtkImageMenuItem с заданным текстом. Текст создаётся с помощью gtk_label_new_with_mnemonic(), поэтому подчёркивания в label указывают на мнемонический символ элемента меню.

Параметры

label

текст элемента меню с подчёркнутым мнемоническим символом.

Возвращает

новый элемент меню GtkImageMenuItem

gtk_image_menu_item_get_use_stock ()

gboolean
gtk_image_menu_item_get_use_stock (GtkImageMenuItem *image_menu_item);

gtk_image_menu_item_get_use_stock устарела начиная с версии 3.10 и не должна использоваться в новом коде.

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

Параметры

image_menu_item

элемент меню GtkImageMenuItem

Возвращает

TRUE, если текст элемента меню используется как идентификатор стандартного элемента.

С: 2.16

gtk_image_menu_item_set_use_stock ()

void
gtk_image_menu_item_set_use_stock (GtkImageMenuItem *image_menu_item,
                                   gboolean use_stock);

gtk_image_menu_item_set_use_stock устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Если TRUE, текст элемента меню используется как идентификатор стандартного элемента.

Параметры

image_menu_item

элемент меню GtkImageMenuItem

use_stock

TRUE, если элемент меню должен использовать стандартный элемент.

С: 2.16

gtk_image_menu_item_get_always_show_image ()

gboolean
gtk_image_menu_item_get_always_show_image
                               (GtkImageMenuItem *image_menu_item);

gtk_image_menu_item_get_always_show_image устарело с версии 3.10 и не должно использоваться в новом коде.

Возвращает значение, указывающее, будет ли элемент меню игнорировать настройку “gtk-menu-images” и всегда отображать изображение, если оно доступно.

Параметры

image_menu_item

элемент GtkImageMenuItem

Возвращает

TRUE, если элемент меню всегда будет отображать изображение

С версии: 2.16

gtk_image_menu_item_set_always_show_image ()

void
gtk_image_menu_item_set_always_show_image
                               (GtkImageMenuItem *image_menu_item,
                                gboolean always_show);

gtk_image_menu_item_set_always_show_image устарело с версии 3.10 и не должно использоваться в новом коде.

Если TRUE, элемент меню будет игнорировать настройку “gtk-menu-images” и всегда отображать изображение, если оно доступно.

Используйте это свойство, если элемент меню бесполезен или сложен в использовании без изображения.

Параметры

image_menu_item

элемент GtkImageMenuItem

always_show

TRUE, если элемент меню должен всегда отображать изображение

С версии: 2.16

gtk_image_menu_item_set_accel_group ()

void
gtk_image_menu_item_set_accel_group (GtkImageMenuItem *image_menu_item,
                                     GtkAccelGroup *accel_group);

gtk_image_menu_item_set_accel_group устарело с версии 3.10 и не должно использоваться в новом коде.

Указывает accel_group для добавления ускорителя элемента меню (это применяется только к стандартным элементам, поэтому стандартный элемент должен быть уже установлен. Убедитесь, что вы сначала вызвали gtk_image_menu_item_set_use_stock() и gtk_menu_item_set_label() со стандартным элементом).

Если вы хотите, чтобы у этого элемента меню можно было изменять ускорители, то вам это не нужно (см. gtk_image_menu_item_new_from_stock()).

Параметры

image_menu_item

элемент GtkImageMenuItem

accel_group

группа GtkAccelGroup

С версии: 2.16

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

struct GtkImageMenuItem

struct GtkImageMenuItem;

struct GtkImageMenuItemClass

struct GtkImageMenuItemClass {
  GtkMenuItemClass parent_class;
};

Члены

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

Свойство “accel-group”

  “accel-group”              GtkAccelGroup *

Группа ускорителей для использования стандартных клавиш-ускорителей

GtkImageMenuItem:accel-group устарело с версии 3.10 и не должно использоваться в новом коде.

Используйте gtk_widget_add_accelerator() вместо этого

Флаги: Запись

С версии: 2.16

Свойство “always-show-image”

  “always-show-image”        gboolean

Если TRUE, элемент меню всегда будет отображать изображение, если оно доступно.

Используйте это свойство только если элемент меню бесполезен или сложен в использовании без изображения.

GtkImageMenuItem:always-show-image устарело с версии 3.10 и не должно использоваться в новом коде.

Используйте GtkMenuItem содержащий GtkBox с GtkAccelLabel и GtkImage вместо этого

Флаги: Чтение / Запись / Создание

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

С версии: 2.16

Свойство “image”

  “image”                    GtkWidget *

Дочерний виджет, который будет отображаться рядом с текстом меню.

GtkImageMenuItem:image устарело с версии 3.10 и не должно использоваться в новом коде.

Используйте GtkMenuItem содержащий GtkBox с GtkAccelLabel и GtkImage вместо этого

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

Свойство “use-stock”

  “use-stock”                gboolean

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

GtkImageMenuItem:use-stock устарело с версии 3.10 и не должно использоваться в новом коде.

Используйте имя иконки из GtkIconTheme вместо этого

Флаги: Чтение / Запись / Создание

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

С версии: 2.16

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

Spec-Zone.ru

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