<HTML
><HEAD
><TITLE
>gnome-geometry</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.74b"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-dns"
HREF="gnomeui-gnome-dns.html"><LINK
REL="NEXT"
TITLE="gnome-ice"
HREF="gnomeui-gnome-ice.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-dns.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><<< Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-ice.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page >>></B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-GEOMETRY"
>gnome-geometry</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN4113"
></A
><H2
>Name</H2
>gnome-geometry -- Window geometry utility functions.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN4116"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
> #include <gnome.h>
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> <A
HREF="gnomeui-gnome-geometry.html#GNOME-PARSE-GEOMETRY"
>gnome_parse_geometry</A
> (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *geometry,
<GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> *xpos,
<GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> *ypos,
<GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> *width,
<GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> *height);
<GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>* <A
HREF="gnomeui-gnome-geometry.html#GNOME-GEOMETRY-STRING"
>gnome_geometry_string</A
> (<GTKDOCLINK
HREF="GDKWINDOW"
>GdkWindow</GTKDOCLINK
> *window);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4129"
></A
><H2
>Description</H2
><P
>This module provides functions to parse a string that specifies a
window geometry (window position on the screen and dimenssions) as
well as a routine to fetch the geometry of a <SPAN
CLASS="TYPE"
>GtkWindow</SPAN
>
(for example, a <SPAN
CLASS="TYPE"
>GnomeApp</SPAN
> top level window).</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4134"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN4136"
></A
><H3
><A
NAME="GNOME-PARSE-GEOMETRY"
></A
>gnome_parse_geometry ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> gnome_parse_geometry (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *geometry,
<GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> *xpos,
<GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> *ypos,
<GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> *width,
<GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> *height);</PRE
></TD
></TR
></TABLE
><P
>Parses the geometry string passed in <TT
CLASS="PARAMETER"
><I
>geometry</I
></TT
>, and fills
<TT
CLASS="PARAMETER"
><I
>xpos</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>ypos</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>width</I
></TT
>, and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> with
the corresponding values upon completion of the parse.
If the parse fails, it should be assumed that <TT
CLASS="PARAMETER"
><I
>xpos</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>ypos</I
></TT
>, <TT
CLASS="PARAMETER"
><I
>width</I
></TT
>,
and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> contain undefined values.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4157"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>geometry</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> geometry string to be parsed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>xpos</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X position geometry component</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ypos</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y position geometry component</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width geometry component</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel height geometry component</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if the geometry was successfully parsed, <TT
CLASS="LITERAL"
>FALSE</TT
> otherwise.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN4188"
></A
><H3
><A
NAME="GNOME-GEOMETRY-STRING"
></A
>gnome_geometry_string ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>* gnome_geometry_string (<GTKDOCLINK
HREF="GDKWINDOW"
>GdkWindow</GTKDOCLINK
> *window);</PRE
></TD
></TR
></TABLE
><P
>Determines the size and position of <TT
CLASS="PARAMETER"
><I
>window</I
></TT
> (must be a window or
dialog), and returns that information as an X geometry string.
Geometry strings are in the form of WIDTHxHEIGHT+X+Y.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4197"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>window</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to window or dialog object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Newly-allocated string containing geometry string for given
window. Contents must be g_free'd.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-dns.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><<< Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-ice.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page >>></B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-dns</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-ice</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
