>

>

>The Alignment widget

>

NAME="GENERATOR"

CONTENT="Modular DocBook HTML Stylesheet Version 1.79">

REL="HOME"

TITLE="GTK+ 2.0 Tutorial"

HREF="book1.html">

REL="UP"

TITLE="Container Widgets"

HREF="c1226.html">

REL="PREVIOUS"

TITLE="Container Widgets"

HREF="c1226.html">

REL="NEXT"

TITLE="Fixed Container"

HREF="x1258.html">

>

CLASS="SECT1"

BGCOLOR="#FFFFFF"

TEXT="#000000"

LINK="#0000FF"

VLINK="#840084"

ALINK="#0000FF"

>

CLASS="NAVHEADER"

>

SUMMARY="Header navigation table"

WIDTH="100%"

BORDER="0"

CELLPADDING="0"

CELLSPACING="0"

>

>

COLSPAN="3"

ALIGN="center"

>GTK+ 2.0 Tutorial

>

>

>

WIDTH="10%"

ALIGN="left"

VALIGN="bottom"

>

HREF="c1226.html"

ACCESSKEY="P"

><<< Previous

>

>

WIDTH="80%"

ALIGN="center"

VALIGN="bottom"

>Container Widgets

>

WIDTH="10%"

ALIGN="right"

VALIGN="bottom"

>

HREF="x1258.html"

ACCESSKEY="N"

>Next >>>

>

>

>

>

ALIGN="LEFT"

WIDTH="100%">

>

CLASS="SECT1"

>

CLASS="SECT1"

>

NAME="SEC-THEALIGNMENTWIDGET"

>The Alignment widget

>

>

>The alignment widget allows you to place a widget within its window at

a position and size relative to the size of the Alignment widget

itself. For example, it can be very useful for centering a widget

within the window.

>

>There are only two functions associated with the Alignment widget:

>

BORDER="0"

BGCOLOR="#E0E0E0"

WIDTH="100%"

>

>

>

CLASS="PROGRAMLISTING"

>GtkWidget* gtk_alignment_new( gfloat xalign,

                              gfloat yalign,

                              gfloat xscale,

                              gfloat yscale );

void gtk_alignment_set( GtkAlignment *alignment,

                        gfloat        xalign,

                        gfloat        yalign,

                        gfloat        xscale,

                        gfloat        yscale );

>

>

>

>

>The first function creates a new Alignment widget with the specified

parameters. The second function allows the alignment parameters of an

exisiting Alignment widget to be altered.

>

>All four alignment parameters are floating point numbers which can

range from 0.0 to 1.0. The 

CLASS="LITERAL"

>xalign

> and 

CLASS="LITERAL"

>yalign

> arguments

affect the position of the widget placed within the Alignment

widget. The 

CLASS="LITERAL"

>xscale

> and 

CLASS="LITERAL"

>yscale

> arguments affect the amount of

space allocated to the widget.

>

>A child widget can be added to this Alignment widget using:

>

BORDER="0"

BGCOLOR="#E0E0E0"

WIDTH="100%"

>

>

>

CLASS="PROGRAMLISTING"

>    gtk_container_add (GTK_CONTAINER (alignment), child_widget);

>

>

>

>

>For an example of using an Alignment widget, refer to the example for

the 

HREF="x829.html"

>Progress Bar

> widget.

>

>

CLASS="NAVFOOTER"

>

ALIGN="LEFT"

WIDTH="100%">

SUMMARY="Footer navigation table"

WIDTH="100%"

BORDER="0"

CELLPADDING="0"

CELLSPACING="0"

>

>

WIDTH="33%"

ALIGN="left"

VALIGN="top"

>

HREF="c1226.html"

ACCESSKEY="P"

><<< Previous

>

>

WIDTH="34%"

ALIGN="center"

VALIGN="top"

>

HREF="book1.html"

ACCESSKEY="H"

>Home

>

>

WIDTH="33%"

ALIGN="right"

VALIGN="top"

>

HREF="x1258.html"

ACCESSKEY="N"

>Next >>>

>

>

>

>

WIDTH="33%"

ALIGN="left"

VALIGN="top"

>Container Widgets

>

WIDTH="34%"

ALIGN="center"

VALIGN="top"

>

HREF="c1226.html"

ACCESSKEY="U"

>Up

>

>

WIDTH="33%"

ALIGN="right"

VALIGN="top"

>Fixed Container

>

>

>

>

>

>