📄 gtktoolbar.html
字号:
<HTML><HEAD><TITLE>GtkToolbar</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="GtkToggleButton"HREF="gtktogglebutton.html"><LINKREL="NEXT"TITLE="GtkTooltips"HREF="gtktooltips.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="gtktogglebutton.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="gtktooltips.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKTOOLBAR">GtkToolbar</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN41669"></A><H2>Name</H2>GtkToolbar -- create bars of buttons and other widgets.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN41672"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtktoolbar.html#GTKTOOLBAR-STRUCT">GtkToolbar</A>;enum <AHREF="gtktoolbar.html#GTKTOOLBARCHILDTYPE">GtkToolbarChildType</A>;enum <AHREF="gtktoolbar.html#GTKTOOLBARSPACESTYLE">GtkToolbarSpaceStyle</A>;struct <AHREF="gtktoolbar.html#GTKTOOLBARCHILD">GtkToolbarChild</A>;<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtktoolbar.html#GTK-TOOLBAR-NEW">gtk_toolbar_new</A> (<AHREF="gtk-standard-enumerations.html#GTKORIENTATION">GtkOrientation</A> orientation, <AHREF="gtk-standard-enumerations.html#GTKTOOLBARSTYLE">GtkToolbarStyle</A> style);<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtktoolbar.html#GTK-TOOLBAR-APPEND-ITEM">gtk_toolbar_append_item</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, const char *text, const char *tooltip_text, const char *tooltip_private_text, <AHREF="gtkwidget.html">GtkWidget</A> *icon, <AHREF="gtk-types.html#GTKSIGNALFUNC">GtkSignalFunc</A> callback, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtktoolbar.html#GTK-TOOLBAR-PREPEND-ITEM">gtk_toolbar_prepend_item</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, const char *text, const char *tooltip_text, const char *tooltip_private_text, <AHREF="gtkwidget.html">GtkWidget</A> *icon, <AHREF="gtk-types.html#GTKSIGNALFUNC">GtkSignalFunc</A> callback, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtktoolbar.html#GTK-TOOLBAR-INSERT-ITEM">gtk_toolbar_insert_item</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, const char *text, const char *tooltip_text, const char *tooltip_private_text, <AHREF="gtkwidget.html">GtkWidget</A> *icon, <AHREF="gtk-types.html#GTKSIGNALFUNC">GtkSignalFunc</A> callback, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> position);void <AHREF="gtktoolbar.html#GTK-TOOLBAR-APPEND-SPACE">gtk_toolbar_append_space</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar);void <AHREF="gtktoolbar.html#GTK-TOOLBAR-PREPEND-SPACE">gtk_toolbar_prepend_space</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar);void <AHREF="gtktoolbar.html#GTK-TOOLBAR-INSERT-SPACE">gtk_toolbar_insert_space</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> position);<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtktoolbar.html#GTK-TOOLBAR-APPEND-ELEMENT">gtk_toolbar_append_element</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF="gtktoolbar.html#GTKTOOLBARCHILDTYPE">GtkToolbarChildType</A> type, <AHREF="gtkwidget.html">GtkWidget</A> *widget, const char *text, const char *tooltip_text, const char *tooltip_private_text, <AHREF="gtkwidget.html">GtkWidget</A> *icon, <AHREF="gtk-types.html#GTKSIGNALFUNC">GtkSignalFunc</A> callback, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtktoolbar.html#GTK-TOOLBAR-PREPEND-ELEMENT">gtk_toolbar_prepend_element</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF="gtktoolbar.html#GTKTOOLBARCHILDTYPE">GtkToolbarChildType</A> type, <AHREF="gtkwidget.html">GtkWidget</A> *widget, const char *text, const char *tooltip_text, const char *tooltip_private_text, <AHREF="gtkwidget.html">GtkWidget</A> *icon, <AHREF="gtk-types.html#GTKSIGNALFUNC">GtkSignalFunc</A> callback, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtktoolbar.html#GTK-TOOLBAR-INSERT-ELEMENT">gtk_toolbar_insert_element</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF="gtktoolbar.html#GTKTOOLBARCHILDTYPE">GtkToolbarChildType</A> type, <AHREF="gtkwidget.html">GtkWidget</A> *widget, const char *text, const char *tooltip_text, const char *tooltip_private_text, <AHREF="gtkwidget.html">GtkWidget</A> *icon, <AHREF="gtk-types.html#GTKSIGNALFUNC">GtkSignalFunc</A> callback, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> position);void <AHREF="gtktoolbar.html#GTK-TOOLBAR-APPEND-WIDGET">gtk_toolbar_append_widget</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF="gtkwidget.html">GtkWidget</A> *widget, const char *tooltip_text, const char *tooltip_private_text);void <AHREF="gtktoolbar.html#GTK-TOOLBAR-PREPEND-WIDGET">gtk_toolbar_prepend_widget</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF="gtkwidget.html">GtkWidget</A> *widget, const char *tooltip_text, const char *tooltip_private_text);void <AHREF="gtktoolbar.html#GTK-TOOLBAR-INSERT-WIDGET">gtk_toolbar_insert_widget</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF="gtkwidget.html">GtkWidget</A> *widget, const char *tooltip_text, const char *tooltip_private_text, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> position);void <AHREF="gtktoolbar.html#GTK-TOOLBAR-SET-ORIENTATION">gtk_toolbar_set_orientation</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF="gtk-standard-enumerations.html#GTKORIENTATION">GtkOrientation</A> orientation);void <AHREF="gtktoolbar.html#GTK-TOOLBAR-SET-STYLE">gtk_toolbar_set_style</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF="gtk-standard-enumerations.html#GTKTOOLBARSTYLE">GtkToolbarStyle</A> style);void <AHREF="gtktoolbar.html#GTK-TOOLBAR-SET-SPACE-SIZE">gtk_toolbar_set_space_size</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> space_size);void <AHREF="gtktoolbar.html#GTK-TOOLBAR-SET-SPACE-STYLE">gtk_toolbar_set_space_style</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF="gtktoolbar.html#GTKTOOLBARSPACESTYLE">GtkToolbarSpaceStyle</A> space_style);void <AHREF="gtktoolbar.html#GTK-TOOLBAR-SET-TOOLTIPS">gtk_toolbar_set_tooltips</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> enable);void <AHREF="gtktoolbar.html#GTK-TOOLBAR-SET-BUTTON-RELIEF">gtk_toolbar_set_button_relief</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF="gtk-standard-enumerations.html#GTKRELIEFSTYLE">GtkReliefStyle</A> relief);<AHREF="gtk-standard-enumerations.html#GTKRELIEFSTYLE">GtkReliefStyle</A> <AHREF="gtktoolbar.html#GTK-TOOLBAR-GET-BUTTON-RELIEF">gtk_toolbar_get_button_relief</A> (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN41765"></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> +----GtkToolbar</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN41771"></A><H2>Signal Prototypes</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtktoolbar.html#GTKTOOLBAR-ORIENTATION-CHANGED">orientation-changed</A>" void user_function (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF="gtk-standard-enumerations.html#GTKORIENTATION">GtkOrientation</A> orientation, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtktoolbar.html#GTKTOOLBAR-STYLE-CHANGED">style-changed</A>" void user_function (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, <AHREF="gtk-standard-enumerations.html#GTKTOOLBARSTYLE">GtkToolbarStyle</A> style, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN41782"></A><H2>Description</H2><P>A toolbar is created with a call to <AHREF="gtktoolbar.html#GTK-TOOLBAR-NEW">gtk_toolbar_new</A>().</P><P>Buttons with text and/or images are added with <AHREF="gtktoolbar.html#GTK-TOOLBAR-APPEND-ITEM">gtk_toolbar_append_item</A>(), <AHREF="gtktoolbar.html#GTK-TOOLBAR-PREPEND-ITEM">gtk_toolbar_prepend_item</A>(), and <AHREF="gtktoolbar.html#GTK-TOOLBAR-INSERT-ITEM">gtk_toolbar_insert_item</A>().</P><P>Any of <AHREF="gtktogglebutton.html">GtkToggleButton</A>, <AHREF="gtkradiobutton.html">GtkRadioButton</A>, or an arbitrary widget can be added to the toolbar with <AHREF="gtktoolbar.html#GTK-TOOLBAR-APPEND-ELEMENT">gtk_toolbar_append_element</A>(), <AHREF="gtktoolbar.html#GTK-TOOLBAR-PREPEND-ELEMENT">gtk_toolbar_prepend_element</A>(), and <AHREF="gtktoolbar.html#GTK-TOOLBAR-INSERT-ELEMENT">gtk_toolbar_insert_element</A>().</P><P>Widgets can be visibily grouped by adding gaps between widgets using <AHREF="gtktoolbar.html#GTK-TOOLBAR-APPEND-SPACE">gtk_toolbar_append_space</A>(), gtk_toolbar_prepend_space, and <AHREF="gtktoolbar.html#GTK-TOOLBAR-INSERT-SPACE">gtk_toolbar_insert_space</A>().</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN41799"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN41801"></A><H3><ANAME="GTKTOOLBAR-STRUCT"></A>struct GtkToolbar</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkToolbar;</PRE></TD></TR></TABLE><P><TTCLASS="STRUCTFIELD"><I>num_children</I></TT> is an integer specifying how many toolbar items the <AHREF="gtktoolbar.html">GtkToolbar</A> contains. <TTCLASS="STRUCTFIELD"><I>children</I></TT> is a <AHREF=../glib/glib-doubly-linked-lists.html#GLIST>GList</A> of the child widgets of the toolbar.</P><P><TTCLASS="STRUCTFIELD"><I>orientation</I></TT></P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN41812"></A><H3><ANAME="GTKTOOLBARCHILDTYPE"></A>enum GtkToolbarChildType</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">typedef enum{ GTK_TOOLBAR_CHILD_SPACE, GTK_TOOLBAR_CHILD_BUTTON, GTK_TOOLBAR_CHILD_TOGGLEBUTTON, GTK_TOOLBAR_CHILD_RADIOBUTTON, GTK_TOOLBAR_CHILD_WIDGET} GtkToolbarChildType;</PRE></TD></TR></TABLE><P>is used to set the type of new elements that are added to a <AHREF="gtktoolbar.html">GtkToolbar</A>.</P><P>SPACE is just a space in the style of the toolbar's GtkToolbarSpaceStyle. BUTTON denotes a <AHREF="gtkbutton.html">GtkButton</A>. TOGGLEBUTTON denotes a <AHREF="gtktogglebutton.html">GtkToggleButton</A>, RADIOBUTTON denotes a <AHREF="gtkradiobutton.html">GtkRadioButton</A>, and WIDGET denotes a standard <AHREF="gtkwidget.html">GtkWidget</A>.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN41823"></A><H3><ANAME="GTKTOOLBARSPACESTYLE"></A>enum GtkToolbarSpaceStyle</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">typedef enum{ GTK_TOOLBAR_SPACE_EMPTY, GTK_TOOLBAR_SPACE_LINE} GtkToolbarSpaceStyle;</PRE></TD></TR></TABLE><P></P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN41828"></A><H3><ANAME="GTKTOOLBARCHILD"></A>struct GtkToolbarChild</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkToolbarChild{ GtkToolbarChildType type; GtkWidget *widget; GtkWidget *icon; GtkWidget *label;};</PRE></TD></TR></TABLE><P></P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN41833"></A><H3><ANAME="GTK-TOOLBAR-NEW"></A>gtk_toolbar_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_toolbar_new (<AHREF="gtk-standard-enumerations.html#GTKORIENTATION">GtkOrientation</A> orientation, <AHREF="gtk-standard-enumerations.html#GTKTOOLBARSTYLE">GtkToolbarStyle</A> style);</PRE></TD></TR></TABLE><P>creates a new toolbar. </P><DIVCLASS="INFORMALTABLE"><ANAME="AEN41841"></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>orientation</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtk-standard-enumerations.html#GTKORIENTATION">GtkOrientation</A>. It determines whether the toolbar appears horizontally or vertically.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>style</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtk-standard-enumerations.html#GTKTOOLBARSTYLE">GtkToolbarStyle</A>. It determines if the toolbar will contain buttons with just labels, just images, or both.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the newly created toolbar. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN41860"></A><H3><ANAME="GTK-TOOLBAR-APPEND-ITEM"></A>gtk_toolbar_append_item ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_toolbar_append_item (<AHREF="gtktoolbar.html">GtkToolbar</A> *toolbar, const char *text, const char *tooltip_text, const char *tooltip_private_text, <AHREF="gtkwidget.html">GtkWidget</A> *icon, <AHREF="gtk-types.html#GTKSIGNALFUNC">GtkSignalFunc</A> callback, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);</PRE></TD></TR></TABLE><P>adds a new button to the beginning (left or top edges) of the given toolbar.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN41870"></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>toolbar</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtktoolbar.html">GtkToolbar</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>text</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP"⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -