NAME

Gtk2::Ex::WindowManagerFrame -- access to the window manager frame window

SYNOPSIS

use Gtk2::Ex::WindowManagerFrame;

FUNCTIONS

Gtk2::Ex::WindowManagerFrame::window_get_frame_window ($window)

$window is a Gtk2::Gdk::Window. If it has a parent frame window, added by the window manager, then return that as a "foreign" type Gtk2::Gdk::Window. If there's no frame then return undef.

Gtk2::Ex::WindowManagerFrame::widget_to_pixbuf_with_frame ($widget)

Return a new Gtk2::Gdk::Pixbuf with the contents of $widget's toplevel window plus its window manager frame (if it has one).

Generally the window and frame must be on-screen and unobscured. (The gambits in gtk_widget_get_snapshot to redirect window draws, instead of using GraphicsExpose, of course can't work with the window manager's drawing.)

IMPLEMENTATION

Gdk doesn't provide direct access to the window manager frame window (as of version 2.14). This module instead uses X11::Protocol,X11::Protocol if available, or the xwininfo program if not. Currently when using X11::Protocol an extra connection is opened to the display and held open with the Gtk2::Gdk::Display object of any windows used.

SEE ALSO

Gtk2::Gdk::Window, Gtk2::Gdk::Display, X11::Protocol, xwininfo(1)