.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "X11::XCB::Window 3pm"
.TH X11::XCB::Window 3pm "2018-11-02" "perl v5.28.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
X11::XCB::Window \- represents an X11 window
.SH "METHODS"
.IX Header "METHODS"
.SS "rect"
.IX Subsection "rect"
As long as the window is not mapped, this returns the planned geometry. As soon
as the window is mapped, this returns its geometry \fBincluding\fR the window
decorations.
.PP
Thus, after the window is mapped, every time you access \f(CW\*(C`rect\*(C'\fR, the geometry
will be determined by querying X11 about it, thus generating at least 1 round\-
trip for non-reparenting window managers and two or more round-trips for
reparenting window managers.
.PP
In scalar context it returns only the window’s geometry, in list context it
returns the window’s geometry and the geometry of the top window (the one
containing this window but the first one under the root window in hierarchy).
.SS "attributes"
.IX Subsection "attributes"
Returns the X11 attributes of this window.
.SS "map"
.IX Subsection "map"
Maps the window on the screen, that is, makes it visible.
.SS "unmap"
.IX Subsection "unmap"
The opposite of map, that is, makes your window invisible.
.SS "destroy"
.IX Subsection "destroy"
Destroys the window completely
.SS "mapped"
.IX Subsection "mapped"
Returns whether the window is actually mapped (no internal state, but gets
the window attributes from X11 and checks for \s-1MAP_STATE_VIEWABLE\s0).
.SS "create_child(options)"
.IX Subsection "create_child(options)"
Creates a new \f(CW\*(C`X11::XCB::Window\*(C'\fR as a child window of the current window.
.SS "add_hint($hint)"
.IX Subsection "add_hint($hint)"
Adds the given \f(CW$hint\fR (one of \*(L"urgency\*(R") to the window’s set of hints.
.SS "delete_hint($hint)"
.IX Subsection "delete_hint($hint)"
Opposite of add_hint.
.ie n .SS "warp_pointer($x, $y)"
.el .SS "warp_pointer($x, \f(CW$y\fP)"
.IX Subsection "warp_pointer($x, $y)"
Moves the pointer to the offsets ($x, \f(CW$y\fR) relative to the origin of the
window on which it is called. If \f(CW$x\fR and \f(CW$y\fR are undef, moves the pointer
into the center of the window.
.SS "state"
.IX Subsection "state"
Returns the \s-1WM_STATE\s0 of this window (normal, withdrawn, iconic).