1469 lines
75 KiB
HTML
1469 lines
75 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
<title>GtkToolItem: GTK+ 3 Reference Manual</title>
|
||
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
|
||
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
|
||
<link rel="up" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
|
||
<link rel="prev" href="GtkToolbar.html" title="GtkToolbar">
|
||
<link rel="next" href="GtkToolPalette.html" title="GtkToolPalette">
|
||
<meta name="generator" content="GTK-Doc V1.28 (XML mode)">
|
||
<link rel="stylesheet" href="style.css" type="text/css">
|
||
</head>
|
||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
|
||
<td width="100%" align="left" class="shortcuts">
|
||
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
|
||
<a href="#GtkToolItem.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
||
<a href="#GtkToolItem.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span>
|
||
<a href="#GtkToolItem.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span>
|
||
<a href="#GtkToolItem.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
|
||
<a href="#GtkToolItem.signals" class="shortcut">Signals</a></span>
|
||
</td>
|
||
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
||
<td><a accesskey="u" href="MenusAndCombos.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
||
<td><a accesskey="p" href="GtkToolbar.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
||
<td><a accesskey="n" href="GtkToolPalette.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
|
||
</tr></table>
|
||
<div class="refentry">
|
||
<a name="GtkToolItem"></a><div class="titlepage"></div>
|
||
<div class="refnamediv"><table width="100%"><tr>
|
||
<td valign="top">
|
||
<h2><span class="refentrytitle"><a name="GtkToolItem.top_of_page"></a>GtkToolItem</span></h2>
|
||
<p>GtkToolItem — The base class of widgets that can be added to GtkToolShell</p>
|
||
</td>
|
||
<td class="gallery_image" valign="top" align="right"></td>
|
||
</tr></table></div>
|
||
<div class="refsect1">
|
||
<a name="GtkToolItem.functions"></a><h2>Functions</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="functions_return">
|
||
<col class="functions_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-new" title="gtk_tool_item_new ()">gtk_tool_item_new</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-set-homogeneous" title="gtk_tool_item_set_homogeneous ()">gtk_tool_item_set_homogeneous</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-homogeneous" title="gtk_tool_item_get_homogeneous ()">gtk_tool_item_get_homogeneous</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-set-expand" title="gtk_tool_item_set_expand ()">gtk_tool_item_set_expand</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-expand" title="gtk_tool_item_get_expand ()">gtk_tool_item_get_expand</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-set-tooltip-text" title="gtk_tool_item_set_tooltip_text ()">gtk_tool_item_set_tooltip_text</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-set-tooltip-markup" title="gtk_tool_item_set_tooltip_markup ()">gtk_tool_item_set_tooltip_markup</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-set-use-drag-window" title="gtk_tool_item_set_use_drag_window ()">gtk_tool_item_set_use_drag_window</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-use-drag-window" title="gtk_tool_item_get_use_drag_window ()">gtk_tool_item_get_use_drag_window</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-set-visible-horizontal" title="gtk_tool_item_set_visible_horizontal ()">gtk_tool_item_set_visible_horizontal</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-visible-horizontal" title="gtk_tool_item_get_visible_horizontal ()">gtk_tool_item_get_visible_horizontal</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-set-visible-vertical" title="gtk_tool_item_set_visible_vertical ()">gtk_tool_item_set_visible_vertical</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-visible-vertical" title="gtk_tool_item_get_visible_vertical ()">gtk_tool_item_get_visible_vertical</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-set-is-important" title="gtk_tool_item_set_is_important ()">gtk_tool_item_set_is_important</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-is-important" title="gtk_tool_item_get_is_important ()">gtk_tool_item_get_is_important</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">PangoEllipsizeMode</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-ellipsize-mode" title="gtk_tool_item_get_ellipsize_mode ()">gtk_tool_item_get_ellipsize_mode</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="returnvalue">GtkIconSize</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-icon-size" title="gtk_tool_item_get_icon_size ()">gtk_tool_item_get_icon_size</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="returnvalue">GtkOrientation</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-orientation" title="gtk_tool_item_get_orientation ()">gtk_tool_item_get_orientation</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="returnvalue">GtkToolbarStyle</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-toolbar-style" title="gtk_tool_item_get_toolbar_style ()">gtk_tool_item_get_toolbar_style</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gtk3-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="returnvalue">GtkReliefStyle</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-relief-style" title="gtk_tool_item_get_relief_style ()">gtk_tool_item_get_relief_style</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gfloat</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-text-alignment" title="gtk_tool_item_get_text_alignment ()">gtk_tool_item_get_text_alignment</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="returnvalue">GtkOrientation</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-text-orientation" title="gtk_tool_item_get_text_orientation ()">gtk_tool_item_get_text_orientation</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-retrieve-proxy-menu-item" title="gtk_tool_item_retrieve_proxy_menu_item ()">gtk_tool_item_retrieve_proxy_menu_item</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-proxy-menu-item" title="gtk_tool_item_get_proxy_menu_item ()">gtk_tool_item_get_proxy_menu_item</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-set-proxy-menu-item" title="gtk_tool_item_set_proxy_menu_item ()">gtk_tool_item_set_proxy_menu_item</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-rebuild-menu" title="gtk_tool_item_rebuild_menu ()">gtk_tool_item_rebuild_menu</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-toolbar-reconfigured" title="gtk_tool_item_toolbar_reconfigured ()">gtk_tool_item_toolbar_reconfigured</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="returnvalue">GtkSizeGroup</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-get-text-size-group" title="gtk_tool_item_get_text_size_group ()">gtk_tool_item_get_text_size_group</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkToolItem.properties"></a><h2>Properties</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="properties_type">
|
||
<col width="300px" class="properties_name">
|
||
<col width="200px" class="properties_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkToolItem.html#GtkToolItem--is-important" title="The “is-important” property">is-important</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkToolItem.html#GtkToolItem--visible-horizontal" title="The “visible-horizontal” property">visible-horizontal</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkToolItem.html#GtkToolItem--visible-vertical" title="The “visible-vertical” property">visible-vertical</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkToolItem.signals"></a><h2>Signals</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="signals_return">
|
||
<col width="300px" class="signals_name">
|
||
<col width="200px" class="signals_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkToolItem.html#GtkToolItem-create-menu-proxy" title="The “create-menu-proxy” signal">create-menu-proxy</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkToolItem.html#GtkToolItem-toolbar-reconfigured" title="The “toolbar-reconfigured” signal">toolbar-reconfigured</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkToolItem.other"></a><h2>Types and Values</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="name">
|
||
<col class="description">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="datatype_keyword">struct</td>
|
||
<td class="function_name"><a class="link" href="GtkToolItem.html#GtkToolItem-struct" title="struct GtkToolItem">GtkToolItem</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">struct</td>
|
||
<td class="function_name"><a class="link" href="GtkToolItem.html#GtkToolItemClass" title="struct GtkToolItemClass">GtkToolItemClass</a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkToolItem.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
||
<pre class="screen"> GObject
|
||
<span class="lineart">╰──</span> GInitiallyUnowned
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
|
||
<span class="lineart">╰──</span> GtkToolItem
|
||
<span class="lineart">├──</span> <a class="link" href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a>
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem">GtkSeparatorToolItem</a>
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkToolItem.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
|
||
<p>
|
||
GtkToolItem implements
|
||
AtkImplementorIface, <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a> and <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a>.</p>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkToolItem.includes"></a><h2>Includes</h2>
|
||
<pre class="synopsis">#include <gtk/gtk.h>
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkToolItem.description"></a><h2>Description</h2>
|
||
<p><a href="GtkToolItem.html#GtkToolItem-struct"><span class="type">GtkToolItems</span></a> are widgets that can appear on a toolbar. To
|
||
create a toolbar item that contain something else than a button, use
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-new" title="gtk_tool_item_new ()"><code class="function">gtk_tool_item_new()</code></a>. Use <a class="link" href="GtkContainer.html#gtk-container-add" title="gtk_container_add ()"><code class="function">gtk_container_add()</code></a> to add a child
|
||
widget to the tool item.</p>
|
||
<p>For toolbar items that contain buttons, see the <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>,
|
||
<a class="link" href="GtkToggleToolButton.html" title="GtkToggleToolButton"><span class="type">GtkToggleToolButton</span></a> and <a class="link" href="GtkRadioToolButton.html" title="GtkRadioToolButton"><span class="type">GtkRadioToolButton</span></a> classes.</p>
|
||
<p>See the <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> class for a description of the toolbar widget, and
|
||
<a class="link" href="GtkToolShell.html" title="GtkToolShell"><span class="type">GtkToolShell</span></a> for a description of the tool shell interface.</p>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkToolItem.functions_details"></a><h2>Functions</h2>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-new"></a><h3>gtk_tool_item_new ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *
|
||
gtk_tool_item_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
||
<p>Creates a new <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-new.returns"></a><h4>Returns</h4>
|
||
<p> the new <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-set-homogeneous"></a><h3>gtk_tool_item_set_homogeneous ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_tool_item_set_homogeneous (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> homogeneous</code></em>);</pre>
|
||
<p>Sets whether <em class="parameter"><code>tool_item</code></em>
|
||
is to be allocated the same size as other
|
||
homogeneous items. The effect is that all homogeneous items will have
|
||
the same width as the widest of the items.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-set-homogeneous.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>homogeneous</p></td>
|
||
<td class="parameter_description"><p>whether <em class="parameter"><code>tool_item</code></em>
|
||
is the same size as other homogeneous items</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-homogeneous"></a><h3>gtk_tool_item_get_homogeneous ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_tool_item_get_homogeneous (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns whether <em class="parameter"><code>tool_item</code></em>
|
||
is the same size as other homogeneous
|
||
items. See <a class="link" href="GtkToolItem.html#gtk-tool-item-set-homogeneous" title="gtk_tool_item_set_homogeneous ()"><code class="function">gtk_tool_item_set_homogeneous()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-homogeneous.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-homogeneous.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the item is the same size as other homogeneous
|
||
items.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-set-expand"></a><h3>gtk_tool_item_set_expand ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_tool_item_set_expand (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> expand</code></em>);</pre>
|
||
<p>Sets whether <em class="parameter"><code>tool_item</code></em>
|
||
is allocated extra space when there
|
||
is more room on the toolbar then needed for the items. The
|
||
effect is that the item gets bigger when the toolbar gets bigger
|
||
and smaller when the toolbar gets smaller.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-set-expand.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>expand</p></td>
|
||
<td class="parameter_description"><p>Whether <em class="parameter"><code>tool_item</code></em>
|
||
is allocated extra space</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-expand"></a><h3>gtk_tool_item_get_expand ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_tool_item_get_expand (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns whether <em class="parameter"><code>tool_item</code></em>
|
||
is allocated extra space.
|
||
See <a class="link" href="GtkToolItem.html#gtk-tool-item-set-expand" title="gtk_tool_item_set_expand ()"><code class="function">gtk_tool_item_set_expand()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-expand.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-expand.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>tool_item</code></em>
|
||
is allocated extra space.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-set-tooltip-text"></a><h3>gtk_tool_item_set_tooltip_text ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_tool_item_set_tooltip_text (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
|
||
<p>Sets the text to be displayed as tooltip on the item.
|
||
See <a class="link" href="GtkWidget.html#gtk-widget-set-tooltip-text" title="gtk_widget_set_tooltip_text ()"><code class="function">gtk_widget_set_tooltip_text()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-set-tooltip-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>text</p></td>
|
||
<td class="parameter_description"><p>text to be used as tooltip for <em class="parameter"><code>tool_item</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-set-tooltip-markup"></a><h3>gtk_tool_item_set_tooltip_markup ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_tool_item_set_tooltip_markup (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *markup</code></em>);</pre>
|
||
<p>Sets the markup text to be displayed as tooltip on the item.
|
||
See <a class="link" href="GtkWidget.html#gtk-widget-set-tooltip-markup" title="gtk_widget_set_tooltip_markup ()"><code class="function">gtk_widget_set_tooltip_markup()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-set-tooltip-markup.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>markup</p></td>
|
||
<td class="parameter_description"><p>markup text to be used as tooltip for <em class="parameter"><code>tool_item</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-set-use-drag-window"></a><h3>gtk_tool_item_set_use_drag_window ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_tool_item_set_use_drag_window (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> use_drag_window</code></em>);</pre>
|
||
<p>Sets whether <em class="parameter"><code>tool_item</code></em>
|
||
has a drag window. When <code class="literal">TRUE</code> the
|
||
toolitem can be used as a drag source through <a class="link" href="gtk3-Drag-and-Drop.html#gtk-drag-source-set" title="gtk_drag_source_set ()"><code class="function">gtk_drag_source_set()</code></a>.
|
||
When <em class="parameter"><code>tool_item</code></em>
|
||
has a drag window it will intercept all events,
|
||
even those that would otherwise be sent to a child of <em class="parameter"><code>tool_item</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-set-use-drag-window.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>use_drag_window</p></td>
|
||
<td class="parameter_description"><p>Whether <em class="parameter"><code>tool_item</code></em>
|
||
has a drag window.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-use-drag-window"></a><h3>gtk_tool_item_get_use_drag_window ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_tool_item_get_use_drag_window (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns whether <em class="parameter"><code>tool_item</code></em>
|
||
has a drag window. See
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-set-use-drag-window" title="gtk_tool_item_set_use_drag_window ()"><code class="function">gtk_tool_item_set_use_drag_window()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-use-drag-window.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-use-drag-window.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>tool_item</code></em>
|
||
uses a drag window.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-set-visible-horizontal"></a><h3>gtk_tool_item_set_visible_horizontal ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_tool_item_set_visible_horizontal (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> visible_horizontal</code></em>);</pre>
|
||
<p>Sets whether <em class="parameter"><code>tool_item</code></em>
|
||
is visible when the toolbar is docked horizontally.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-set-visible-horizontal.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>visible_horizontal</p></td>
|
||
<td class="parameter_description"><p>Whether <em class="parameter"><code>tool_item</code></em>
|
||
is visible when in horizontal mode</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-visible-horizontal"></a><h3>gtk_tool_item_get_visible_horizontal ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_tool_item_get_visible_horizontal (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns whether the <em class="parameter"><code>tool_item</code></em>
|
||
is visible on toolbars that are
|
||
docked horizontally.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-visible-horizontal.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-visible-horizontal.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>tool_item</code></em>
|
||
is visible on toolbars that are
|
||
docked horizontally.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-set-visible-vertical"></a><h3>gtk_tool_item_set_visible_vertical ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_tool_item_set_visible_vertical (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> visible_vertical</code></em>);</pre>
|
||
<p>Sets whether <em class="parameter"><code>tool_item</code></em>
|
||
is visible when the toolbar is docked
|
||
vertically. Some tool items, such as text entries, are too wide to be
|
||
useful on a vertically docked toolbar. If <em class="parameter"><code>visible_vertical</code></em>
|
||
is <code class="literal">FALSE</code>
|
||
<em class="parameter"><code>tool_item</code></em>
|
||
will not appear on toolbars that are docked vertically.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-set-visible-vertical.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>visible_vertical</p></td>
|
||
<td class="parameter_description"><p>whether <em class="parameter"><code>tool_item</code></em>
|
||
is visible when the toolbar
|
||
is in vertical mode</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-visible-vertical"></a><h3>gtk_tool_item_get_visible_vertical ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_tool_item_get_visible_vertical (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns whether <em class="parameter"><code>tool_item</code></em>
|
||
is visible when the toolbar is docked vertically.
|
||
See <a class="link" href="GtkToolItem.html#gtk-tool-item-set-visible-vertical" title="gtk_tool_item_set_visible_vertical ()"><code class="function">gtk_tool_item_set_visible_vertical()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-visible-vertical.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-visible-vertical.returns"></a><h4>Returns</h4>
|
||
<p> Whether <em class="parameter"><code>tool_item</code></em>
|
||
is visible when the toolbar is docked vertically</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-set-is-important"></a><h3>gtk_tool_item_set_is_important ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_tool_item_set_is_important (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> is_important</code></em>);</pre>
|
||
<p>Sets whether <em class="parameter"><code>tool_item</code></em>
|
||
should be considered important. The <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
|
||
class uses this property to determine whether to show or hide its label
|
||
when the toolbar style is <a class="link" href="gtk3-Standard-Enumerations.html#GTK-TOOLBAR-BOTH-HORIZ:CAPS"><code class="literal">GTK_TOOLBAR_BOTH_HORIZ</code></a>. The result is that
|
||
only tool buttons with the “is_important” property set have labels, an
|
||
effect known as “priority text”</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-set-is-important.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>is_important</p></td>
|
||
<td class="parameter_description"><p>whether the tool item should be considered important</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-is-important"></a><h3>gtk_tool_item_get_is_important ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_tool_item_get_is_important (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns whether <em class="parameter"><code>tool_item</code></em>
|
||
is considered important. See
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-set-is-important" title="gtk_tool_item_set_is_important ()"><code class="function">gtk_tool_item_set_is_important()</code></a></p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-is-important.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-is-important.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>tool_item</code></em>
|
||
is considered important.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-ellipsize-mode"></a><h3>gtk_tool_item_get_ellipsize_mode ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">PangoEllipsizeMode</span>
|
||
gtk_tool_item_get_ellipsize_mode (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns the ellipsize mode used for <em class="parameter"><code>tool_item</code></em>
|
||
. Custom subclasses of
|
||
<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> should call this function to find out how text should
|
||
be ellipsized.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-ellipsize-mode.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-ellipsize-mode.returns"></a><h4>Returns</h4>
|
||
<p> a <span class="type">PangoEllipsizeMode</span> indicating how text in <em class="parameter"><code>tool_item</code></em>
|
||
should be ellipsized.</p>
|
||
</div>
|
||
<p class="since">Since: 2.20</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-icon-size"></a><h3>gtk_tool_item_get_icon_size ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="returnvalue">GtkIconSize</span></a>
|
||
gtk_tool_item_get_icon_size (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns the icon size used for <em class="parameter"><code>tool_item</code></em>
|
||
. Custom subclasses of
|
||
<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> should call this function to find out what size icons
|
||
they should use.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-icon-size.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-icon-size.returns"></a><h4>Returns</h4>
|
||
<p>a <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> indicating the icon size
|
||
used for <em class="parameter"><code>tool_item</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-orientation"></a><h3>gtk_tool_item_get_orientation ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="returnvalue">GtkOrientation</span></a>
|
||
gtk_tool_item_get_orientation (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns the orientation used for <em class="parameter"><code>tool_item</code></em>
|
||
. Custom subclasses of
|
||
<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> should call this function to find out what size icons
|
||
they should use.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-orientation.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-orientation.returns"></a><h4>Returns</h4>
|
||
<p> a <a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> indicating the orientation
|
||
used for <em class="parameter"><code>tool_item</code></em>
|
||
</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-toolbar-style"></a><h3>gtk_tool_item_get_toolbar_style ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="returnvalue">GtkToolbarStyle</span></a>
|
||
gtk_tool_item_get_toolbar_style (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns the toolbar style used for <em class="parameter"><code>tool_item</code></em>
|
||
. Custom subclasses of
|
||
<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> should call this function in the handler of the
|
||
GtkToolItem::toolbar_reconfigured signal to find out in what style
|
||
the toolbar is displayed and change themselves accordingly </p>
|
||
<p>Possibilities are:</p>
|
||
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
|
||
<li class="listitem"><p><a class="link" href="gtk3-Standard-Enumerations.html#GTK-TOOLBAR-BOTH:CAPS"><code class="literal">GTK_TOOLBAR_BOTH</code></a>, meaning the tool item should show
|
||
both an icon and a label, stacked vertically</p></li>
|
||
<li class="listitem"><p><a class="link" href="gtk3-Standard-Enumerations.html#GTK-TOOLBAR-ICONS:CAPS"><code class="literal">GTK_TOOLBAR_ICONS</code></a>, meaning the toolbar shows only icons</p></li>
|
||
<li class="listitem"><p><a class="link" href="gtk3-Standard-Enumerations.html#GTK-TOOLBAR-TEXT:CAPS"><code class="literal">GTK_TOOLBAR_TEXT</code></a>, meaning the tool item should only show text</p></li>
|
||
<li class="listitem"><p><a class="link" href="gtk3-Standard-Enumerations.html#GTK-TOOLBAR-BOTH-HORIZ:CAPS"><code class="literal">GTK_TOOLBAR_BOTH_HORIZ</code></a>, meaning the tool item should show
|
||
both an icon and a label, arranged horizontally</p></li>
|
||
</ul></div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-toolbar-style.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-toolbar-style.returns"></a><h4>Returns</h4>
|
||
<p> A <a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> indicating the toolbar style used
|
||
for <em class="parameter"><code>tool_item</code></em>
|
||
.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-relief-style"></a><h3>gtk_tool_item_get_relief_style ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="returnvalue">GtkReliefStyle</span></a>
|
||
gtk_tool_item_get_relief_style (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns the relief style of <em class="parameter"><code>tool_item</code></em>
|
||
. See <a class="link" href="GtkButton.html#gtk-button-set-relief" title="gtk_button_set_relief ()"><code class="function">gtk_button_set_relief()</code></a>.
|
||
Custom subclasses of <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> should call this function in the handler
|
||
of the <a class="link" href="GtkToolItem.html#GtkToolItem-toolbar-reconfigured" title="The “toolbar-reconfigured” signal"><span class="type">“toolbar_reconfigured”</span></a> signal to find out the
|
||
relief style of buttons.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-relief-style.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-relief-style.returns"></a><h4>Returns</h4>
|
||
<p> a <a class="link" href="gtk3-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="type">GtkReliefStyle</span></a> indicating the relief style used
|
||
for <em class="parameter"><code>tool_item</code></em>
|
||
.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-text-alignment"></a><h3>gtk_tool_item_get_text_alignment ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gfloat</span>
|
||
gtk_tool_item_get_text_alignment (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns the text alignment used for <em class="parameter"><code>tool_item</code></em>
|
||
. Custom subclasses of
|
||
<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> should call this function to find out how text should
|
||
be aligned.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-text-alignment.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>: </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-text-alignment.returns"></a><h4>Returns</h4>
|
||
<p> a <span class="type">gfloat</span> indicating the horizontal text alignment
|
||
used for <em class="parameter"><code>tool_item</code></em>
|
||
</p>
|
||
</div>
|
||
<p class="since">Since: 2.20</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-text-orientation"></a><h3>gtk_tool_item_get_text_orientation ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="returnvalue">GtkOrientation</span></a>
|
||
gtk_tool_item_get_text_orientation (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns the text orientation used for <em class="parameter"><code>tool_item</code></em>
|
||
. Custom subclasses of
|
||
<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> should call this function to find out how text should
|
||
be orientated.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-text-orientation.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-text-orientation.returns"></a><h4>Returns</h4>
|
||
<p> a <a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> indicating the text orientation
|
||
used for <em class="parameter"><code>tool_item</code></em>
|
||
</p>
|
||
</div>
|
||
<p class="since">Since: 2.20</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-retrieve-proxy-menu-item"></a><h3>gtk_tool_item_retrieve_proxy_menu_item ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_tool_item_retrieve_proxy_menu_item
|
||
(<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns the <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> that was last set by
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-set-proxy-menu-item" title="gtk_tool_item_set_proxy_menu_item ()"><code class="function">gtk_tool_item_set_proxy_menu_item()</code></a>, ie. the <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a>
|
||
that is going to appear in the overflow menu.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-retrieve-proxy-menu-item.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-retrieve-proxy-menu-item.returns"></a><h4>Returns</h4>
|
||
<p>The <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> that is going to appear in the
|
||
overflow menu for <em class="parameter"><code>tool_item</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-proxy-menu-item"></a><h3>gtk_tool_item_get_proxy_menu_item ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_tool_item_get_proxy_menu_item (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *menu_item_id</code></em>);</pre>
|
||
<p>If <em class="parameter"><code>menu_item_id</code></em>
|
||
matches the string passed to
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-set-proxy-menu-item" title="gtk_tool_item_set_proxy_menu_item ()"><code class="function">gtk_tool_item_set_proxy_menu_item()</code></a> return the corresponding <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a>.</p>
|
||
<p>Custom subclasses of <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> should use this function to
|
||
update their menu item when the <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> changes. That the
|
||
<em class="parameter"><code>menu_item_ids</code></em>
|
||
must match ensures that a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
|
||
will not inadvertently change a menu item that they did not create.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-proxy-menu-item.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>menu_item_id</p></td>
|
||
<td class="parameter_description"><p>a string used to identify the menu item</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-proxy-menu-item.returns"></a><h4>Returns</h4>
|
||
<p>The <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> passed to
|
||
<a class="link" href="GtkToolItem.html#gtk-tool-item-set-proxy-menu-item" title="gtk_tool_item_set_proxy_menu_item ()"><code class="function">gtk_tool_item_set_proxy_menu_item()</code></a>, if the <em class="parameter"><code>menu_item_ids</code></em>
|
||
match. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-set-proxy-menu-item"></a><h3>gtk_tool_item_set_proxy_menu_item ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_tool_item_set_proxy_menu_item (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *menu_item_id</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *menu_item</code></em>);</pre>
|
||
<p>Sets the <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> used in the toolbar overflow menu. The
|
||
<em class="parameter"><code>menu_item_id</code></em>
|
||
is used to identify the caller of this function and
|
||
should also be used with <a class="link" href="GtkToolItem.html#gtk-tool-item-get-proxy-menu-item" title="gtk_tool_item_get_proxy_menu_item ()"><code class="function">gtk_tool_item_get_proxy_menu_item()</code></a>.</p>
|
||
<p>See also <a class="link" href="GtkToolItem.html#GtkToolItem-create-menu-proxy" title="The “create-menu-proxy” signal"><span class="type">“create-menu-proxy”</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-set-proxy-menu-item.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>menu_item_id</p></td>
|
||
<td class="parameter_description"><p>a string used to identify <em class="parameter"><code>menu_item</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>menu_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> to use in the overflow menu, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-rebuild-menu"></a><h3>gtk_tool_item_rebuild_menu ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_tool_item_rebuild_menu (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Calling this function signals to the toolbar that the
|
||
overflow menu item for <em class="parameter"><code>tool_item</code></em>
|
||
has changed. If the
|
||
overflow menu is visible when this function it called,
|
||
the menu will be rebuilt.</p>
|
||
<p>The function must be called when the tool item changes what it
|
||
will do in response to the <a class="link" href="GtkToolItem.html#GtkToolItem-create-menu-proxy" title="The “create-menu-proxy” signal"><span class="type">“create-menu-proxy”</span></a> signal.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-rebuild-menu.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-toolbar-reconfigured"></a><h3>gtk_tool_item_toolbar_reconfigured ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_tool_item_toolbar_reconfigured (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Emits the signal <a class="link" href="GtkToolItem.html#GtkToolItem-toolbar-reconfigured" title="The “toolbar-reconfigured” signal"><span class="type">“toolbar_reconfigured”</span></a> on <em class="parameter"><code>tool_item</code></em>
|
||
.
|
||
<a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> and other <a class="link" href="GtkToolShell.html" title="GtkToolShell"><span class="type">GtkToolShell</span></a> implementations use this function
|
||
to notify children, when some aspect of their configuration changes.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-toolbar-reconfigured.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.14</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-tool-item-get-text-size-group"></a><h3>gtk_tool_item_get_text_size_group ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="returnvalue">GtkSizeGroup</span></a> *
|
||
gtk_tool_item_get_text_size_group (<em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>);</pre>
|
||
<p>Returns the size group used for labels in <em class="parameter"><code>tool_item</code></em>
|
||
.
|
||
Custom subclasses of <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> should call this function
|
||
and use the size group for labels.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-text-size-group.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-tool-item-get-text-size-group.returns"></a><h4>Returns</h4>
|
||
<p>a <a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup"><span class="type">GtkSizeGroup</span></a>. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.20</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkToolItem.other_details"></a><h2>Types and Values</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkToolItem-struct"></a><h3>struct GtkToolItem</h3>
|
||
<pre class="programlisting">struct GtkToolItem;</pre>
|
||
<p>The GtkToolItem struct contains only private data.
|
||
It should only be accessed through the functions described below.</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkToolItemClass"></a><h3>struct GtkToolItemClass</h3>
|
||
<pre class="programlisting">struct GtkToolItemClass {
|
||
GtkBinClass parent_class;
|
||
|
||
/* signals */
|
||
gboolean (* create_menu_proxy) (GtkToolItem *tool_item);
|
||
void (* toolbar_reconfigured) (GtkToolItem *tool_item);
|
||
};
|
||
</pre>
|
||
<div class="refsect3">
|
||
<a name="GtkToolItemClass.members"></a><h4>Members</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="300px" class="struct_members_name">
|
||
<col class="struct_members_description">
|
||
<col width="200px" class="struct_members_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkToolItemClass.create-menu-proxy"></a>create_menu_proxy</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Signal emitted when the toolbar needs
|
||
information from tool_item about whether the item should appear in
|
||
the toolbar overflow menu.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkToolItemClass.toolbar-reconfigured"></a>toolbar_reconfigured</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Signal emitted when some property of the
|
||
toolbar that the item is a child of changes.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkToolItem.property-details"></a><h2>Property Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkToolItem--is-important"></a><h3>The <code class="literal">“is-important”</code> property</h3>
|
||
<pre class="programlisting"> “is-important” <span class="type">gboolean</span></pre>
|
||
<p>Whether the toolbar item is considered important. When TRUE, toolbar buttons show text in GTK_TOOLBAR_BOTH_HORIZ mode.</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkToolItem--visible-horizontal"></a><h3>The <code class="literal">“visible-horizontal”</code> property</h3>
|
||
<pre class="programlisting"> “visible-horizontal” <span class="type">gboolean</span></pre>
|
||
<p>Whether the toolbar item is visible when the toolbar is in a horizontal orientation.</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkToolItem--visible-vertical"></a><h3>The <code class="literal">“visible-vertical”</code> property</h3>
|
||
<pre class="programlisting"> “visible-vertical” <span class="type">gboolean</span></pre>
|
||
<p>Whether the toolbar item is visible when the toolbar is in a vertical orientation.</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkToolItem.signal-details"></a><h2>Signal Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkToolItem-create-menu-proxy"></a><h3>The <code class="literal">“create-menu-proxy”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
user_function (<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>This signal is emitted when the toolbar needs information from <em class="parameter"><code>tool_item</code></em>
|
||
|
||
about whether the item should appear in the toolbar overflow menu. In
|
||
response the tool item should either</p>
|
||
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
|
||
<li class="listitem"><p>call <a class="link" href="GtkToolItem.html#gtk-tool-item-set-proxy-menu-item" title="gtk_tool_item_set_proxy_menu_item ()"><code class="function">gtk_tool_item_set_proxy_menu_item()</code></a> with a <code class="literal">NULL</code>
|
||
pointer and return <code class="literal">TRUE</code> to indicate that the item should not appear
|
||
in the overflow menu</p></li>
|
||
<li class="listitem"><p>call <a class="link" href="GtkToolItem.html#gtk-tool-item-set-proxy-menu-item" title="gtk_tool_item_set_proxy_menu_item ()"><code class="function">gtk_tool_item_set_proxy_menu_item()</code></a> with a new menu
|
||
item and return <code class="literal">TRUE</code>, or </p></li>
|
||
<li class="listitem"><p>return <code class="literal">FALSE</code> to indicate that the signal was not handled by the item.
|
||
This means that the item will not appear in the overflow menu unless
|
||
a later handler installs a menu item.</p></li>
|
||
</ul></div>
|
||
<p>The toolbar may cache the result of this signal. When the tool item changes
|
||
how it will respond to this signal it must call <a class="link" href="GtkToolItem.html#gtk-tool-item-rebuild-menu" title="gtk_tool_item_rebuild_menu ()"><code class="function">gtk_tool_item_rebuild_menu()</code></a>
|
||
to invalidate the cache and ensure that the toolbar rebuilds its overflow
|
||
menu.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkToolItem-create-menu-proxy.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>the object the signal was emitted on</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="GtkToolItem-create-menu-proxy.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the signal was handled, <code class="literal">FALSE</code> if not</p>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkToolItem-toolbar-reconfigured"></a><h3>The <code class="literal">“toolbar-reconfigured”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>This signal is emitted when some property of the toolbar that the
|
||
item is a child of changes. For custom subclasses of <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>,
|
||
the default handler of this signal use the functions</p>
|
||
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
|
||
<li class="listitem"><p>gtk_tool_shell_get_orientation()</p></li>
|
||
<li class="listitem"><p>gtk_tool_shell_get_style()</p></li>
|
||
<li class="listitem"><p>gtk_tool_shell_get_icon_size()</p></li>
|
||
<li class="listitem"><p>gtk_tool_shell_get_relief_style()
|
||
to find out what the toolbar should look like and change
|
||
themselves accordingly.</p></li>
|
||
</ul></div>
|
||
<div class="refsect3">
|
||
<a name="GtkToolItem-toolbar-reconfigured.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>tool_item</p></td>
|
||
<td class="parameter_description"><p>the object the signal was emitted on</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkToolItem.see-also"></a><h2>See Also</h2>
|
||
<p><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>, <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>, <a class="link" href="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem"><span class="type">GtkSeparatorToolItem</span></a></p>
|
||
</div>
|
||
</div>
|
||
<div class="footer">
|
||
<hr>Generated by GTK-Doc V1.28</div>
|
||
</body>
|
||
</html> |