Spec-Zone.ru › GTK 3.22

GtkOffscreenWindow

GtkOffscreenWindow — Верхний уровень для управления внеэкранным рендерингом дочерних виджетов

Функции

GtkWidget * gtk_offscreen_window_new ()
cairo_surface_t * gtk_offscreen_window_get_surface ()
GdkPixbuf * gtk_offscreen_window_get_pixbuf ()

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

struct GtkOffscreenWindow
struct GtkOffscreenWindowClass

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkWindow
                        ╰── GtkOffscreenWindow

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

GtkOffscreenWindow реализует AtkImplementorIface и GtkBuildable.

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

#include <gtk/gtk.h>

Описание

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

Идея заключается в том, чтобы взять виджет, вручную установить его состояние, добавить его в GtkOffscreenWindow и затем извлечь снимок в виде cairo_surface_t или GdkPixbuf.

GtkOffscreenWindow наследуется от GtkWindow только как деталь реализации. Приложения не должны использовать никакие API, специфичные для GtkWindow, для работы с этим объектом. Он должен рассматриваться как GtkBin без родительского виджета.

Когда содержимые внеэкранные виджеты перерисовываются, GtkOffscreenWindow будет излучать сигнал “damage-event”.

Функции

gtk_offscreen_window_new ()

GtkWidget *
gtk_offscreen_window_new (void);

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

Возвращает

Указатель на GtkWidget

С: 2.20

gtk_offscreen_window_get_surface ()

cairo_surface_t *
gtk_offscreen_window_get_surface (GtkOffscreenWindow *offscreen);

Возвращает снимок содержащего виджета в виде cairo_surface_t. Если вам нужно сохранить его при изменении размеров окна, добавьте ссылку на него.

Параметры

offscreen

содержащий виджет GtkOffscreenWindow.

Возвращает

Указатель cairo_surface_t на поверхность вне экрана или NULL.

[nullable][transfer none]

С: 2.20

gtk_offscreen_window_get_pixbuf ()

GdkPixbuf *
gtk_offscreen_window_get_pixbuf (GtkOffscreenWindow *offscreen);

Возвращает снимок содержащего виджета в виде GdkPixbuf. Это новый pixbuf с счётчиком ссылок 1, и приложение должно уменьшить счётчик ссылок, когда он больше не нужен.

Параметры

offscreen

содержащий виджет GtkOffscreenWindow.

Возвращает

Указатель GdkPixbuf или NULL.

[nullable][transfer full]

С: 2.20

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

struct GtkOffscreenWindow

struct GtkOffscreenWindow;

struct GtkOffscreenWindowClass

struct GtkOffscreenWindowClass {
  GtkWindowClass parent_class;
};

Члены

© 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/GtkOffscreenWindow.html

Spec-Zone.ru

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