<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >Frames</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="Layout Container" HREF="x1279.html"><LINK REL="NEXT" TITLE="Aspect Frames" HREF="x1317.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="x1279.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="x1317.html" ACCESSKEY="N" >Next >>></A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A NAME="SEC-FRAMES" >Frames</A ></H1 ><P >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.</P ><P >A Frame can be created with the following function:</P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >GtkWidget *gtk_frame_new( const gchar *label );</PRE ></TD ></TR ></TABLE ><P >The label is by default placed in the upper left hand corner of the frame. A value of NULL for the <TT CLASS="LITERAL" >label</TT > argument will result in no label being displayed. The text of the label can be changed using the next function.</P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gtk_frame_set_label( GtkFrame *frame, const gchar *label );</PRE ></TD ></TR ></TABLE ><P >The position of the label can be changed using this function:</P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gtk_frame_set_label_align( GtkFrame *frame, gfloat xalign, gfloat yalign );</PRE ></TD ></TR ></TABLE ><P ><TT CLASS="LITERAL" >xalign</TT > and <TT CLASS="LITERAL" >yalign</TT > take values between 0.0 and 1.0. <TT CLASS="LITERAL" >xalign</TT > indicates the position of the label along the top horizontal of the frame. <TT CLASS="LITERAL" >yalign</TT > is not currently used. The default value of xalign is 0.0 which places the label at the left hand end of the frame.</P ><P >The next function alters the style of the box that is used to outline the frame.</P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gtk_frame_set_shadow_type( GtkFrame *frame, GtkShadowType type);</PRE ></TD ></TR ></TABLE ><P >The <TT CLASS="LITERAL" >type</TT > argument can take one of the following values:</P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" > GTK_SHADOW_NONE GTK_SHADOW_IN GTK_SHADOW_OUT GTK_SHADOW_ETCHED_IN (the default) GTK_SHADOW_ETCHED_OUT</PRE ></TD ></TR ></TABLE ><P >The following code example illustrates the use of the Frame widget.</P ><P ><SPAN CLASS="INLINEMEDIAOBJECT" ><IMG SRC="images/frame.png"></SPAN ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" ><TR ><TD ><PRE 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; }</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="x1279.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="x1317.html" ACCESSKEY="N" >Next >>></A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >Layout Container</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="c1226.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Aspect Frames</TD ></TR ></TABLE ></DIV ></BODY ></HTML >