📄 gtkpaned.html
字号:
<HTML><HEAD><TITLE>GtkPaned</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.61"><LINKREL="HOME"TITLE="GTK+ Reference Manual"HREF="index.html"><LINKREL="UP"TITLE="GTK+ Widgets and Objects"HREF="gtkobjects.html"><LINKREL="PREVIOUS"TITLE="GtkPacker"HREF="gtkpacker.html"><LINKREL="NEXT"TITLE="GtkPixmap"HREF="gtkpixmap.html"></HEAD><BODYCLASS="REFENTRY"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><THCOLSPAN="4"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="5">GTK+ Reference Manual</FONT></TH></TR><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtkpacker.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B><<< Previous Page</B></FONT></A></TD><TDWIDTH="25%"BGCOLOR="#0000C0"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="index.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Home</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#00C000"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Up</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="right"><AHREF="gtkpixmap.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKPANED">GtkPaned</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN35702"></A><H2>Name</H2>GtkPaned -- Base class for widgets with two adjustable panes</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN35705"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtkpaned.html#GTKPANED-STRUCT">GtkPaned</A>;void <AHREF="gtkpaned.html#GTK-PANED-ADD1">gtk_paned_add1</A> (<AHREF="gtkpaned.html">GtkPaned</A> *paned, <AHREF="gtkwidget.html">GtkWidget</A> *child);void <AHREF="gtkpaned.html#GTK-PANED-ADD2">gtk_paned_add2</A> (<AHREF="gtkpaned.html">GtkPaned</A> *paned, <AHREF="gtkwidget.html">GtkWidget</A> *child);#define <AHREF="gtkpaned.html#GTK-PANED-HANDLE-SIZE">gtk_paned_handle_size</A>#define <AHREF="gtkpaned.html#GTK-PANED-GUTTER-SIZE">gtk_paned_gutter_size</A>void <AHREF="gtkpaned.html#GTK-PANED-COMPUTE-POSITION">gtk_paned_compute_position</A> (<AHREF="gtkpaned.html">GtkPaned</A> *paned, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> allocation, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> child1_req, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> child2_req);void <AHREF="gtkpaned.html#GTK-PANED-PACK1">gtk_paned_pack1</A> (<AHREF="gtkpaned.html">GtkPaned</A> *paned, <AHREF="gtkwidget.html">GtkWidget</A> *child, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> resize, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> shrink);void <AHREF="gtkpaned.html#GTK-PANED-PACK2">gtk_paned_pack2</A> (<AHREF="gtkpaned.html">GtkPaned</A> *paned, <AHREF="gtkwidget.html">GtkWidget</A> *child, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> resize, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> shrink);void <AHREF="gtkpaned.html#GTK-PANED-SET-GUTTER-SIZE">gtk_paned_set_gutter_size</A> (<AHREF="gtkpaned.html">GtkPaned</A> *paned, <AHREF=../glib/glib-basic-types.html#GUINT16>guint16</A> size);void <AHREF="gtkpaned.html#GTK-PANED-SET-HANDLE-SIZE">gtk_paned_set_handle_size</A> (<AHREF="gtkpaned.html">GtkPaned</A> *paned, <AHREF=../glib/glib-basic-types.html#GUINT16>guint16</A> size);void <AHREF="gtkpaned.html#GTK-PANED-SET-POSITION">gtk_paned_set_position</A> (<AHREF="gtkpaned.html">GtkPaned</A> *paned, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> position); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN35741"></A><H2>Object Hierarchy</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> <AHREF="gtkobject.html">GtkObject</A> +----<AHREF="gtkwidget.html">GtkWidget</A> +----<AHREF="gtkcontainer.html">GtkContainer</A> +----GtkPaned</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN35747"></A><H2>Description</H2><P>GtkPaned is the base class for widgets with two panes,arranged either horizontally (<AHREF="gtkhpaned.html">GtkHPaned</A>) orvertically (<AHREF="gtkvpaned.html">GtkVPaned</A>). Child widgets are added to the panes of the widget with<AHREF="gtkpaned.html#GTK-PANED-PACK1">gtk_paned_pack1</A>() and <AHREF="gtkpaned.html#GTK-PANED-PACK2">gtk_paned_pack2</A>(). The divisionbeween the two children is set by default from thesize requests of the children, but it can be adjustedby the user.</P><P>A paned widget draws a separator between the twochild widgets and a small handle that the usercan drag to adjust the division. It does notdraw any relief around the children or aroundthe separator. (The space in which the separatoris called the gutter). Often, it is usefulto put each child inside a <AHREF="gtkframe.html">GtkFrame</A> with theshadow type set to <TTCLASS="LITERAL">GTK_SHADOW_IN</TT> so that thegutter appears as a ridge.</P><P>Each child has two options that can be set, <TTCLASS="PARAMETER"><I>resize</I></TT> and <TTCLASS="PARAMETER"><I>shrink</I></TT>. If <TTCLASS="PARAMETER"><I>resize</I></TT> is true, then when the<AHREF="gtkpaned.html">GtkPaned</A> is resized, that child will expandor shrink along with the paned widget. If <TTCLASS="PARAMETER"><I>shrink</I></TT>is true, then when that child can be made smallerthan it's requisition by the user. Setting <TTCLASS="PARAMETER"><I>shrink</I></TT>to FALSE allows the application to set a minimumsize. If <TTCLASS="PARAMETER"><I>resize</I></TT> is false for both children, thenthis is treated as if <TTCLASS="PARAMETER"><I>resize</I></TT> is true for bothchildren.</P><P>The application can set the position of the slideras if it were set by the user, by calling<AHREF="gtkpaned.html#GTK-PANED-SET-POSITION">gtk_paned_set_position</A>().</P><DIVCLASS="EXAMPLE"><ANAME="AEN35768"></A><P><B>Example 1. Creating a paned widget with minimum sizes </B></P><TABLEBORDER="0"BGCOLOR="#D8F8D8"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">GtkWidget *hpaned = <AHREF="gtkhpaned.html#GTK-HPANED-NEW">gtk_hpaned_new</A>();GtkWidget *frame1 = gtk_frame_new(NULL);GtkWidget *frame2 = gtk_frame_new(NULL);gtk_frame_set_shadow_type (GTK_FRAME (frame1), GTK_SHADOW_IN);gtk_frame_set_shadow_type (GTK_FRAME (frame2), GTK_SHADOW_IN);gtk_widget_set_usize (hpaned, 200 + GTK_PANED (hpaned)->gutter_size, -1);gtk_paned_pack1 (GTK_PANED (hpaned), frame1, TRUE, FALSE);gtk_widget_set_usize (frame1, 50, -1);gtk_paned_pack2 (GTK_PANED (hpaned), frame1, FALSE, FALSE);gtk_widget_set_usize (frame1, 50, -1);</PRE></TD></TR></TABLE></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN35772"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN35774"></A><H3><ANAME="GTKPANED-STRUCT"></A>struct GtkPaned</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkPaned { guint16 handle_size; guint16 gutter_size;};</PRE></TD></TR></TABLE><P></P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN35779"></A><H3><ANAME="GTK-PANED-ADD1"></A>gtk_paned_add1 ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_paned_add1 (<AHREF="gtkpaned.html">GtkPaned</A> *paned, <AHREF="gtkwidget.html">GtkWidget</A> *child);</PRE></TD></TR></TABLE><P>Add a child to the top or left pane withdefault parameters. This is equivalentto<TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">gtk_paned_pack1(paned, FALSE, TRUE);</PRE></TD></TR></TABLE></P><DIVCLASS="INFORMALTABLE"><ANAME="AEN35787"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>paned</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a paned widget</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>child</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the child to add </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN35800"></A><H3><ANAME="GTK-PANED-ADD2"></A>gtk_paned_add2 ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_paned_add2 (<AHREF="gtkpaned.html">GtkPaned</A> *paned, <AHREF="gtkwidget.html">GtkWidget</A> *child);</PRE></TD></TR></TABLE><P>Add a child to the bottom or right pane with defaultparameters. This is equivalent to <TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">gtk_paned_pack1(paned, FALSE, FALSE);</PRE></TD></TR></TABLE></P><DIVCLASS="INFORMALTABLE"><ANAME="AEN35808"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>paned</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a paned widget</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>child</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the child to add </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN35821"></A><H3><ANAME="GTK-PANED-HANDLE-SIZE"></A>gtk_paned_handle_size</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">#define gtk_paned_handle_size gtk_paned_set_handle_size</PRE></TD></TR></TABLE><P>Old name for <AHREF="gtkpaned.html#GTK-PANED-SET-HANDLE-SIZE">gtk_paned_set_handle_size</A>()</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN35827"></A><H3><ANAME="GTK-PANED-GUTTER-SIZE"></A>gtk_paned_gutter_size</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">#define gtk_paned_gutter_size gtk_paned_set_gutter_size</PRE></TD></TR></TABLE><P>Old name for <AHREF="gtkpaned.html#GTK-PANED-SET-GUTTER-SIZE">gtk_paned_set_gutter_size</A>()</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN35833"></A><H3><ANAME="GTK-PANED-COMPUTE-POSITION"></A>gtk_paned_compute_position ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -