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, имели свои имена, префиксрованные именем пространства имён, плюс точка. Например, если действие «выход» упоминается, а action_namespace равно «приложение», то эффективное имя действия — «приложение.выход».

Эта функция использует GtkActionable для определения имени действия и целевых значений созданных элементов меню. Если вы хотите использовать другую группу действий, отличную от «приложение» и «окно», или если вы хотите использовать GtkMenuShell вне GtkApplicationWindow, вам необходимо прикрепить собственную группу действий к иерархии виджетов, используя gtk_widget_insert_action_group(). Например, если вы создали группу с действием «выход» и вставили её с именем «моягруппа», то вы бы использовали имя действия «моягруппа.выход» в вашем 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