>

>

>Fixed Container

>

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="The Alignment widget"

HREF="x1243.html">

REL="NEXT"

TITLE="Layout Container"

HREF="x1279.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="x1243.html"

ACCESSKEY="P"

><<< Previous

>

>

WIDTH="80%"

ALIGN="center"

VALIGN="bottom"

>Container Widgets

>

WIDTH="10%"

ALIGN="right"

VALIGN="bottom"

>

HREF="x1279.html"

ACCESSKEY="N"

>Next >>>

>

>

>

>

ALIGN="LEFT"

WIDTH="100%">

>

CLASS="SECT1"

>

CLASS="SECT1"

>

NAME="SEC-FIXEDCONTAINER"

>Fixed Container

>

>

>The Fixed container allows you to place widgets at a fixed position

within it's window, relative to it's upper left hand corner. The

position of the widgets can be changed dynamically.

>

>There are only a few functions associated with the fixed widget:

>

BORDER="0"

BGCOLOR="#E0E0E0"

WIDTH="100%"

>

>

>

CLASS="PROGRAMLISTING"

>GtkWidget* gtk_fixed_new( void );

void gtk_fixed_put( GtkFixed  *fixed,

                    GtkWidget *widget,

                    gint       x,

                    gint       y );

void gtk_fixed_move( GtkFixed  *fixed,

                     GtkWidget *widget,

                     gint       x,

                     gint       y );

>

>

>

>

>The function gtk_fixed_new() allows you to create a new Fixed

container.

>

>gtk_fixed_put() places 

CLASS="LITERAL"

>widget

> in the container 

CLASS="LITERAL"

>fixed

> at

the position specified by 

CLASS="LITERAL"

>x

> and 

CLASS="LITERAL"

>y

>.

>

>gtk_fixed_move() allows the specified widget to be moved to a new

position.

>

BORDER="0"

BGCOLOR="#E0E0E0"

WIDTH="100%"

>

>

>

CLASS="PROGRAMLISTING"

>void gtk_fixed_set_has_window( GtkFixed  *fixed,

                               gboolean   has_window );

gboolean gtk_fixed_get_has_window( GtkFixed *fixed );

>

>

>

>

>Normally, Fixed widgets don't have their own X window. Since this is

different from the behaviour of Fixed widgets in earlier releases of GTK, 

the function gtk_fixed_set_has_window() allows the creation of Fixed widgets 

CLASS="EMPHASIS"

>with

> their own window. It has to be called before

realizing the widget.

>

>The following example illustrates how to use the Fixed Container.

>

>

CLASS="INLINEMEDIAOBJECT"

>

SRC="images/fixed.png">

>

>

BORDER="0"

BGCOLOR="#E0E0E0"

WIDTH="100%"

>

>

>

CLASS="PROGRAMLISTING"

>
#include <gtk/gtk.h>

/* I'm going to be lazy and use some global variables to

 * store the position of the widget within the fixed

 * container */

gint x = 50;

gint y = 50;

/* This callback function moves the button to a new position

 * in the Fixed container. */

static void move_button( GtkWidget *widget,

                         GtkWidget *fixed )

{

  x = (x + 30) % 300;

  y = (y + 50) % 300;

  gtk_fixed_move (GTK_FIXED (fixed), widget, x, y); 

}

int main( int   argc,

          char *argv[] )

{

  /* GtkWidget is the storage type for widgets */

  GtkWidget *window;

  GtkWidget *fixed;

  GtkWidget *button;

  gint i;

  /* Initialise GTK */

  gtk_init (&argc, &argv);

  /* Create a new window */

  window = gtk_window_new (GTK_WINDOW_TOPLEVEL);

  gtk_window_set_title (GTK_WINDOW (window), "Fixed Container");

  /* Here we connect the "destroy" event to a signal handler */ 

  g_signal_connect (window, "destroy",

		    G_CALLBACK (gtk_main_quit), NULL);

  /* Sets the border width of the window. */

  gtk_container_set_border_width (GTK_CONTAINER (window), 10);

  /* Create a Fixed Container */

  fixed = gtk_fixed_new ();

  gtk_container_add (GTK_CONTAINER (window), fixed);

  gtk_widget_show (fixed);

  for (i = 1 ; i <= 3 ; i++) {

    /* Creates a new button with the label "Press me" */

    button = gtk_button_new_with_label ("Press me");

    /* When the button receives the "clicked" signal, it will call the

     * function move_button() passing it the Fixed Container as its

     * argument. */

    g_signal_connect (button, "clicked",

		      G_CALLBACK (move_button), (gpointer) fixed);

    /* This packs the button into the fixed containers window. */

    gtk_fixed_put (GTK_FIXED (fixed), button, i*50, i*50);

    /* The final step is to display this newly created widget. */

    gtk_widget_show (button);

  }

  /* Display the window */

  gtk_widget_show (window);

  /* Enter the event loop */

  gtk_main ();

  return 0;

}

>

>

>

>

>

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="x1243.html"

ACCESSKEY="P"

><<< Previous

>

>

WIDTH="34%"

ALIGN="center"

VALIGN="top"

>

HREF="book1.html"

ACCESSKEY="H"

>Home

>

>

WIDTH="33%"

ALIGN="right"

VALIGN="top"

>

HREF="x1279.html"

ACCESSKEY="N"

>Next >>>

>

>

>

>

WIDTH="33%"

ALIGN="left"

VALIGN="top"

>The Alignment widget

>

WIDTH="34%"

ALIGN="center"

VALIGN="top"

>

HREF="c1226.html"

ACCESSKEY="U"

>Up

>

>

WIDTH="33%"

ALIGN="right"

VALIGN="top"

>Layout Container

>

>

>

>

>

>