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_popup ()

void
gtk_popover_popup (GtkPopover *popover);

Отображает popover. Это отличается от вызова gtk_widget_show() тем, что отображает всплывающее меню с эффектом анимации. Если вы хотите отобразить всплывающее меню без анимации, используйте gtk_widget_show().

С: 3.22

gtk_popover_popdown ()

void
gtk_popover_popdown (GtkPopover *popover);

Скрывает popover. Это отличается от вызова gtk_widget_hide() тем, что скрывает всплывающее меню с эффектом анимации. Если вы хотите скрыть всплывающее меню без анимации, используйте gtk_widget_hide().

С: 3.22

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