/usr/include/d/gtkd-3/gtk/OffscreenWindow.d is in libgtkd-3-dev 3.7.5-2build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 | /*
* This file is part of gtkD.
*
* gtkD is free software; you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License
* as published by the Free Software Foundation; either version 3
* of the License, or (at your option) any later version, with
* some exceptions, please read the COPYING file.
*
* gtkD is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with gtkD; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
*/
// generated automatically - do not change
// find conversion definition on APILookup.txt
// implement new conversion functionalities on the wrap.utils pakage
module gtk.OffscreenWindow;
private import cairo.Surface;
private import gdkpixbuf.Pixbuf;
private import glib.ConstructionException;
private import gobject.ObjectG;
private import gtk.Widget;
private import gtk.Window;
private import gtk.c.functions;
public import gtk.c.types;
public import gtkc.gtktypes;
/**
* GtkOffscreenWindow is strictly intended to be used for obtaining
* snapshots of widgets that are not part of a normal widget hierarchy.
* Since #GtkOffscreenWindow is a toplevel widget you cannot obtain
* snapshots of a full window with it since you cannot pack a toplevel
* widget in another toplevel.
*
* The idea is to take a widget and manually set the state of it,
* add it to a GtkOffscreenWindow and then retrieve the snapshot
* as a #cairo_surface_t or #GdkPixbuf.
*
* GtkOffscreenWindow derives from #GtkWindow only as an implementation
* detail. Applications should not use any API specific to #GtkWindow
* to operate on this object. It should be treated as a #GtkBin that
* has no parent widget.
*
* When contained offscreen widgets are redrawn, GtkOffscreenWindow
* will emit a #GtkWidget::damage-event signal.
*/
public class OffscreenWindow : Window
{
/** the main Gtk struct */
protected GtkOffscreenWindow* gtkOffscreenWindow;
/** Get the main Gtk struct */
public GtkOffscreenWindow* getOffscreenWindowStruct(bool transferOwnership = false)
{
if (transferOwnership)
ownedRef = false;
return gtkOffscreenWindow;
}
/** the main Gtk struct as a void* */
protected override void* getStruct()
{
return cast(void*)gtkOffscreenWindow;
}
protected override void setStruct(GObject* obj)
{
gtkOffscreenWindow = cast(GtkOffscreenWindow*)obj;
super.setStruct(obj);
}
/**
* Sets our main struct and passes it to the parent class.
*/
public this (GtkOffscreenWindow* gtkOffscreenWindow, bool ownedRef = false)
{
this.gtkOffscreenWindow = gtkOffscreenWindow;
super(cast(GtkWindow*)gtkOffscreenWindow, ownedRef);
}
/** */
public static GType getType()
{
return gtk_offscreen_window_get_type();
}
/**
* Creates a toplevel container widget that is used to retrieve
* snapshots of widgets without showing them on the screen.
*
* Returns: A pointer to a #GtkWidget
*
* Since: 2.20
*
* Throws: ConstructionException GTK+ fails to create the object.
*/
public this()
{
auto p = gtk_offscreen_window_new();
if(p is null)
{
throw new ConstructionException("null returned by new");
}
this(cast(GtkOffscreenWindow*) p);
}
/**
* Retrieves a snapshot of the contained widget in the form of
* a #GdkPixbuf. This is a new pixbuf with a reference count of 1,
* and the application should unreference it once it is no longer
* needed.
*
* Returns: A #GdkPixbuf pointer, or %NULL.
*
* Since: 2.20
*/
public Pixbuf getPixbuf()
{
auto p = gtk_offscreen_window_get_pixbuf(gtkOffscreenWindow);
if(p is null)
{
return null;
}
return ObjectG.getDObject!(Pixbuf)(cast(GdkPixbuf*) p, true);
}
/**
* Retrieves a snapshot of the contained widget in the form of
* a #cairo_surface_t. If you need to keep this around over window
* resizes then you should add a reference to it.
*
* Returns: A #cairo_surface_t pointer to the offscreen
* surface, or %NULL.
*
* Since: 2.20
*/
public Surface getSurface()
{
auto p = gtk_offscreen_window_get_surface(gtkOffscreenWindow);
if(p is null)
{
return null;
}
return new Surface(cast(cairo_surface_t*) p);
}
}
|