📄 sec-scrolledwindows.html

📁 gtk的教材和问答集
💻 HTML
字号:
<HTML><HEAD><TITLE>Scrolled Windows</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.49"><LINKREL="HOME"TITLE="GTK+ 1.2 Tutorial"HREF="gtk-tut.html"><LINKREL="UP"TITLE="Container Widgets"HREF="ch-containerwidgets.html"><LINKREL="PREVIOUS"TITLE="Viewports"HREF="sec-viewports.html"><LINKREL="NEXT"TITLE="Button Boxes"HREF="sec-buttonboxes.html"></HEAD></head><body bgcolor="#FFFFFF" marginheight=0 marginwidth=0 width="100%"><table cellspacing=6 border=0 cellpadding=0 width="100%">  <tr>    <td bgcolor="#FFFFFF" valign=top nowrap>    <centeR><A HREF="/"><img src="/images/gtk-logo-rgb.gif" width=107 height=140 border=0></A>      <font face="helvetica,lucidia" color="#000000"><BR><BR><b>GTK+<BR>The GIMP Toolkit</b></center><BR><table width=100% cellspacing=0 cellpadding=2 border=0><tr><td bgcolor="#000000"><table width=100% cellspacing=0 cellpadding=4 border=0><tr><td bgcolor="#AAAAEE" nowrap><B>General</B></td></tr><tr><td bgcolor="#FFFFFF" nowrap><A HREF="/">Introduction</A><BR><A HREF="/screenshots/">Screenshots</A><br><A HREF="/download/">Download</A><br><A HREF="/mailinglists.html">Mailing Lists</A><BR><A HREF="/bindings.html">Language Bindings</A><BR><A HREF="http://gtk.themes.org/">Themes</A><BR><A HREF="/bugs.html">Bug Tracker</A><BR></td></tr></table></td></tr></table><BR>  <table width=100% cellspacing=0 cellpadding=2 border=0><tr><td bgcolor="#000000"><table width=100% cellspacing=0 cellpadding=4 border=0><tr><td bgcolor="#AAAAEE" nowrap><B>Documentation</B></td></tr><tr><td bgcolor="#FFFFFF" nowrap><A HREF="/faq/">FAQ</A><br><A HREF="/tutorial/">Tutorial</A><BR><A HREF="/api/">API Reference</A><br><A HREF="/books.html">Published Books</A><BR></td></tr></table></td></tr></table><BR>  <table width=100% cellspacing=0 cellpadding=2 border=0><tr><td bgcolor="#000000"><table width=100% cellspacing=0 cellpadding=4 border=0><tr><td bgcolor="#AAAAEE" nowrap><B>Projects</B></td></tr><tr><td bgcolor="#FFFFFF" nowrap><A HREF="http://www.pango.org/">Pango</A><BR><A HREF="http://sources.redhat.com/inti/">Inti</A><BR><A HREF="http://www.gnome.org/">GNOME</A><BR><A HREF="http://user.sgic.fi/~tml/gimp/win32/">GTK+ for Win32</A><br><A HREF="http://people.redhat.com/sopwith/gtkfb/">GtkFB (Framebuffer)</A><br><A HREF="http://www.directfb.org/gtk.xml">GTK+ on DirectFB</A><BR><A HREF="/beos/">GTK+ for BeOS</A></td></tr></table></td></tr></table><BR>  <table width=100% cellspacing=0 cellpadding=2 border=0><tr><td bgcolor="#000000"><table width=100% cellspacing=0 cellpadding=4 border=0><tr><td bgcolor="#AAAAEE" nowrap><B><B>Applications</B></B></td></tr><tr><td bgcolor="#FFFFFF" nowrap><A HREF="http://www.gimp.org/">GIMP</A><BR><A HREF="http://www.abiword.org/">Abiword</A><BR><A HREF="http://www.lysator.liu.se/~alla/dia/dia.html">Dia</A><BR><A HREF="http://glade.pn.org/">Glade</A><BR><A HREF="http://www.gnucash.org/">GnuCash</A><BR><A HREF="http://www.gnome.org/projects/gnumeric/">Gnumeric</A><BR><BR><A HREF="http://www.gnome.org/applist/">GNOME Software Map</A><br></td></tr></table></td></tr></table><BR>      </td>  <td bgcolor="#ffffff" valign=top width="99%"><font face="lucida,helvetica"><BODYCLASS="SECT1"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLEWIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><THCOLSPAN="3"ALIGN="center">GTK+ 1.2 Tutorial</TH></TR><TR><TDWIDTH="10%"ALIGN="left"VALIGN="bottom"><AHREF="sec-viewports.html">&#60;&#60;&#60; Previous</A></TD><TDWIDTH="80%"ALIGN="center"VALIGN="bottom">Chapter 10. Container Widgets</TD><TDWIDTH="10%"ALIGN="right"VALIGN="bottom"><AHREF="sec-buttonboxes.html">Next &#62;&#62;&#62;</A></TD></TR></TABLE><HRALIGN="LEFT"WIDTH="100%"></DIV><DIVCLASS="SECT1"><H1CLASS="SECT1"><ANAME="SEC-SCROLLEDWINDOWS">10.9. Scrolled Windows</A></H1><P>Scrolled windows are used to create a scrollable area with anotherwidget inside it. You may insert any type of widget into a scrolledwindow, and it will be accessible regardless of the size by using thescrollbars.</P><P>The following function is used to create a new scrolled window.</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">GtkWidget *gtk_scrolled_window_new( GtkAdjustment *hadjustment,                                    GtkAdjustment *vadjustment );</PRE></TD></TR></TABLE><P>Where the first argument is the adjustment for the horizontaldirection, and the second, the adjustment for the vertical direction.These are almost always set to NULL.</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_scrolled_window_set_policy( GtkScrolledWindow *scrolled_window,                                     GtkPolicyType      hscrollbar_policy,                                     GtkPolicyType      vscrollbar_policy );</PRE></TD></TR></TABLE><P>This sets the policy to be used with respect to the scrollbars.The first argument is the scrolled window you wish to change. The secondsets the policy for the horizontal scrollbar, and the third the policy for the vertical scrollbar.</P><P>The policy may be one of <TTCLASS="LITERAL">GTK_POLICY_AUTOMATIC</TT> or<TTCLASS="LITERAL">GTK_POLICY_ALWAYS</TT>. <TTCLASS="LITERAL">GTK_POLICY_AUTOMATIC</TT> will automaticallydecide whether you need scrollbars, whereas <TTCLASS="LITERAL">GTK_POLICY_ALWAYS</TT>will always leave the scrollbars there.</P><P>You can then place your object into the scrolled window using thefollowing function.</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_scrolled_window_add_with_viewport( GtkScrolledWindow *scrolled_window,                                            GtkWidget         *child);</PRE></TD></TR></TABLE><P>Here is a simple example that packs a table eith 100 toggle buttonsinto a scrolled window. I've only commented on the parts that may benew to you.</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">/* example-start scrolledwin scrolledwin.c */#include &#60;stdio.h&#62;#include &#60;gtk/gtk.h&#62;void destroy( GtkWidget *widget,              gpointer   data ){    gtk_main_quit();}int main( int   argc,          char *argv[] ){    static GtkWidget *window;    GtkWidget *scrolled_window;    GtkWidget *table;    GtkWidget *button;    char buffer[32];    int i, j;        gtk_init (&#38;argc, &#38;argv);        /* Create a new dialog window for the scrolled window to be     * packed into.  */    window = gtk_dialog_new ();    gtk_signal_connect (GTK_OBJECT (window), "destroy",			(GtkSignalFunc) destroy, NULL);    gtk_window_set_title (GTK_WINDOW (window), "GtkScrolledWindow example");    gtk_container_set_border_width (GTK_CONTAINER (window), 0);    gtk_widget_set_usize(window, 300, 300);        /* create a new scrolled window. */    scrolled_window = gtk_scrolled_window_new (NULL, NULL);        gtk_container_set_border_width (GTK_CONTAINER (scrolled_window), 10);        /* the policy is one of GTK_POLICY AUTOMATIC, or GTK_POLICY_ALWAYS.     * GTK_POLICY_AUTOMATIC will automatically decide whether you need     * scrollbars, whereas GTK_POLICY_ALWAYS will always leave the scrollbars     * there.  The first one is the horizontal scrollbar, the second,      * the vertical. */    gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_window),                                    GTK_POLICY_AUTOMATIC, GTK_POLICY_ALWAYS);    /* The dialog window is created with a vbox packed into it. */								    gtk_box_pack_start (GTK_BOX (GTK_DIALOG(window)-&#62;vbox), scrolled_window, 			TRUE, TRUE, 0);    gtk_widget_show (scrolled_window);        /* create a table of 10 by 10 squares. */    table = gtk_table_new (10, 10, FALSE);        /* set the spacing to 10 on x and 10 on y */    gtk_table_set_row_spacings (GTK_TABLE (table), 10);    gtk_table_set_col_spacings (GTK_TABLE (table), 10);        /* pack the table into the scrolled window */    gtk_scrolled_window_add_with_viewport (                   GTK_SCROLLED_WINDOW (scrolled_window), table);    gtk_widget_show (table);        /* this simply creates a grid of toggle buttons on the table     * to demonstrate the scrolled window. */    for (i = 0; i &#60; 10; i++)       for (j = 0; j &#60; 10; j++) {          sprintf (buffer, "button (%d,%d)\n", i, j);	  button = gtk_toggle_button_new_with_label (buffer);	  gtk_table_attach_defaults (GTK_TABLE (table), button,	                             i, i+1, j, j+1);          gtk_widget_show (button);       }        /* Add a "close" button to the bottom of the dialog */    button = gtk_button_new_with_label ("close");    gtk_signal_connect_object (GTK_OBJECT (button), "clicked",			       (GtkSignalFunc) gtk_widget_destroy,			       GTK_OBJECT (window));        /* this makes it so the button is the default. */        GTK_WIDGET_SET_FLAGS (button, GTK_CAN_DEFAULT);    gtk_box_pack_start (GTK_BOX (GTK_DIALOG (window)-&#62;action_area), button, TRUE, TRUE, 0);        /* This grabs this button to be the default button. Simply hitting     * the "Enter" key will cause this button to activate. */    gtk_widget_grab_default (button);    gtk_widget_show (button);        gtk_widget_show (window);        gtk_main();        return(0);}/* example-end */</PRE></TD></TR></TABLE><P>Try playing with resizing the window. You'll notice how the scrollbarsreact. You may also wish to use the gtk_widget_set_usize() call to setthe default size of the window or other widgets.</P></DIV><DIVCLASS="NAVFOOTER"><HRALIGN="LEFT"WIDTH="100%"><TABLEWIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top"><AHREF="sec-viewports.html">&#60;&#60;&#60; Previous</A></TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="gtk-tut.html">Home</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top"><AHREF="sec-buttonboxes.html">Next &#62;&#62;&#62;</A></TD></TR><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top">Viewports</TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="ch-containerwidgets.html">Up</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top">Button Boxes</TD></TR></TABLE></DIV>        </td>    </tr></table>  </td>  </tr></table></body></BODY></HTML>
⌨️ 快捷键说明

复制代码 Ctrl + C
搜索代码 Ctrl + F
全屏模式 F11
切换主题 Ctrl + Shift + D
显示快捷键 ?
增大字号 Ctrl + =
减小字号 Ctrl + -