<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >Fixed Container</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" TITLE="GTK+ 2.0 Tutorial" HREF="book1.html"><LINK REL="UP" TITLE="Container Widgets" HREF="c1226.html"><LINK REL="PREVIOUS" TITLE="The Alignment widget" HREF="x1243.html"><LINK REL="NEXT" TITLE="Layout Container" HREF="x1279.html"></HEAD ><BODY CLASS="SECT1" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >GTK+ 2.0 Tutorial</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="x1243.html" ACCESSKEY="P" ><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" >Container Widgets</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="x1279.html" ACCESSKEY="N" >Next >>></A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A NAME="SEC-FIXEDCONTAINER" >Fixed Container</A ></H1 ><P >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.</P ><P >There are only a few functions associated with the fixed widget:</P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><PRE 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 );</PRE ></TD ></TR ></TABLE ><P >The function gtk_fixed_new() allows you to create a new Fixed container.</P ><P >gtk_fixed_put() places <TT CLASS="LITERAL" >widget</TT > in the container <TT CLASS="LITERAL" >fixed</TT > at the position specified by <TT CLASS="LITERAL" >x</TT > and <TT CLASS="LITERAL" >y</TT >.</P ><P >gtk_fixed_move() allows the specified widget to be moved to a new position.</P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gtk_fixed_set_has_window( GtkFixed *fixed, gboolean has_window ); gboolean gtk_fixed_get_has_window( GtkFixed *fixed );</PRE ></TD ></TR ></TABLE ><P >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 <I CLASS="EMPHASIS" >with</I > their own window. It has to be called before realizing the widget.</P ><P >The following example illustrates how to use the Fixed Container.</P ><P ><SPAN CLASS="INLINEMEDIAOBJECT" ><IMG SRC="images/fixed.png"></SPAN ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><PRE 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; }</PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="x1243.html" ACCESSKEY="P" ><<< Previous</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="book1.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="x1279.html" ACCESSKEY="N" >Next >>></A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >The Alignment widget</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="c1226.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Layout Container</TD ></TR ></TABLE ></DIV ></BODY ></HTML >