GtkPopover

gtk_popover_new ()

GtkWidget *
gtk_popover_new (GtkWidget *relative_to);

Создаёт новый всплывающее меню, указывающее на relative_to

С: 3.12

gtk_popover_new_from_model ()

GtkWidget *
gtk_popover_new_from_model (GtkWidget *relative_to,
                            GMenuModel *model);

Создаёт GtkPopover и заполняет его в соответствии с model. Всплывающее меню указывает на виджет relative_to.

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

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

С: 3.12

gtk_popover_bind_model ()

void
gtk_popover_bind_model (GtkPopover *popover,
                        GMenuModel *model,
                        const gchar *action_namespace);

Устанавливает связь между GtkPopover и GMenuModel.

Содержимое popover удаляется и затем заполняется пунктами меню в соответствии с model. При изменении model, popover обновляется. Вызов этой функции дважды для popover с разными model приведет к замене первой привязки на привязку к новому модели. Если model равен NULL, то любая предыдущая привязка отменяется, и все дочерние элементы удаляются.

Если action_namespace отличен от NULL, то эффект будет таким, как если бы все действия, упомянутые в model, имели свои имена, префиксные именем пространства имён, плюс точка. Например, если действие «quit» упомянуто, а action_namespace равно «app», то эффективное имя действия будет «app.quit».

Эта функция использует GtkActionable для определения имени действия и целевых значений для созданных пунктов меню. Если вы хотите использовать другую группу действий, кроме «app» и «win», или если вы хотите использовать GtkMenuShell вне GtkApplicationWindow, то вам необходимо присоединить свою собственную группу действий к иерархии виджетов, используя gtk_widget_insert_action_group(). Например, если вы создали группу с действием «quit» и вставили её с именем «mygroup», то вы бы использовали имя действия «mygroup.quit» в вашем GMenuModel.

С: 3.12

gtk_popover_set_relative_to ()

void
gtk_popover_set_relative_to (GtkPopover *popover,
                             GtkWidget *relative_to);

Устанавливает новый виджет для привязки к popover. Если popover виден, положение будет обновлено.

Примечание: владение всплывающими меню всегда передаётся виджету relative_to, поэтому, если relative_to установлено в NULL для прикреплённого popover, оно будет отсоединено от предыдущего виджета и, следовательно, уничтожено, если не будет создано дополнительных ссылок.

С: 3.12

gtk_popover_get_relative_to ()

GtkWidget *
gtk_popover_get_relative_to (GtkPopover *popover);

Возвращает виджет, к которому popover в настоящее время прикреплён.

С: 3.12

gtk_popover_set_pointing-to ()

void
gtk_popover_set_pointing_to (GtkPopover *popover,
                             const GdkRectangle *rect);

Устанавливает прямоугольник, к которому будет указывать popover, в системе координат виджета, к которому прикреплён popover, см. gtk_popover_set_relative_to().

С: 3.12

gtk_popover_get_pointing_to ()

gboolean
gtk_popover_get_pointing_to (GtkPopover *popover,
                             GdkRectangle *rect);

Если прямоугольник для указания был задан, эта функция вернёт TRUE и заполнит rect этим прямоугольником, в противном случае вернёт FALSE и заполнит rect координатами прикрепленного виджета.

gtk_popover_set_position ()

void
gtk_popover_set_position (GtkPopover *popover,
                          GtkPositionType position);

Устанавливает предпочтительное положение для появления popover. Если popover в настоящее время отображается, оно будет обновлено немедленно.

Эта предпочтительная настройка будет соблюдаться по возможности, хотя при недостатке места (например, если поблизости находятся края окна), GtkPopover может выбрать отображение на противоположной стороне.

С: 3.12

gtk_popover_get_position ()

GtkPositionType
gtk_popover_get_position (GtkPopover *popover);

Возвращает предпочтительное положение popover .

gtk_popover_set_constrain_to ()

void
gtk_popover_set_constrain_to (GtkPopover *popover,
                              GtkPopoverConstraint constraint);

Устанавливает ограничение для позиционирования этой всплывающей подсказки.

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

С: 3.20

gtk_popover_get_constrain_to ()

GtkPopoverConstraint
gtk_popover_get_constrain_to (GtkPopover *popover);

Возвращает ограничение для размещения этой всплывающей подсказки. См. gtk_popover_set_constrain_to().

С: 3.20

gtk_popover_set_modal ()

void
gtk_popover_set_modal (GtkPopover *popover,
                       gboolean modal);

Устанавливает, является ли popover модальным. Модальная всплывающая подсказка захватывает весь ввод внутри главного окна и захватывает фокус клавиатуры при отображении. Щелчок вне области всплывающей подсказки или нажатие клавиши Esc закроет всплывающую подсказку и освободит ввод.

С: 3.12

gtk_popover_get_modal ()

gboolean
gtk_popover_get_modal (GtkPopover *popover);

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

С: 3.12

gtk_popover_set_transitions_enabled ()

void
gtk_popover_set_transitions_enabled (GtkPopover *popover,
                                     gboolean transitions_enabled);

Устанавливает, включены ли переходы при показе/скрытии этой всплывающей подсказки

С: 3.16

gtk_popover_get_transitions_enabled ()

gboolean
gtk_popover_get_transitions_enabled (GtkPopover *popover);

Возвращает, включены ли переходы при показе/скрытии этой всплывающей подсказки.

С: 3.16

gtk_popover_set_default_widget ()

void
gtk_popover_set_default_widget (GtkPopover *popover,
                                GtkWidget *widget);

Устанавливает виджет, который должен быть установлен как виджет по умолчанию во время показа всплывающей подсказки (см. gtk_window_set_default()). GtkPopover запоминает предыдущий виджет по умолчанию и восстанавливает его при закрытии всплывающей подсказки.

С: 3.18

gtk_popover_get_default_widget ()

GtkWidget *
gtk_popover_get_default_widget (GtkPopover *popover);

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

С: 3.18