GtkRoot

GtkRoot — Интерфейс для корневых виджетов

Функции

GdkDisplay *	gtk_root_get_display ()
GtkWidget *	gtk_root_get_focus ()
void	gtk_root_set_focus ()

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

GtkRoot

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

    GInterface
    ╰── GtkRoot

Предварительные требования

GtkRoot требует GtkNative и GtkWidget.

Известные реализации

GtkRoot реализован в GtkAboutDialog, GtkAppChooserDialog, GtkApplicationWindow, GtkAssistant, GtkColorChooserDialog, GtkDialog, GtkDragIcon, GtkFileChooserDialog, GtkFontChooserDialog, GtkMessageDialog, GtkPageSetupUnixDialog, GtkPrintUnixDialog, GtkShortcutsWindow и GtkWindow.

Файлы заголовков

#include <gtk/gtk.h>

Описание

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

Ярким примером GtkRoot является GtkWindow.

Функции

gtk_root_get_display ()

GdkDisplay *
gtk_root_get_display (GtkRoot *self);

Возвращает дисплей, на котором находится этот GtkRoot.

Параметры

self

a GtkRoot

Возвращаемое значение

дисплей root .

[transfer none]

gtk_root_get_focus ()

GtkWidget *
gtk_root_get_focus (GtkRoot *self);

Возвращает текущий виджет с фокусом в пределах корневого виджета.

Обратите внимание, что это виджет, который получил бы фокус, если бы корневой виджет был активен; если корневой виджет не имеет фокуса, то gtk_widget_has_focus (widget) будет FALSE для виджета.

Параметры

self

a GtkRoot

Возвращаемое значение

текущий виджет с фокусом или NULL , если такого нет.

[nullable][transfer none]

gtk_root_set_focus ()

void
gtk_root_set_focus (GtkRoot *self,
                    GtkWidget *focus);

Если focus не является текущим виджетом с фокусом и является фокусируемым, устанавливает его в качестве виджета с фокусом для корневого виджета. Если focus является NULL, снимает фокус с виджета корневого виджета.

Для установки фокуса на определенный виджет в корневом виджете обычно удобнее использовать gtk_widget_grab_focus() вместо этой функции.

Параметры

self	a GtkRoot
focus	виджет, который должен стать новым виджетом с фокусом, или `NULL` для снятия фокуса с виджета.	[allow-none]

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

GtkRoot

typedef struct _GtkRoot GtkRoot;

См. также

GtkWindow

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkRoot.html