>

>

>Frames

>

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="Layout Container"

HREF="x1279.html">

REL="NEXT"

TITLE="Aspect Frames"

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

ACCESSKEY="P"

><<< Previous

>

>

WIDTH="80%"

ALIGN="center"

VALIGN="bottom"

>Container Widgets

>

WIDTH="10%"

ALIGN="right"

VALIGN="bottom"

>

HREF="x1317.html"

ACCESSKEY="N"

>Next >>>

>

>

>

>

ALIGN="LEFT"

WIDTH="100%">

>

CLASS="SECT1"

>

CLASS="SECT1"

>

NAME="SEC-FRAMES"

>Frames

>

>

>Frames can be used to enclose one or a group of widgets with a box

which can optionally be labelled. The position of the label and the

style of the box can be altered to suit.

>

>A Frame can be created with the following function:

>

BORDER="0"

BGCOLOR="#E0E0E0"

WIDTH="100%"

>

>

>

CLASS="PROGRAMLISTING"

>GtkWidget *gtk_frame_new( const gchar *label );

>

>

>

>

>The label is by default placed in the upper left hand corner of the

frame. A value of NULL for the 

CLASS="LITERAL"

>label

> argument will result in no

label being displayed. The text of the label can be changed using the

next function.

>

BORDER="0"

BGCOLOR="#E0E0E0"

WIDTH="100%"

>

>

>

CLASS="PROGRAMLISTING"

>void gtk_frame_set_label( GtkFrame    *frame,

                          const gchar *label );

>

>

>

>

>The position of the label can be changed using this function:

>

BORDER="0"

BGCOLOR="#E0E0E0"

WIDTH="100%"

>

>

>

CLASS="PROGRAMLISTING"

>void gtk_frame_set_label_align( GtkFrame *frame,

                                gfloat    xalign,

                                gfloat    yalign );

>

>

>

>

>

CLASS="LITERAL"

>xalign

> and 

CLASS="LITERAL"

>yalign

> take values between 0.0 and 1.0. 

CLASS="LITERAL"

>xalign

>

indicates the position of the label along the top horizontal of the

frame. 

CLASS="LITERAL"

>yalign

> is not currently used. The default value of xalign

is 0.0 which places the label at the left hand end of the frame.

>

>The next function alters the style of the box that is used to outline

the frame.

>

BORDER="0"

BGCOLOR="#E0E0E0"

WIDTH="100%"

>

>

>

CLASS="PROGRAMLISTING"

>void gtk_frame_set_shadow_type( GtkFrame      *frame,

                                GtkShadowType  type);

>

>

>

>

>The 

CLASS="LITERAL"

>type

> argument can take one of the following values:

>

BORDER="0"

BGCOLOR="#E0E0E0"

WIDTH="100%"

>

>

>

CLASS="PROGRAMLISTING"

>  GTK_SHADOW_NONE

  GTK_SHADOW_IN

  GTK_SHADOW_OUT

  GTK_SHADOW_ETCHED_IN (the default)

  GTK_SHADOW_ETCHED_OUT

>

>

>

>

>The following code example illustrates the use of the Frame widget.

>

>

CLASS="INLINEMEDIAOBJECT"

>

SRC="images/frame.png">

>

>

BORDER="0"

BGCOLOR="#E0E0E0"

WIDTH="100%"

>

>

>

CLASS="PROGRAMLISTING"

>
#include <gtk/gtk.h>

int main( int   argc,

          char *argv[] )

{

  /* GtkWidget is the storage type for widgets */

  GtkWidget *window;

  GtkWidget *frame;

  /* Initialise GTK */

  gtk_init (&argc, &argv);

  /* Create a new window */

  window = gtk_window_new (GTK_WINDOW_TOPLEVEL);

  gtk_window_set_title (GTK_WINDOW (window), "Frame Example");

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

  g_signal_connect (window, "destroy",

		    G_CALLBACK (gtk_main_quit), NULL);

  gtk_widget_set_size_request (window, 300, 300);

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

  gtk_container_set_border_width (GTK_CONTAINER (window), 10);

  /* Create a Frame */

  frame = gtk_frame_new (NULL);

  gtk_container_add (GTK_CONTAINER (window), frame);

  /* Set the frame's label */

  gtk_frame_set_label (GTK_FRAME (frame), "GTK Frame Widget");

  /* Align the label at the right of the frame */

  gtk_frame_set_label_align (GTK_FRAME (frame), 1.0, 0.0);

  /* Set the style of the frame */

  gtk_frame_set_shadow_type (GTK_FRAME (frame), GTK_SHADOW_ETCHED_OUT);

  gtk_widget_show (frame);

  /* 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="x1279.html"

ACCESSKEY="P"

><<< Previous

>

>

WIDTH="34%"

ALIGN="center"

VALIGN="top"

>

HREF="book1.html"

ACCESSKEY="H"

>Home

>

>

WIDTH="33%"

ALIGN="right"

VALIGN="top"

>

HREF="x1317.html"

ACCESSKEY="N"

>Next >>>

>

>

>

>

WIDTH="33%"

ALIGN="left"

VALIGN="top"

>Layout Container

>

WIDTH="34%"

ALIGN="center"

VALIGN="top"

>

HREF="c1226.html"

ACCESSKEY="U"

>Up

>

>

WIDTH="33%"

ALIGN="right"

VALIGN="top"

>Aspect Frames

>

>

>

>

>

>