<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
<!ENTITY pi "&#960;">
<!ENTITY solidus "&#8260;">
]>
<refentry id="GtkWidget">
<refmeta>
<refentrytitle role="top_of_page" id="GtkWidget.top_of_page">GtkWidget</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkWidget</refname>
<refpurpose>Base class for all widgets</refpurpose>
</refnamediv>

<refsect1 id="GtkWidget.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><phrase role="c_punctuation">(</phrase><link linkend="GtkCallback">*GtkCallback</link><phrase role="c_punctuation">)</phrase>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-new">gtk_widget_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-in-destruction">gtk_widget_in_destruction</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-unparent">gtk_widget_unparent</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-show">gtk_widget_show</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-hide">gtk_widget_hide</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-map">gtk_widget_map</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-unmap">gtk_widget_unmap</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-realize">gtk_widget_realize</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-unrealize">gtk_widget_unrealize</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-queue-draw">gtk_widget_queue_draw</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-queue-resize">gtk_widget_queue_resize</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-queue-allocate">gtk_widget_queue_allocate</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkFrameClock"><returnvalue>GdkFrameClock</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-frame-clock">gtk_widget_get_frame_clock</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-scale-factor">gtk_widget_get_scale_factor</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><phrase role="c_punctuation">(</phrase><link linkend="GtkTickCallback">*GtkTickCallback</link><phrase role="c_punctuation">)</phrase>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="guint"><returnvalue>guint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-add-tick-callback">gtk_widget_add_tick_callback</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-remove-tick-callback">gtk_widget_remove_tick_callback</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-size-allocate">gtk_widget_size_allocate</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-allocate">gtk_widget_allocate</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-add-shortcut">gtk_widget_class_add_shortcut</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-add-binding">gtk_widget_class_add_binding</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-add-binding-signal">gtk_widget_class_add_binding_signal</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-add-binding-action">gtk_widget_class_add_binding_action</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-set-layout-manager-type">gtk_widget_class_set_layout_manager_type</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GType"><returnvalue>GType</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-get-layout-manager-type">gtk_widget_class_get_layout_manager_type</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-activate">gtk_widget_activate</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-is-focus">gtk_widget_is_focus</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-grab-focus">gtk_widget_grab_focus</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-name">gtk_widget_set_name</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-name">gtk_widget_get_name</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-sensitive">gtk_widget_set_sensitive</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-parent">gtk_widget_set_parent</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkRoot"><returnvalue>GtkRoot</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-root">gtk_widget_get_root</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkNative"><returnvalue>GtkNative</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-native">gtk_widget_get_native</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-ancestor">gtk_widget_get_ancestor</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-is-ancestor">gtk_widget_is_ancestor</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-translate-coordinates">gtk_widget_translate_coordinates</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-add-controller">gtk_widget_add_controller</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-remove-controller">gtk_widget_remove_controller</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-direction">gtk_widget_set_direction</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkTextDirection"><returnvalue>GtkTextDirection</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-direction">gtk_widget_get_direction</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-default-direction">gtk_widget_set_default_direction</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkTextDirection"><returnvalue>GtkTextDirection</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-default-direction">gtk_widget_get_default_direction</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoContext"><returnvalue>PangoContext</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-create-pango-context">gtk_widget_create_pango_context</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoContext"><returnvalue>PangoContext</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-pango-context">gtk_widget_get_pango_context</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-font-options">gtk_widget_set_font_options</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="cairo-font-options-t"><returnvalue>cairo_font_options_t</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-font-options">gtk_widget_get_font_options</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-font-map">gtk_widget_set_font_map</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoFontMap"><returnvalue>PangoFontMap</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-font-map">gtk_widget_get_font_map</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoLayout"><returnvalue>PangoLayout</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-create-pango-layout">gtk_widget_create_pango_layout</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkCursor"><returnvalue>GdkCursor</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-cursor">gtk_widget_get_cursor</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-cursor">gtk_widget_set_cursor</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-cursor-from-name">gtk_widget_set_cursor_from_name</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-mnemonic-activate">gtk_widget_mnemonic_activate</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-set-accessible-type">gtk_widget_class_set_accessible_type</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-set-accessible-role">gtk_widget_class_set_accessible_role</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="AtkObject"><returnvalue>AtkObject</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-accessible">gtk_widget_get_accessible</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-child-focus">gtk_widget_child_focus</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-child-visible">gtk_widget_get_child_visible</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-parent">gtk_widget_get_parent</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkSettings"><returnvalue>GtkSettings</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-settings">gtk_widget_get_settings</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkClipboard"><returnvalue>GdkClipboard</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-clipboard">gtk_widget_get_clipboard</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkClipboard"><returnvalue>GdkClipboard</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-primary-clipboard">gtk_widget_get_primary_clipboard</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkDisplay"><returnvalue>GdkDisplay</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-display">gtk_widget_get_display</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-size-request">gtk_widget_get_size_request</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-child-visible">gtk_widget_set_child_visible</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-size-request">gtk_widget_set_size_request</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GList"><returnvalue>GList</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-list-mnemonic-labels">gtk_widget_list_mnemonic_labels</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-add-mnemonic-label">gtk_widget_add_mnemonic_label</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-remove-mnemonic-label">gtk_widget_remove_mnemonic_label</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-error-bell">gtk_widget_error_bell</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-keynav-failed">gtk_widget_keynav_failed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-tooltip-markup">gtk_widget_get_tooltip_markup</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-tooltip-markup">gtk_widget_set_tooltip_markup</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-tooltip-text">gtk_widget_get_tooltip_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-tooltip-text">gtk_widget_set_tooltip_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-has-tooltip">gtk_widget_get_has_tooltip</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-has-tooltip">gtk_widget_set_has_tooltip</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-trigger-tooltip-query">gtk_widget_trigger_tooltip_query</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-allocated-width">gtk_widget_get_allocated_width</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-allocated-height">gtk_widget_get_allocated_height</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-allocation">gtk_widget_get_allocation</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-allocated-baseline">gtk_widget_get_allocated_baseline</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-width">gtk_widget_get_width</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-height">gtk_widget_get_height</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-compute-bounds">gtk_widget_compute_bounds</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-compute-transform">gtk_widget_compute_transform</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-compute-point">gtk_widget_compute_point</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-contains">gtk_widget_contains</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-pick">gtk_widget_pick</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-can-focus">gtk_widget_get_can_focus</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-can-focus">gtk_widget_set_can_focus</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-focusable">gtk_widget_get_focusable</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-focusable">gtk_widget_set_focusable</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-focus-on-click">gtk_widget_get_focus_on_click</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-focus-on-click">gtk_widget_set_focus_on_click</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-focus-child">gtk_widget_set_focus_child</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-can-target">gtk_widget_get_can_target</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-can-target">gtk_widget_set_can_target</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-sensitive">gtk_widget_get_sensitive</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-is-sensitive">gtk_widget_is_sensitive</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-visible">gtk_widget_get_visible</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-is-visible">gtk_widget_is_visible</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-visible">gtk_widget_set_visible</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-state-flags">gtk_widget_set_state_flags</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-unset-state-flags">gtk_widget_unset_state_flags</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkStateFlags"><returnvalue>GtkStateFlags</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-state-flags">gtk_widget_get_state_flags</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-has-default">gtk_widget_has_default</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-has-focus">gtk_widget_has_focus</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-has-visible-focus">gtk_widget_has_visible_focus</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-is-drawable">gtk_widget_is_drawable</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-receives-default">gtk_widget_set_receives_default</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-receives-default">gtk_widget_get_receives_default</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-support-multidevice">gtk_widget_set_support_multidevice</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-support-multidevice">gtk_widget_get_support_multidevice</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-realized">gtk_widget_get_realized</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-mapped">gtk_widget_get_mapped</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-device-is-shadowed">gtk_widget_device_is_shadowed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="double"><returnvalue>double</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-opacity">gtk_widget_get_opacity</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-opacity">gtk_widget_set_opacity</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkOverflow"><returnvalue>GtkOverflow</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-overflow">gtk_widget_get_overflow</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-overflow">gtk_widget_set_overflow</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-measure">gtk_widget_measure</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-snapshot-child">gtk_widget_snapshot_child</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-next-sibling">gtk_widget_get_next_sibling</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-prev-sibling">gtk_widget_get_prev_sibling</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-first-child">gtk_widget_get_first_child</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-last-child">gtk_widget_get_last_child</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-insert-before">gtk_widget_insert_before</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-insert-after">gtk_widget_insert_after</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-layout-manager">gtk_widget_set_layout_manager</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkLayoutManager"><returnvalue>GtkLayoutManager</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-layout-manager">gtk_widget_get_layout_manager</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-should-layout">gtk_widget_should_layout</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-css-name">gtk_widget_get_css_name</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-add-css-class">gtk_widget_add_css_class</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-remove-css-class">gtk_widget_remove_css_class</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-has-css-class">gtk_widget_has_css_class</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="char"><returnvalue>char</returnvalue></link>&#160;**
</entry><entry role="function_name"><link linkend="gtk-widget-get-css-classes">gtk_widget_get_css_classes</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-css-classes">gtk_widget_set_css_classes</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="function_type"><link linkend="GtkStyleContext"><returnvalue>GtkStyleContext</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-style-context">gtk_widget_get_style_context</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-class-get-css-name">gtk_widget_class_get_css_name</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-set-css-name">gtk_widget_class_set_css_name</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="function_type"><link linkend="GtkRequisition"><returnvalue>GtkRequisition</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-requisition-new">gtk_requisition_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkRequisition"><returnvalue>GtkRequisition</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-requisition-copy">gtk_requisition_copy</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-requisition-free">gtk_requisition_free</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="function_type"><link linkend="GtkSizeRequestMode"><returnvalue>GtkSizeRequestMode</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-request-mode">gtk_widget_get_request_mode</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-preferred-size">gtk_widget_get_preferred_size</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-distribute-natural-allocation">gtk_distribute_natural_allocation</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="function_type"><link linkend="GtkAlign"><returnvalue>GtkAlign</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-halign">gtk_widget_get_halign</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-halign">gtk_widget_set_halign</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkAlign"><returnvalue>GtkAlign</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-valign">gtk_widget_get_valign</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-valign">gtk_widget_set_valign</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-margin-start">gtk_widget_get_margin_start</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-margin-start">gtk_widget_set_margin_start</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-margin-end">gtk_widget_get_margin_end</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-margin-end">gtk_widget_set_margin_end</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-margin-top">gtk_widget_get_margin_top</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-margin-top">gtk_widget_set_margin_top</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-margin-bottom">gtk_widget_get_margin_bottom</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-margin-bottom">gtk_widget_set_margin_bottom</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-hexpand">gtk_widget_get_hexpand</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-hexpand">gtk_widget_set_hexpand</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-hexpand-set">gtk_widget_get_hexpand_set</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-hexpand-set">gtk_widget_set_hexpand_set</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-vexpand">gtk_widget_get_vexpand</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-vexpand">gtk_widget_set_vexpand</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-get-vexpand-set">gtk_widget_get_vexpand_set</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-set-vexpand-set">gtk_widget_set_vexpand_set</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-compute-expand">gtk_widget_compute_expand</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-init-template">gtk_widget_init_template</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-set-template">gtk_widget_class_set_template</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-set-template-from-resource">gtk_widget_class_set_template_from_resource</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GObject"><returnvalue>GObject</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-get-template-child">gtk_widget_get_template_child</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="gtk-widget-class-bind-template-child">gtk_widget_class_bind_template_child</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="gtk-widget-class-bind-template-child-internal">gtk_widget_class_bind_template_child_internal</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="gtk-widget-class-bind-template-child-private">gtk_widget_class_bind_template_child_private</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="gtk-widget-class-bind-template-child-internal-private">gtk_widget_class_bind_template_child_internal_private</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-bind-template-child-full">gtk_widget_class_bind_template_child_full</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="gtk-widget-class-bind-template-callback">gtk_widget_class_bind_template_callback</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-bind-template-callback-full">gtk_widget_class_bind_template_callback_full</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-set-template-scope">gtk_widget_class_set_template_scope</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="function_type"><link linkend="GListModel"><returnvalue>GListModel</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-observe-children">gtk_widget_observe_children</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GListModel"><returnvalue>GListModel</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-widget-observe-controllers">gtk_widget_observe_controllers</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-insert-action-group">gtk_widget_insert_action_group</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-activate-action">gtk_widget_activate_action</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-activate-action-variant">gtk_widget_activate_action_variant</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-activate-default">gtk_widget_activate_default</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><phrase role="c_punctuation">(</phrase><link linkend="GtkWidgetActionActivateFunc">*GtkWidgetActionActivateFunc</link><phrase role="c_punctuation">)</phrase>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-install-action">gtk_widget_class_install_action</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-install-property-action">gtk_widget_class_install_property_action</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-class-query-action">gtk_widget_class_query_action</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-widget-action-set-enabled">gtk_widget_action_set_enabled</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkWidget.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkWidget--can-focus">can-focus</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkWidget--can-target">can-target</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GStrv"><type>GStrv</type></link></entry><entry role="property_name"><link linkend="GtkWidget--css-classes">css-classes</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkWidget--css-name">css-name</link></entry><entry role="property_flags">Read / Write / Construct&#160;Only</entry></row>
<row><entry role="property_type"><link linkend="GdkCursor"><type>GdkCursor</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkWidget--cursor">cursor</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkWidget--focus-on-click">focus-on-click</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkWidget--focusable">focusable</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkAlign"><type>GtkAlign</type></link></entry><entry role="property_name"><link linkend="GtkWidget--halign">halign</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkWidget--has-default">has-default</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkWidget--has-focus">has-focus</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkWidget--has-tooltip">has-tooltip</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkWidget--height-request">height-request</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkWidget--hexpand">hexpand</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkWidget--hexpand-set">hexpand-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkLayoutManager"><type>GtkLayoutManager</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkWidget--layout-manager">layout-manager</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkWidget--margin-bottom">margin-bottom</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkWidget--margin-end">margin-end</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkWidget--margin-start">margin-start</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkWidget--margin-top">margin-top</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkWidget--name">name</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gdouble"><type>gdouble</type></link></entry><entry role="property_name"><link linkend="GtkWidget--opacity">opacity</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkOverflow"><type>GtkOverflow</type></link></entry><entry role="property_name"><link linkend="GtkWidget--overflow">overflow</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkWidget"><type>GtkWidget</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkWidget--parent">parent</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkWidget--receives-default">receives-default</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkRoot"><type>GtkRoot</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkWidget--root">root</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkWidget--scale-factor">scale-factor</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkWidget--sensitive">sensitive</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkWidget--tooltip-markup">tooltip-markup</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkWidget--tooltip-text">tooltip-text</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkAlign"><type>GtkAlign</type></link></entry><entry role="property_name"><link linkend="GtkWidget--valign">valign</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkWidget--vexpand">vexpand</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkWidget--vexpand-set">vexpand-set</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkWidget--visible">visible</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gint"><type>gint</type></link></entry><entry role="property_name"><link linkend="GtkWidget--width-request">width-request</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkWidget.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signal_proto_type" colwidth="150px"/>
<colspec colname="signal_proto_name" colwidth="300px"/>
<colspec colname="signal_proto_flags" colwidth="200px"/>
<tbody>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkWidget-destroy">destroy</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-NO-HOOKS:CAPS">No Hooks</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkWidget-direction-changed">direction-changed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkWidget-grab-notify">grab-notify</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkWidget-hide">hide</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>
<row><entry role="signal_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkWidget-keynav-failed">keynav-failed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkWidget-map">map</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>
<row><entry role="signal_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkWidget-mnemonic-activate">mnemonic-activate</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkWidget-move-focus">move-focus</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkWidget-query-tooltip">query-tooltip</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkWidget-realize">realize</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkWidget-show">show</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkWidget-state-flags-changed">state-flags-changed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkWidget-unmap">unmap</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkWidget-unrealize">unrealize</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkWidget.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="GtkWidget-struct">GtkWidget</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GtkWidgetClass">GtkWidgetClass</link></entry></row>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="GtkRequisition">GtkRequisition</link></entry></row>
<row><entry role="typedef_keyword">typedef</entry><entry role="function_name"><link linkend="GtkAllocation">GtkAllocation</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GtkTextDirection">GtkTextDirection</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GtkPickFlags">GtkPickFlags</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GtkOverflow">GtkOverflow</link></entry></row>



<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GtkSizeRequestMode">GtkSizeRequestMode</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GtkRequestedSize">GtkRequestedSize</link></entry></row>

<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GtkAlign">GtkAlign</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkWidget.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
        <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkWidget
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkWindow">GtkWindow</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkAccelLabel">GtkAccelLabel</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkActionBar">GtkActionBar</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkAppChooserButton">GtkAppChooserButton</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkAppChooserWidget">GtkAppChooserWidget</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkAspectFrame">GtkAspectFrame</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkBox">GtkBox</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkButton">GtkButton</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkCalendar">GtkCalendar</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkCellView">GtkCellView</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkColorButton">GtkColorButton</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkColorChooserWidget">GtkColorChooserWidget</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkComboBox">GtkComboBox</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkDragIcon">GtkDragIcon</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkDrawingArea">GtkDrawingArea</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkPopover">GtkPopover</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkEntry">GtkEntry</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkExpander">GtkExpander</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkFileChooserButton">GtkFileChooserButton</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkFileChooserWidget">GtkFileChooserWidget</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkFixed">GtkFixed</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkFlowBox">GtkFlowBox</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkFlowBoxChild">GtkFlowBoxChild</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkFontButton">GtkFontButton</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkFontChooserWidget">GtkFontChooserWidget</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkFrame">GtkFrame</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkGLArea">GtkGLArea</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkGrid">GtkGrid</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkHeaderBar">GtkHeaderBar</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkIconView">GtkIconView</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkImage">GtkImage</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkInfoBar">GtkInfoBar</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkLabel">GtkLabel</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkListBox">GtkListBox</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkListBoxRow">GtkListBoxRow</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkMediaControls">GtkMediaControls</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkMenuButton">GtkMenuButton</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkNotebook">GtkNotebook</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkOverlay">GtkOverlay</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkPaned">GtkPaned</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkPasswordEntry">GtkPasswordEntry</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkPicture">GtkPicture</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkPopoverMenuBar">GtkPopoverMenuBar</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkProgressBar">GtkProgressBar</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkRange">GtkRange</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkRevealer">GtkRevealer</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkScaleButton">GtkScaleButton</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkScrollbar">GtkScrollbar</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkScrolledWindow">GtkScrolledWindow</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkSearchBar">GtkSearchBar</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkSearchEntry">GtkSearchEntry</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkSeparator">GtkSeparator</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkShortcutLabel">GtkShortcutLabel</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkShortcutsShortcut">GtkShortcutsShortcut</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkSpinButton">GtkSpinButton</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkSpinner">GtkSpinner</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkStack">GtkStack</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkStackSidebar">GtkStackSidebar</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkStackSwitcher">GtkStackSwitcher</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkStatusbar">GtkStatusbar</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkSwitch">GtkSwitch</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkLevelBar">GtkLevelBar</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkText">GtkText</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkTextView">GtkTextView</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkTreeView">GtkTreeView</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkVideo">GtkVideo</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkViewport">GtkViewport</link>
            <phrase role="lineart">&#9500;&#9472;&#9472;</phrase> <link linkend="GtkWindowControls">GtkWindowControls</link>
            <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkWindowHandle">GtkWindowHandle</link>
</screen>
</refsect1>
<refsect1 id="GtkWidget.derived-interfaces" role="derived_interfaces">
<title role="derived_interfaces.title">Known Derived Interfaces</title>
<para>
GtkWidget is required by
 <link linkend="GtkActionable">GtkActionable</link>,  <link linkend="GtkAppChooser">GtkAppChooser</link>,  <link linkend="GtkCellEditable">GtkCellEditable</link>,  <link linkend="GtkEditable">GtkEditable</link>,  <link linkend="GtkNative">GtkNative</link> and  <link linkend="GtkRoot">GtkRoot</link>.</para>

</refsect1>
<refsect1 id="GtkWidget.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkWidget implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link> and  <link linkend="GtkConstraintTarget">GtkConstraintTarget</link>.</para>

</refsect1>

<refsect1 id="GtkWidget.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtk.h&gt;
</synopsis></refsect1>

<refsect1 id="GtkWidget.description" role="desc">
<title role="desc.title">Description</title>
<para>GtkWidget is the base class all widgets in GTK+ derive from. It manages the
widget lifecycle, states and style.</para>
<refsect2 id="geometry-management"><title>Height-for-width Geometry Management</title><para>GTK+ uses a height-for-width (and width-for-height) geometry management
system. Height-for-width means that a widget can change how much
vertical space it needs, depending on the amount of horizontal space
that it is given (and similar for width-for-height). The most common
example is a label that reflows to fill up the available width, wraps
to fewer lines, and therefore needs less height.</para>
<para>Height-for-width geometry management is implemented in GTK+ by way
of two virtual methods:</para>
<itemizedlist>
<listitem><para><link linkend="GtkWidgetClass.get-request-mode"><function>GtkWidgetClass.get_request_mode()</function></link></para></listitem>
<listitem>
<para><link linkend="GtkWidgetClass.measure"><function>GtkWidgetClass.measure()</function></link></para>
</listitem>
</itemizedlist>
<para>There are some important things to keep in mind when implementing
height-for-width and when using it in widget implementations.</para>
<para>If you implement a direct <link linkend="GtkWidget"><type>GtkWidget</type></link> subclass that supports
height-for-width or width-for-height geometry management for
itself or its child widgets, the <link linkend="GtkWidgetClass.get-request-mode"><function>GtkWidgetClass.get_request_mode()</function></link>
virtual function must be implemented as well and return the widget's
preferred request mode. The default implementation of this virtual function
returns <link linkend="GTK-SIZE-REQUEST-CONSTANT-SIZE:CAPS"><literal>GTK_SIZE_REQUEST_CONSTANT_SIZE</literal></link>, which means that the widget will only ever
get -1 passed as the for_size value to its <link linkend="GtkWidgetClass.measure"><function>GtkWidgetClass.measure()</function></link> implementation.</para>
<para>The geometry management system will query a widget hierarchy in
only one orientation at a time. When widgets are initially queried
for their minimum sizes it is generally done in two initial passes
in the <link linkend="GtkSizeRequestMode"><type>GtkSizeRequestMode</type></link> chosen by the toplevel.</para>
<para>For example, when queried in the normal
<link linkend="GTK-SIZE-REQUEST-HEIGHT-FOR-WIDTH:CAPS"><literal>GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH</literal></link> mode:
First, the default minimum and natural width for each widget
in the interface will be computed using <link linkend="gtk-widget-measure"><function>gtk_widget_measure()</function></link> with an orientation
of <link linkend="GTK-ORIENTATION-HORIZONTAL:CAPS"><literal>GTK_ORIENTATION_HORIZONTAL</literal></link> and a for_size of -1.
Because the preferred widths for each widget depend on the preferred
widths of their children, this information propagates up the hierarchy,
and finally a minimum and natural width is determined for the entire
toplevel. Next, the toplevel will use the minimum width to query for the
minimum height contextual to that width using <link linkend="gtk-widget-measure"><function>gtk_widget_measure()</function></link> with an
orientation of <link linkend="GTK-ORIENTATION-VERTICAL:CAPS"><literal>GTK_ORIENTATION_VERTICAL</literal></link> and a for_size of the just computed
width. This will also be a highly recursive operation.
The minimum height for the minimum width is normally
used to set the minimum size constraint on the toplevel
(unless <link linkend="gtk-window-set-geometry-hints"><function>gtk_window_set_geometry_hints()</function></link> is explicitly used instead).</para>
<para>After the toplevel window has initially requested its size in both
dimensions it can go on to allocate itself a reasonable size (or a size
previously specified with <link linkend="gtk-window-set-default-size"><function>gtk_window_set_default_size()</function></link>). During the
recursive allocation process it’s important to note that request cycles
will be recursively executed while widgets allocate their children.
Each widget, once allocated a size, will go on to first share the
space in one orientation among its children and then request each child's
height for its target allocated width or its width for allocated height,
depending. In this way a <link linkend="GtkWidget"><type>GtkWidget</type></link> will typically be requested its size
a number of times before actually being allocated a size. The size a
widget is finally allocated can of course differ from the size it has
requested. For this reason, <link linkend="GtkWidget"><type>GtkWidget</type></link> caches a  small number of results
to avoid re-querying for the same sizes in one allocation cycle.</para>
<para>If a widget does move content around to intelligently use up the
allocated size then it must support the request in both
<link linkend="GtkSizeRequestModes"><type>GtkSizeRequestModes</type></link> even if the widget in question only
trades sizes in a single orientation.</para>
<para>For instance, a <link linkend="GtkLabel"><type>GtkLabel</type></link> that does height-for-width word wrapping
will not expect to have <link linkend="GtkWidgetClass.measure"><function>GtkWidgetClass.measure()</function></link> with an orientation of
<link linkend="GTK-ORIENTATION-VERTICAL:CAPS"><literal>GTK_ORIENTATION_VERTICAL</literal></link> called because that call is specific to a
width-for-height request. In this
case the label must return the height required for its own minimum
possible width. By following this rule any widget that handles
height-for-width or width-for-height requests will always be allocated
at least enough space to fit its own content.</para>
<para>Here are some examples of how a <link linkend="GTK-SIZE-REQUEST-HEIGHT-FOR-WIDTH:CAPS"><literal>GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH</literal></link> widget
generally deals with width-for-height requests:</para>
<informalexample><programlisting role="example"><![CDATA[
static void
foo_widget_measure (GtkWidget      *widget,
                    GtkOrientation  orientation,
                    int             for_size,
                    int            *minimum_size,
                    int            *natural_size,
                    int            *minimum_baseline,
                    int            *natural_baseline)
{
  if (orientation == GTK_ORIENTATION_HORIZONTAL)
    {
      // Calculate minimum and natural width
    }
  else // VERTICAL
    {
       if (i_am_in_height_for_width_mode)
         {
           int min_width, dummy;

           // First, get the minimum width of our widget
           GTK_WIDGET_GET_CLASS (widget)->measure (widget, GTK_ORIENTATION_HORIZONTAL, -1,
                                                   &min_width, &dummy, &dummy, &dummy);

           // Now use the minimum width to retrieve the minimum and natural height to display
           // that width.
           GTK_WIDGET_GET_CLASS (widget)->measure (widget, GTK_ORIENTATION_VERTICAL, min_width,
                                                   minimum_size, natural_size, &dummy, &dummy);
         }
       else
         {
           // ... some widgets do both.
         }
   }
}
]]></programlisting></informalexample>
<para></para>
<para>Often a widget needs to get its own request during size request or
allocation. For example, when computing height it may need to also
compute width. Or when deciding how to use an allocation, the widget
may need to know its natural size. In these cases, the widget should
be careful to call its virtual methods directly, like in the code
example above.</para>
<para>It will not work to use the wrapper function <link linkend="gtk-widget-measure"><function>gtk_widget_measure()</function></link>
inside your own <link linkend="GtkWidgetClass.size-allocate"><function>GtkWidgetClass.size-<link linkend="allocate"><function>allocate()</function></link></function></link> implementation.
These return a request adjusted by <link linkend="GtkSizeGroup"><type>GtkSizeGroup</type></link>, the widget's align and expand flags
as well as its CSS style.
If a widget used the wrappers inside its virtual method implementations,
then the adjustments (such as widget margins) would be applied
twice. GTK+ therefore does not allow this and will warn if you try
to do it.</para>
<para>Of course if you are getting the size request for
another widget, such as a child widget, you must use <link linkend="gtk-widget-measure"><function>gtk_widget_measure()</function></link>.
Otherwise, you would not properly consider widget margins,
<link linkend="GtkSizeGroup"><type>GtkSizeGroup</type></link>, and so forth.</para>
<para>GTK+ also supports baseline vertical alignment of widgets. This
means that widgets are positioned such that the typographical baseline of
widgets in the same row are aligned. This happens if a widget supports baselines,
has a vertical alignment of <link linkend="GTK-ALIGN-BASELINE:CAPS"><literal>GTK_ALIGN_BASELINE</literal></link>, and is inside a widget
that supports baselines and has a natural “row” that it aligns to the baseline,
or a baseline assigned to it by the grandparent.</para>
<para>Baseline alignment support for a widget is also done by the <link linkend="GtkWidgetClass.measure"><function>GtkWidgetClass.measure()</function></link>
virtual function. It allows you to report both a minimum and natural size.</para>
<para>If a widget ends up baseline aligned it will be allocated all the space in the parent
as if it was <link linkend="GTK-ALIGN-FILL:CAPS"><literal>GTK_ALIGN_FILL</literal></link>, but the selected baseline can be found via <link linkend="gtk-widget-get-allocated-baseline"><function>gtk_widget_get_allocated_baseline()</function></link>.
If this has a value other than -1 you need to align the widget such that the baseline
appears at the position.</para>
</refsect2>
<refsect2><title>GtkWidget as GtkBuildable</title><para>The GtkWidget implementation of the GtkBuildable interface supports a
custom &lt;accelerator> element, which has attributes named ”key”, ”modifiers”
and ”signal” and allows to specify accelerators.</para>
<para>An example of a UI definition fragment specifying an accelerator:</para>
<informalexample><programlisting role="example"><![CDATA[
<object class="GtkButton">
  <accelerator key="q" modifiers="GDK_CONTROL_MASK" signal="clicked"/>
</object>
]]></programlisting></informalexample>
<para></para>
<para>In addition to accelerators, GtkWidget also support a custom &lt;accessible>
element, which supports actions and relations. Properties on the accessible
implementation of an object can be set by accessing the internal child
“accessible” of a <link linkend="GtkWidget"><type>GtkWidget</type></link>.</para>
<para>An example of a UI definition fragment specifying an accessible:</para>
<informalexample><programlisting role="example"><![CDATA[
<object class="GtkLabel" id="label1"/>
  <property name="label">I am a Label for a Button</property>
</object>
<object class="GtkButton" id="button1">
  <accessibility>
    <action action_name="click" translatable="yes">Click the button.</action>
    <relation target="label1" type="labelled-by"/>
  </accessibility>
  <child internal-child="accessible">
    <object class="AtkObject" id="a11y-button1">
      <property name="accessible-name">Clickable Button</property>
    </object>
  </child>
</object>
]]></programlisting></informalexample>
<para></para>
<para>If the parent widget uses a <link linkend="GtkLayoutManager"><type>GtkLayoutManager</type></link>, <link linkend="GtkWidget"><type>GtkWidget</type></link> supports a
custom &lt;layout> element, used to define layout properties:</para>
<informalexample><programlisting role="example"><![CDATA[
<object class="MyGrid" id="grid1">
  <child>
    <object class="GtkLabel" id="label1">
      <property name="label">Description</property>
      <layout>
        <property name="left-attach">0</property>
        <property name="top-attach">0</property>
        <property name="row-span">1</property>
        <property name="col-span">1</property>
      </layout>
    </object>
  </child>
  <child>
    <object class="GtkEntry" id="description_entry">
      <layout>
        <property name="left-attach">1</property>
        <property name="top-attach">0</property>
        <property name="row-span">1</property>
        <property name="col-span">1</property>
      </layout>
    </object>
  </child>
</object>
]]></programlisting></informalexample>
<para></para>
<para>Finally, GtkWidget allows style information such as style classes to
be associated with widgets, using the custom &lt;style> element:</para>
<informalexample><programlisting role="example"><![CDATA[
<object class="GtkButton" id="button1">
  <style>
    <class name="my-special-button-class"/>
    <class name="dark-button"/>
  </style>
</object>
]]></programlisting></informalexample>
<para></para>
</refsect2>
<refsect2 id="composite-templates"><title>Building composite widgets from template XML</title><para>GtkWidget exposes some facilities to automate the procedure
of creating composite widgets using <link linkend="GtkBuilder"><type>GtkBuilder</type></link> interface description
language.</para>
<para>To create composite widgets with <link linkend="GtkBuilder"><type>GtkBuilder</type></link> XML, one must associate
the interface description with the widget class at class initialization
time using <link linkend="gtk-widget-class-set-template"><function>gtk_widget_class_set_template()</function></link>.</para>
<para>The interface description semantics expected in composite template descriptions
is slightly different from regular <link linkend="GtkBuilder"><type>GtkBuilder</type></link> XML.</para>
<para>Unlike regular interface descriptions, <link linkend="gtk-widget-class-set-template"><function>gtk_widget_class_set_template()</function></link> will
expect a &lt;template> tag as a direct child of the toplevel &lt;interface>
tag. The &lt;template> tag must specify the “class” attribute which must be
the type name of the widget. Optionally, the “parent” attribute may be
specified to specify the direct parent type of the widget type, this is
ignored by the GtkBuilder but required for Glade to introspect what kind
of properties and internal children exist for a given type when the actual
type does not exist.</para>
<para>The XML which is contained inside the &lt;template> tag behaves as if it were
added to the &lt;object> tag defining <parameter>widget</parameter>
 itself. You may set properties
on <parameter>widget</parameter>
 by inserting &lt;property> tags into the &lt;template> tag, and also
add &lt;child> tags to add children and extend <parameter>widget</parameter>
 in the normal way you
would with &lt;object> tags.</para>
<para>Additionally, &lt;object> tags can also be added before and after the initial
&lt;template> tag in the normal way, allowing one to define auxiliary objects
which might be referenced by other widgets declared as children of the
&lt;template> tag.</para>
<para>An example of a GtkBuilder Template Definition:</para>
<informalexample><programlisting role="example"><![CDATA[
<interface>
  <template class="FooWidget" parent="GtkBox">
    <property name="orientation">horizontal</property>
    <property name="spacing">4</property>
    <child>
      <object class="GtkButton" id="hello_button">
        <property name="label">Hello World</property>
        <signal name="clicked" handler="hello_button_clicked" object="FooWidget" swapped="yes"/>
      </object>
    </child>
    <child>
      <object class="GtkButton" id="goodbye_button">
        <property name="label">Goodbye World</property>
      </object>
    </child>
  </template>
</interface>
]]></programlisting></informalexample>
<para></para>
<para>Typically, you'll place the template fragment into a file that is
bundled with your project, using <link linkend="GResource"><type>GResource</type></link>. In order to load the
template, you need to call <link linkend="gtk-widget-class-set-template-from-resource"><function>gtk_widget_class_set_template_from_resource()</function></link>
from the class initialization of your <link linkend="GtkWidget"><type>GtkWidget</type></link> type:</para>
<informalexample><programlisting role="example"><![CDATA[
static void
foo_widget_class_init (FooWidgetClass *klass)
{
  // ...

  gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (klass),
                                               "/com/example/ui/foowidget.ui");
}
]]></programlisting></informalexample>
<para></para>
<para>You will also need to call <link linkend="gtk-widget-init-template"><function>gtk_widget_init_template()</function></link> from the instance
initialization function:</para>
<informalexample><programlisting role="example"><![CDATA[
static void
foo_widget_init (FooWidget *self)
{
  // ...
  gtk_widget_init_template (GTK_WIDGET (self));
}
]]></programlisting></informalexample>
<para></para>
<para>You can access widgets defined in the template using the
<link linkend="gtk-widget-get-template-child"><function>gtk_widget_get_template_child()</function></link> function, but you will typically declare
a pointer in the instance private data structure of your type using the same
name as the widget in the template definition, and call
<link linkend="gtk-widget-class-bind-template-child-private"><function>gtk_widget_class_bind_template_child_private()</function></link> with that name, e.g.</para>
<informalexample><programlisting role="example"><![CDATA[
typedef struct {
  GtkWidget *hello_button;
  GtkWidget *goodbye_button;
} FooWidgetPrivate;

G_DEFINE_TYPE_WITH_PRIVATE (FooWidget, foo_widget, GTK_TYPE_BOX)

static void
foo_widget_class_init (FooWidgetClass *klass)
{
  // ...
  gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (klass),
                                               "/com/example/ui/foowidget.ui");
  gtk_widget_class_bind_template_child_private (GTK_WIDGET_CLASS (klass),
                                                FooWidget, hello_button);
  gtk_widget_class_bind_template_child_private (GTK_WIDGET_CLASS (klass),
                                                FooWidget, goodbye_button);
}

static void
foo_widget_init (FooWidget *widget)
{

}
]]></programlisting></informalexample>
<para></para>
<para>You can also use <link linkend="gtk-widget-class-bind-template-callback"><function>gtk_widget_class_bind_template_callback()</function></link> to connect a signal
callback defined in the template with a function visible in the scope of the
class, e.g.</para>
<informalexample><programlisting role="example"><![CDATA[
// the signal handler has the instance and user data swapped
// because of the swapped="yes" attribute in the template XML
static void
hello_button_clicked (FooWidget *self,
                      GtkButton *button)
{
  g_print ("Hello, world!\n");
}

static void
foo_widget_class_init (FooWidgetClass *klass)
{
  // ...
  gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (klass),
                                               "/com/example/ui/foowidget.ui");
  gtk_widget_class_bind_template_callback (GTK_WIDGET_CLASS (klass), hello_button_clicked);
}
]]></programlisting></informalexample>
<para></para>
</refsect2>

</refsect1>
<refsect1 id="GtkWidget.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="GtkCallback" role="function">
<title>GtkCallback&#160;()</title>
<indexterm zone="GtkCallback"><primary>GtkCallback</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
<phrase role="c_punctuation">(</phrase>*GtkCallback<phrase role="c_punctuation">)</phrase> (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                <parameter><link linkend="gpointer"><type>gpointer</type></link> data</parameter>);</programlisting>
<para>The type of the callback functions used for e.g. iterating over
the children of a container, see <link linkend="gtk-container-foreach"><function>gtk_container_foreach()</function></link>.</para>
<refsect3 id="GtkCallback.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget to operate on</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>data</para></entry>
<entry role="parameter_description"><para>user-supplied data. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-new" role="function">
<title>gtk_widget_new&#160;()</title>
<indexterm zone="gtk-widget-new"><primary>gtk_widget_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_widget_new (<parameter><link linkend="GType"><type>GType</type></link> type</parameter>,
                <parameter>const <link linkend="gchar"><type>gchar</type></link> *first_property_name</parameter>,
                <parameter>...</parameter>);</programlisting>
<para>This is a convenience function for creating a widget and setting
its properties in one go. For example you might write:
<literal>gtk_widget_new (GTK_TYPE_LABEL, "label", "Hello World", "xalign",
0.0, NULL)</literal> to create a left-aligned label. Equivalent to
<link linkend="g-object-new"><function>g_object_new()</function></link>, but returns a widget so you don’t have to
cast the object yourself.</para>
<refsect3 id="gtk-widget-new.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>type</para></entry>
<entry role="parameter_description"><para>type ID of the widget to create</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>first_property_name</para></entry>
<entry role="parameter_description"><para>name of first property to set</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>...</para></entry>
<entry role="parameter_description"><para>value of first property, followed by more properties,
<link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-new.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkWidget"><type>GtkWidget</type></link> of type <parameter>widget_type</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-in-destruction" role="function">
<title>gtk_widget_in_destruction&#160;()</title>
<indexterm zone="gtk-widget-in-destruction"><primary>gtk_widget_in_destruction</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_in_destruction (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns whether the widget is currently being destroyed.
This information can sometimes be used to avoid doing
unnecessary work.</para>
<refsect3 id="gtk-widget-in-destruction.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-in-destruction.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>widget</parameter>
is being destroyed</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-unparent" role="function">
<title>gtk_widget_unparent&#160;()</title>
<indexterm zone="gtk-widget-unparent"><primary>gtk_widget_unparent</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_unparent (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>This function is only for use in widget implementations.
Should be called by parent widgets to dissociate <parameter>widget</parameter>

from the parent.</para>
<refsect3 id="gtk-widget-unparent.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-show" role="function">
<title>gtk_widget_show&#160;()</title>
<indexterm zone="gtk-widget-show"><primary>gtk_widget_show</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_show (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Flags a widget to be displayed. Any widget that isn’t shown will
not appear on the screen.</para>
<para>Remember that you have to show the containers containing a widget,
in addition to the widget itself, before it will appear onscreen.</para>
<para>When a toplevel container is shown, it is immediately realized and
mapped; other shown widgets are realized and mapped when their
toplevel container is realized and mapped.</para>
<refsect3 id="gtk-widget-show.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-hide" role="function">
<title>gtk_widget_hide&#160;()</title>
<indexterm zone="gtk-widget-hide"><primary>gtk_widget_hide</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_hide (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Reverses the effects of <link linkend="gtk-widget-show"><function>gtk_widget_show()</function></link>, causing the widget to be
hidden (invisible to the user).</para>
<refsect3 id="gtk-widget-hide.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-map" role="function">
<title>gtk_widget_map&#160;()</title>
<indexterm zone="gtk-widget-map"><primary>gtk_widget_map</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_map (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>This function is only for use in widget implementations. Causes
a widget to be mapped if it isn’t already.</para>
<refsect3 id="gtk-widget-map.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-unmap" role="function">
<title>gtk_widget_unmap&#160;()</title>
<indexterm zone="gtk-widget-unmap"><primary>gtk_widget_unmap</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_unmap (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>This function is only for use in widget implementations. Causes
a widget to be unmapped if it’s currently mapped.</para>
<refsect3 id="gtk-widget-unmap.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-realize" role="function">
<title>gtk_widget_realize&#160;()</title>
<indexterm zone="gtk-widget-realize"><primary>gtk_widget_realize</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_realize (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Creates the GDK (windowing system) resources associated with a
widget. Normally realization happens implicitly; if you show
a widget and all its parent containers, then the widget will be
realized and mapped automatically.</para>
<para>Realizing a widget requires all
the widget’s parent widgets to be realized; calling
<link linkend="gtk-widget-realize"><function>gtk_widget_realize()</function></link> realizes the widget’s parents in addition to
<parameter>widget</parameter>
 itself. If a widget is not yet inside a toplevel window
when you realize it, bad things will happen.</para>
<para>This function is primarily used in widget implementations, and
isn’t very useful otherwise. Many times when you think you might
need it, a better approach is to connect to a signal that will be
called after the widget is realized automatically, such as
<link linkend="GtkWidget-realize"><type>“realize”</type></link>.</para>
<refsect3 id="gtk-widget-realize.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-unrealize" role="function">
<title>gtk_widget_unrealize&#160;()</title>
<indexterm zone="gtk-widget-unrealize"><primary>gtk_widget_unrealize</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_unrealize (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>This function is only useful in widget implementations.
Causes a widget to be unrealized (frees all GDK resources
associated with the widget).</para>
<refsect3 id="gtk-widget-unrealize.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-queue-draw" role="function">
<title>gtk_widget_queue_draw&#160;()</title>
<indexterm zone="gtk-widget-queue-draw"><primary>gtk_widget_queue_draw</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_queue_draw (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Schedules this widget to be redrawn in paint phase of the
current or the next frame. This means <parameter>widget</parameter>
's GtkWidgetClass.snapshot()
implementation will be called.</para>
<refsect3 id="gtk-widget-queue-draw.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-queue-resize" role="function">
<title>gtk_widget_queue_resize&#160;()</title>
<indexterm zone="gtk-widget-queue-resize"><primary>gtk_widget_queue_resize</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_queue_resize (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>This function is only for use in widget implementations.
Flags a widget to have its size renegotiated; should
be called when a widget for some reason has a new size request.
For example, when you change the text in a <link linkend="GtkLabel"><type>GtkLabel</type></link>, <link linkend="GtkLabel"><type>GtkLabel</type></link>
queues a resize to ensure there’s enough space for the new text.</para>
<para>Note that you cannot call <link linkend="gtk-widget-queue-resize"><function>gtk_widget_queue_resize()</function></link> on a widget
from inside its implementation of the GtkWidgetClass::size_allocate 
virtual method. Calls to <link linkend="gtk-widget-queue-resize"><function>gtk_widget_queue_resize()</function></link> from inside
GtkWidgetClass::size_allocate will be silently ignored.</para>
<refsect3 id="gtk-widget-queue-resize.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-queue-allocate" role="function">
<title>gtk_widget_queue_allocate&#160;()</title>
<indexterm zone="gtk-widget-queue-allocate"><primary>gtk_widget_queue_allocate</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_queue_allocate (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>This function is only for use in widget implementations.</para>
<para>Flags the widget for a rerun of the GtkWidgetClass::size_allocate
function. Use this function instead of <link linkend="gtk-widget-queue-resize"><function>gtk_widget_queue_resize()</function></link>
when the <parameter>widget</parameter>
's size request didn't change but it wants to
reposition its contents.</para>
<para>An example user of this function is <link linkend="gtk-widget-set-halign"><function>gtk_widget_set_halign()</function></link>.</para>
<refsect3 id="gtk-widget-queue-allocate.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-frame-clock" role="function">
<title>gtk_widget_get_frame_clock&#160;()</title>
<indexterm zone="gtk-widget-get-frame-clock"><primary>gtk_widget_get_frame_clock</primary></indexterm>
<programlisting language="C"><link linkend="GdkFrameClock"><returnvalue>GdkFrameClock</returnvalue></link>&#160;*
gtk_widget_get_frame_clock (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Obtains the frame clock for a widget. The frame clock is a global
“ticker” that can be used to drive animations and repaints.  The
most common reason to get the frame clock is to call
<link linkend="gdk-frame-clock-get-frame-time"><function>gdk_frame_clock_get_frame_time()</function></link>, in order to get a time to use for
animating. For example you might record the start of the animation
with an initial value from <link linkend="gdk-frame-clock-get-frame-time"><function>gdk_frame_clock_get_frame_time()</function></link>, and
then update the animation by calling
<link linkend="gdk-frame-clock-get-frame-time"><function>gdk_frame_clock_get_frame_time()</function></link> again during each repaint.</para>
<para>gdk_frame_clock_request_phase() will result in a new frame on the
clock, but won’t necessarily repaint any widgets. To repaint a
widget, you have to use <link linkend="gtk-widget-queue-draw"><function>gtk_widget_queue_draw()</function></link> which invalidates
the widget (thus scheduling it to receive a draw on the next
frame). <link linkend="gtk-widget-queue-draw"><function>gtk_widget_queue_draw()</function></link> will also end up requesting a frame
on the appropriate frame clock.</para>
<para>A widget’s frame clock will not change while the widget is
mapped. Reparenting a widget (which implies a temporary unmap) can
change the widget’s frame clock.</para>
<para>Unrealized widgets do not have a frame clock.</para>
<refsect3 id="gtk-widget-get-frame-clock.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-frame-clock.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GdkFrameClock"><type>GdkFrameClock</type></link>,
or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if widget is unrealized. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-scale-factor" role="function">
<title>gtk_widget_get_scale_factor&#160;()</title>
<indexterm zone="gtk-widget-get-scale-factor"><primary>gtk_widget_get_scale_factor</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_widget_get_scale_factor (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Retrieves the internal scale factor that maps from window coordinates
to the actual device pixels. On traditional systems this is 1, on
high density outputs, it can be a higher value (typically 2).</para>
<para>See <link linkend="gdk-surface-get-scale-factor"><function>gdk_surface_get_scale_factor()</function></link>.</para>
<refsect3 id="gtk-widget-get-scale-factor.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-scale-factor.returns" role="returns">
<title>Returns</title>
<para> the scale factor for <parameter>widget</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="GtkTickCallback" role="function">
<title>GtkTickCallback&#160;()</title>
<indexterm zone="GtkTickCallback"><primary>GtkTickCallback</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
<phrase role="c_punctuation">(</phrase>*GtkTickCallback<phrase role="c_punctuation">)</phrase> (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                    <parameter><link linkend="GdkFrameClock"><type>GdkFrameClock</type></link> *frame_clock</parameter>,
                    <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>);</programlisting>
<para>Callback type for adding a function to update animations. See <link linkend="gtk-widget-add-tick-callback"><function>gtk_widget_add_tick_callback()</function></link>.</para>
<refsect3 id="GtkTickCallback.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>frame_clock</para></entry>
<entry role="parameter_description"><para>the frame clock for the widget (same as calling <link linkend="gtk-widget-get-frame-clock"><function>gtk_widget_get_frame_clock()</function></link>)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>user_data</para></entry>
<entry role="parameter_description"><para>user data passed to <link linkend="gtk-widget-add-tick-callback"><function>gtk_widget_add_tick_callback()</function></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="GtkTickCallback.returns" role="returns">
<title>Returns</title>
<para> <link linkend="G-SOURCE-CONTINUE:CAPS"><literal>G_SOURCE_CONTINUE</literal></link> if the tick callback should continue to be called,
<link linkend="G-SOURCE-REMOVE:CAPS"><literal>G_SOURCE_REMOVE</literal></link> if the tick callback should be removed.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-add-tick-callback" role="function">
<title>gtk_widget_add_tick_callback&#160;()</title>
<indexterm zone="gtk-widget-add-tick-callback"><primary>gtk_widget_add_tick_callback</primary></indexterm>
<programlisting language="C"><link linkend="guint"><returnvalue>guint</returnvalue></link>
gtk_widget_add_tick_callback (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                              <parameter><link linkend="GtkTickCallback"><type>GtkTickCallback</type></link> callback</parameter>,
                              <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>,
                              <parameter><link linkend="GDestroyNotify"><type>GDestroyNotify</type></link> notify</parameter>);</programlisting>
<para>Queues an animation frame update and adds a callback to be called
before each frame. Until the tick callback is removed, it will be
called frequently (usually at the frame rate of the output device
or as quickly as the application can be repainted, whichever is
slower). For this reason, is most suitable for handling graphics
that change every frame or every few frames. The tick callback does
not automatically imply a relayout or repaint. If you want a
repaint or relayout, and aren’t changing widget properties that
would trigger that (for example, changing the text of a <link linkend="GtkLabel"><type>GtkLabel</type></link>),
then you will have to call <link linkend="gtk-widget-queue-resize"><function>gtk_widget_queue_resize()</function></link> or
<link linkend="gtk-widget-queue-draw"><function>gtk_widget_queue_draw()</function></link> yourself.</para>
<para>gdk_frame_clock_get_frame_time() should generally be used for timing
continuous animations and
<link linkend="gdk-frame-timings-get-predicted-presentation-time"><function>gdk_frame_timings_get_predicted_presentation_time()</function></link> if you are
trying to display isolated frames at particular times.</para>
<para>This is a more convenient alternative to connecting directly to the
<link linkend="GdkFrameClock-update"><type>“update”</type></link> signal of <link linkend="GdkFrameClock"><type>GdkFrameClock</type></link>, since you don't
have to worry about when a <link linkend="GdkFrameClock"><type>GdkFrameClock</type></link> is assigned to a widget.</para>
<refsect3 id="gtk-widget-add-tick-callback.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>callback</para></entry>
<entry role="parameter_description"><para>function to call for updating animations</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>user_data</para></entry>
<entry role="parameter_description"><para>data to pass to <parameter>callback</parameter>
. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>notify</para></entry>
<entry role="parameter_description"><para>function to call to free <parameter>user_data</parameter>
when the callback is removed.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-add-tick-callback.returns" role="returns">
<title>Returns</title>
<para> an id for the connection of this callback. Remove the callback
by passing the id returned from this function to
<link linkend="gtk-widget-remove-tick-callback"><function>gtk_widget_remove_tick_callback()</function></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-remove-tick-callback" role="function">
<title>gtk_widget_remove_tick_callback&#160;()</title>
<indexterm zone="gtk-widget-remove-tick-callback"><primary>gtk_widget_remove_tick_callback</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_remove_tick_callback (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                 <parameter><link linkend="guint"><type>guint</type></link> id</parameter>);</programlisting>
<para>Removes a tick callback previously registered with
<link linkend="gtk-widget-add-tick-callback"><function>gtk_widget_add_tick_callback()</function></link>.</para>
<refsect3 id="gtk-widget-remove-tick-callback.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>id</para></entry>
<entry role="parameter_description"><para>an id returned by <link linkend="gtk-widget-add-tick-callback"><function>gtk_widget_add_tick_callback()</function></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-size-allocate" role="function">
<title>gtk_widget_size_allocate&#160;()</title>
<indexterm zone="gtk-widget-size-allocate"><primary>gtk_widget_size_allocate</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_size_allocate (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                          <parameter>const <link linkend="GtkAllocation"><type>GtkAllocation</type></link> *allocation</parameter>,
                          <parameter><link linkend="int"><type>int</type></link> baseline</parameter>);</programlisting>
<para>This is a simple form of <link linkend="gtk-widget-allocate"><function>gtk_widget_allocate()</function></link> that takes the new position
of <parameter>widget</parameter>
 as part of <parameter>allocation</parameter>
.</para>
<refsect3 id="gtk-widget-size-allocate.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>allocation</para></entry>
<entry role="parameter_description"><para>position and size to be allocated to <parameter>widget</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>baseline</para></entry>
<entry role="parameter_description"><para>The baseline of the child, or -1</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-allocate" role="function">
<title>gtk_widget_allocate&#160;()</title>
<indexterm zone="gtk-widget-allocate"><primary>gtk_widget_allocate</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_allocate (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                     <parameter><link linkend="int"><type>int</type></link> width</parameter>,
                     <parameter><link linkend="int"><type>int</type></link> height</parameter>,
                     <parameter><link linkend="int"><type>int</type></link> baseline</parameter>,
                     <parameter><link linkend="GskTransform"><type>GskTransform</type></link> *transform</parameter>);</programlisting>
<para>This function is only used by <link linkend="GtkWidget"><type>GtkWidget</type></link> subclasses, to assign a size,
position and (optionally) baseline to their child widgets.</para>
<para>In this function, the allocation and baseline may be adjusted. The given
allocation will be forced to be bigger than the widget's minimum size,
as well as at least 0×0 in size.</para>
<para>For a version that does not take a transform, see <link linkend="gtk-widget-size-allocate"><function>gtk_widget_size_allocate()</function></link></para>
<refsect3 id="gtk-widget-allocate.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>width</para></entry>
<entry role="parameter_description"><para>New width of <parameter>widget</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>height</para></entry>
<entry role="parameter_description"><para>New height of <parameter>widget</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>baseline</para></entry>
<entry role="parameter_description"><para>New baseline of <parameter>widget</parameter>
, or -1</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>transform</para></entry>
<entry role="parameter_description"><para>Transformation to be applied to <parameter>widget</parameter>
. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>transfer full</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-add-shortcut" role="function">
<title>gtk_widget_class_add_shortcut&#160;()</title>
<indexterm zone="gtk-widget-class-add-shortcut"><primary>gtk_widget_class_add_shortcut</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_add_shortcut (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                               <parameter><link linkend="GtkShortcut"><type>GtkShortcut</type></link> *shortcut</parameter>);</programlisting>
<para>Installs a shortcut in <parameter>widget_class</parameter>
. Every instance created for
<parameter>widget_class</parameter>
 or its subclasses will inherit this shortcut and
trigger it.</para>
<para>Shortcuts added this way will be triggered in the <parameter>GTK_PHASE_BUBBLE</parameter>

phase, which means they may also trigger if child widgets have focus.</para>
<para>This function must only be used in class initialization functions
otherwise it is not guaranteed that the shortcut will be installed.</para>
<refsect3 id="gtk-widget-class-add-shortcut.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>the class to add the shortcut to</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>shortcut</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkShortcut"><type>GtkShortcut</type></link> to add. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-add-binding" role="function">
<title>gtk_widget_class_add_binding&#160;()</title>
<indexterm zone="gtk-widget-class-add-binding"><primary>gtk_widget_class_add_binding</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_add_binding (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                              <parameter><link linkend="guint"><type>guint</type></link> keyval</parameter>,
                              <parameter><link linkend="GdkModifierType"><type>GdkModifierType</type></link> mods</parameter>,
                              <parameter><link linkend="GtkShortcutFunc"><type>GtkShortcutFunc</type></link> callback</parameter>,
                              <parameter>const <link linkend="gchar"><type>gchar</type></link> *format_string</parameter>,
                              <parameter>...</parameter>);</programlisting>
<para>Creates a new shortcut for <parameter>widget_class</parameter>
 that calls the given <parameter>callback</parameter>

with arguments read according to <parameter>format_string</parameter>
.
The arguments and format string must be provided in the same way as
with <link linkend="g-variant-new"><function>g_variant_new()</function></link>.</para>
<para>This function is a convenience wrapper around
<link linkend="gtk-widget-class-add-shortcut"><function>gtk_widget_class_add_shortcut()</function></link> and must be called during class
initialization. It does not provide for user_data, if you need that,
you will have to use <link linkend="gtk-widget-class-add-shortcut"><function>gtk_widget_class_add_shortcut()</function></link> with a custom
shortcut.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="gtk-widget-class-add-binding.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>the class to add the binding to</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>keyval</para></entry>
<entry role="parameter_description"><para>key value of binding to install</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>mods</para></entry>
<entry role="parameter_description"><para>key modifier of binding to install</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>callback</para></entry>
<entry role="parameter_description"><para>the callback to call upon activation</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>format_string</para></entry>
<entry role="parameter_description"><para>GVariant format string for arguments or <link linkend="NULL:CAPS"><literal>NULL</literal></link> for
no arguments</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>...</para></entry>
<entry role="parameter_description"><para>arguments, as given by format string.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-add-binding-signal" role="function">
<title>gtk_widget_class_add_binding_signal&#160;()</title>
<indexterm zone="gtk-widget-class-add-binding-signal"><primary>gtk_widget_class_add_binding_signal</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_add_binding_signal (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                                     <parameter><link linkend="guint"><type>guint</type></link> keyval</parameter>,
                                     <parameter><link linkend="GdkModifierType"><type>GdkModifierType</type></link> mods</parameter>,
                                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *signal</parameter>,
                                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *format_string</parameter>,
                                     <parameter>...</parameter>);</programlisting>
<para>Creates a new shortcut for <parameter>widget_class</parameter>
 that emits the given action
<parameter>signal</parameter>
 with arguments read according to <parameter>format_string</parameter>
.
The arguments and format string must be provided in the same way as
with <link linkend="g-variant-new"><function>g_variant_new()</function></link>.</para>
<para>This function is a convenience wrapper around
<link linkend="gtk-widget-class-add-shortcut"><function>gtk_widget_class_add_shortcut()</function></link> and must be called during class
initialization.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="gtk-widget-class-add-binding-signal.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>the class to add the binding to</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>keyval</para></entry>
<entry role="parameter_description"><para>key value of binding to install</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>mods</para></entry>
<entry role="parameter_description"><para>key modifier of binding to install</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>signal</para></entry>
<entry role="parameter_description"><para>the signal to execute</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>format_string</para></entry>
<entry role="parameter_description"><para>GVariant format string for arguments or <link linkend="NULL:CAPS"><literal>NULL</literal></link> for
no arguments</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>...</para></entry>
<entry role="parameter_description"><para>arguments, as given by format string.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-add-binding-action" role="function">
<title>gtk_widget_class_add_binding_action&#160;()</title>
<indexterm zone="gtk-widget-class-add-binding-action"><primary>gtk_widget_class_add_binding_action</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_add_binding_action (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                                     <parameter><link linkend="guint"><type>guint</type></link> keyval</parameter>,
                                     <parameter><link linkend="GdkModifierType"><type>GdkModifierType</type></link> mods</parameter>,
                                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *action_name</parameter>,
                                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *format_string</parameter>,
                                     <parameter>...</parameter>);</programlisting>
<para>Creates a new shortcut for <parameter>widget_class</parameter>
 that activates the given
<parameter>action_name</parameter>
 with arguments read according to <parameter>format_string</parameter>
.
The arguments and format string must be provided in the same way as
with <link linkend="g-variant-new"><function>g_variant_new()</function></link>.</para>
<para>This function is a convenience wrapper around
<link linkend="gtk-widget-class-add-shortcut"><function>gtk_widget_class_add_shortcut()</function></link> and must be called during class
initialization.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="gtk-widget-class-add-binding-action.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>the class to add the binding to</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>keyval</para></entry>
<entry role="parameter_description"><para>key value of binding to install</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>mods</para></entry>
<entry role="parameter_description"><para>key modifier of binding to install</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>action_name</para></entry>
<entry role="parameter_description"><para>the action to activate</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>format_string</para></entry>
<entry role="parameter_description"><para>GVariant format string for arguments or <link linkend="NULL:CAPS"><literal>NULL</literal></link> for
no arguments</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>...</para></entry>
<entry role="parameter_description"><para>arguments, as given by format string.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-set-layout-manager-type" role="function">
<title>gtk_widget_class_set_layout_manager_type&#160;()</title>
<indexterm zone="gtk-widget-class-set-layout-manager-type"><primary>gtk_widget_class_set_layout_manager_type</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_set_layout_manager_type
                               (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                                <parameter><link linkend="GType"><type>GType</type></link> type</parameter>);</programlisting>
<para>Sets the type to be used for creating layout managers for widgets of
<parameter>widget_class</parameter>
. The given <parameter>type</parameter>
 must be a subtype of <link linkend="GtkLayoutManager"><type>GtkLayoutManager</type></link>.</para>
<para>This function should only be called from class init functions of widgets.</para>
<refsect3 id="gtk-widget-class-set-layout-manager-type.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>class to set the layout manager type for</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>type</para></entry>
<entry role="parameter_description"><para>The object type that implements the <link linkend="GtkLayoutManager"><type>GtkLayoutManager</type></link> for <parameter>widget_class</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-get-layout-manager-type" role="function">
<title>gtk_widget_class_get_layout_manager_type&#160;()</title>
<indexterm zone="gtk-widget-class-get-layout-manager-type"><primary>gtk_widget_class_get_layout_manager_type</primary></indexterm>
<programlisting language="C"><link linkend="GType"><returnvalue>GType</returnvalue></link>
gtk_widget_class_get_layout_manager_type
                               (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>);</programlisting>
<para>Retrieves the type of the <link linkend="GtkLayoutManager"><type>GtkLayoutManager</type></link> used by the <link linkend="GtkWidget"><type>GtkWidget</type></link> class.</para>
<para>See also: <link linkend="gtk-widget-class-set-layout-manager-type"><function>gtk_widget_class_set_layout_manager_type()</function></link></para>
<refsect3 id="gtk-widget-class-get-layout-manager-type.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-class-get-layout-manager-type.returns" role="returns">
<title>Returns</title>
<para> a <link linkend="GtkLayoutManager"><type>GtkLayoutManager</type></link> subclass, or <link linkend="G-TYPE-INVALID:CAPS"><literal>G_TYPE_INVALID</literal></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-activate" role="function">
<title>gtk_widget_activate&#160;()</title>
<indexterm zone="gtk-widget-activate"><primary>gtk_widget_activate</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_activate (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>For widgets that can be “activated” (buttons, menu items, etc.)
this function activates them. Activation is what happens when you
press Enter on a widget during key navigation. If <parameter>widget</parameter>
 isn't
activatable, the function returns <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.</para>
<refsect3 id="gtk-widget-activate.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link> that’s activatable</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-activate.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the widget was activatable</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-is-focus" role="function">
<title>gtk_widget_is_focus&#160;()</title>
<indexterm zone="gtk-widget-is-focus"><primary>gtk_widget_is_focus</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_is_focus (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Determines if the widget is the focus widget within its
toplevel. (This does not mean that the <link linkend="GtkWidget--has-focus"><type>“has-focus”</type></link> property is
necessarily set; <link linkend="GtkWidget--has-focus"><type>“has-focus”</type></link> will only be set if the
toplevel widget additionally has the global input focus.)</para>
<refsect3 id="gtk-widget-is-focus.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-is-focus.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the widget is the focus widget.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-grab-focus" role="function">
<title>gtk_widget_grab_focus&#160;()</title>
<indexterm zone="gtk-widget-grab-focus"><primary>gtk_widget_grab_focus</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_grab_focus (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Causes <parameter>widget</parameter>
 (or one of its descendents) to have the keyboard focus
for the <link linkend="GtkWindow"><type>GtkWindow</type></link> it's inside.</para>
<para>If <parameter>widget</parameter>
 is not focusable, or its ::grab_focus implementation cannot
transfer the focus to a descendant of <parameter>widget</parameter>
 that is focusable, it will
not take focus and <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> will be returned.</para>
<para>Calling <link linkend="gtk-widget-grab-focus"><function>gtk_widget_grab_focus()</function></link> on an already focused widget is allowed,
should not have an effect, and return <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>.</para>
<refsect3 id="gtk-widget-grab-focus.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-grab-focus.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if focus is now inside <parameter>widget</parameter>
.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-name" role="function">
<title>gtk_widget_set_name&#160;()</title>
<indexterm zone="gtk-widget-set-name"><primary>gtk_widget_set_name</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_name (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>);</programlisting>
<para>Widgets can be named, which allows you to refer to them from a
CSS file. You can apply a style to widgets with a particular name
in the CSS file. See the documentation for the CSS syntax (on the
same page as the docs for <link linkend="GtkStyleContext"><type>GtkStyleContext</type></link>).</para>
<para>Note that the CSS syntax has certain special characters to delimit
and represent elements in a selector (period, #, &gt;, *...), so using
these will make your widget impossible to match by name. Any combination
of alphanumeric symbols, dashes and underscores will suffice.</para>
<refsect3 id="gtk-widget-set-name.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>name for the widget</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-name" role="function">
<title>gtk_widget_get_name&#160;()</title>
<indexterm zone="gtk-widget-get-name"><primary>gtk_widget_get_name</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gtk_widget_get_name (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Retrieves the name of a widget. See <link linkend="gtk-widget-set-name"><function>gtk_widget_set_name()</function></link> for the
significance of widget names.</para>
<refsect3 id="gtk-widget-get-name.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-name.returns" role="returns">
<title>Returns</title>
<para> name of the widget. This string is owned by GTK+ and
should not be modified or freed</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-sensitive" role="function">
<title>gtk_widget_set_sensitive&#160;()</title>
<indexterm zone="gtk-widget-set-sensitive"><primary>gtk_widget_set_sensitive</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_sensitive (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                          <parameter><link linkend="gboolean"><type>gboolean</type></link> sensitive</parameter>);</programlisting>
<para>Sets the sensitivity of a widget. A widget is sensitive if the user
can interact with it. Insensitive widgets are “grayed out” and the
user can’t interact with them. Insensitive widgets are known as
“inactive”, “disabled”, or “ghosted” in some other toolkits.</para>
<refsect3 id="gtk-widget-set-sensitive.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>sensitive</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> to make the widget sensitive</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-parent" role="function">
<title>gtk_widget_set_parent&#160;()</title>
<indexterm zone="gtk-widget-set-parent"><primary>gtk_widget_set_parent</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_parent (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                       <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *parent</parameter>);</programlisting>
<para>This function is useful only when implementing subclasses of
<link linkend="GtkWidget"><type>GtkWidget</type></link>.
Sets <parameter>parent</parameter>
 as the parent widget of <parameter>widget</parameter>
, and takes care of
some details such as updating the state and style of the child
to reflect its new location and resizing the parent. The opposite
function is <link linkend="gtk-widget-unparent"><function>gtk_widget_unparent()</function></link>.</para>
<refsect3 id="gtk-widget-set-parent.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>parent</para></entry>
<entry role="parameter_description"><para>parent widget</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-root" role="function">
<title>gtk_widget_get_root&#160;()</title>
<indexterm zone="gtk-widget-get-root"><primary>gtk_widget_get_root</primary></indexterm>
<programlisting language="C"><link linkend="GtkRoot"><returnvalue>GtkRoot</returnvalue></link>&#160;*
gtk_widget_get_root (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the <link linkend="GtkRoot"><type>GtkRoot</type></link> widget of <parameter>widget</parameter>
 or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the widget is not contained
inside a widget tree with a root widget.</para>
<para><link linkend="GtkRoot"><type>GtkRoot</type></link> widgets will return themselves here.</para>
<refsect3 id="gtk-widget-get-root.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-root.returns" role="returns">
<title>Returns</title>
<para>the root widget of <parameter>widget</parameter>
, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-native" role="function">
<title>gtk_widget_get_native&#160;()</title>
<indexterm zone="gtk-widget-get-native"><primary>gtk_widget_get_native</primary></indexterm>
<programlisting language="C"><link linkend="GtkNative"><returnvalue>GtkNative</returnvalue></link>&#160;*
gtk_widget_get_native (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the GtkNative widget that contains <parameter>widget</parameter>
,
or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the widget is not contained inside a
widget tree with a native ancestor.</para>
<para><link linkend="GtkNative"><type>GtkNative</type></link> widgets will return themselves here.</para>
<refsect3 id="gtk-widget-get-native.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-native.returns" role="returns">
<title>Returns</title>
<para>the <link linkend="GtkNative"><type>GtkNative</type></link>
widget of <parameter>widget</parameter>
, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-ancestor" role="function">
<title>gtk_widget_get_ancestor&#160;()</title>
<indexterm zone="gtk-widget-get-ancestor"><primary>gtk_widget_get_ancestor</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_widget_get_ancestor (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                         <parameter><link linkend="GType"><type>GType</type></link> widget_type</parameter>);</programlisting>
<para>Gets the first ancestor of <parameter>widget</parameter>
 with type <parameter>widget_type</parameter>
. For example,
<literal>gtk_widget_get_ancestor (widget, GTK_TYPE_BOX)</literal> gets
the first <link linkend="GtkBox"><type>GtkBox</type></link> that’s an ancestor of <parameter>widget</parameter>
. No reference will be
added to the returned widget; it should not be unreferenced.</para>
<para>Note that unlike <link linkend="gtk-widget-is-ancestor"><function>gtk_widget_is_ancestor()</function></link>, <link linkend="gtk-widget-get-ancestor"><function>gtk_widget_get_ancestor()</function></link>
considers <parameter>widget</parameter>
 to be an ancestor of itself.</para>
<refsect3 id="gtk-widget-get-ancestor.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget_type</para></entry>
<entry role="parameter_description"><para>ancestor type</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-ancestor.returns" role="returns">
<title>Returns</title>
<para>the ancestor widget, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if not found. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-is-ancestor" role="function">
<title>gtk_widget_is_ancestor&#160;()</title>
<indexterm zone="gtk-widget-is-ancestor"><primary>gtk_widget_is_ancestor</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_is_ancestor (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                        <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *ancestor</parameter>);</programlisting>
<para>Determines whether <parameter>widget</parameter>
 is somewhere inside <parameter>ancestor</parameter>
, possibly with
intermediate containers.</para>
<refsect3 id="gtk-widget-is-ancestor.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>ancestor</para></entry>
<entry role="parameter_description"><para>another <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-is-ancestor.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>ancestor</parameter>
contains <parameter>widget</parameter>
as a child,
grandchild, great grandchild, etc.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-translate-coordinates" role="function">
<title>gtk_widget_translate_coordinates&#160;()</title>
<indexterm zone="gtk-widget-translate-coordinates"><primary>gtk_widget_translate_coordinates</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_translate_coordinates (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *src_widget</parameter>,
                                  <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *dest_widget</parameter>,
                                  <parameter><link linkend="double"><type>double</type></link> src_x</parameter>,
                                  <parameter><link linkend="double"><type>double</type></link> src_y</parameter>,
                                  <parameter><link linkend="double"><type>double</type></link> *dest_x</parameter>,
                                  <parameter><link linkend="double"><type>double</type></link> *dest_y</parameter>);</programlisting>
<para>Translate coordinates relative to <parameter>src_widget</parameter>
’s allocation to coordinates
relative to <parameter>dest_widget</parameter>
’s allocations. In order to perform this
operation, both widget must share a common toplevel.</para>
<refsect3 id="gtk-widget-translate-coordinates.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>src_widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>dest_widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>src_x</para></entry>
<entry role="parameter_description"><para>X position relative to <parameter>src_widget</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>src_y</para></entry>
<entry role="parameter_description"><para>Y position relative to <parameter>src_widget</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>dest_x</para></entry>
<entry role="parameter_description"><para>location to store X position relative to <parameter>dest_widget</parameter>
. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>dest_y</para></entry>
<entry role="parameter_description"><para>location to store Y position relative to <parameter>dest_widget</parameter>
. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-translate-coordinates.returns" role="returns">
<title>Returns</title>
<para> <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if <parameter>src_widget</parameter>
and <parameter>dest_widget</parameter>
have no common
ancestor. In this case, 0 is stored in
*<parameter>dest_x</parameter>
and *<parameter>dest_y</parameter>
. Otherwise <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-add-controller" role="function">
<title>gtk_widget_add_controller&#160;()</title>
<indexterm zone="gtk-widget-add-controller"><primary>gtk_widget_add_controller</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_add_controller (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                           <parameter><link linkend="GtkEventController"><type>GtkEventController</type></link> *controller</parameter>);</programlisting>
<para>Adds <parameter>controller</parameter>
 to <parameter>widget</parameter>
 so that it will receive events. You will
usually want to call this function right after creating any kind of
<link linkend="GtkEventController"><type>GtkEventController</type></link>.</para>
<refsect3 id="gtk-widget-add-controller.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>controller</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEventController"><type>GtkEventController</type></link> that hasn't been
added to a widget yet. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-remove-controller" role="function">
<title>gtk_widget_remove_controller&#160;()</title>
<indexterm zone="gtk-widget-remove-controller"><primary>gtk_widget_remove_controller</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_remove_controller (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                              <parameter><link linkend="GtkEventController"><type>GtkEventController</type></link> *controller</parameter>);</programlisting>
<para>Removes <parameter>controller</parameter>
 from <parameter>widget</parameter>
, so that it doesn't process
events anymore. It should not be used again.</para>
<para>Widgets will remove all event controllers automatically when they
are destroyed, there is normally no need to call this function.</para>
<refsect3 id="gtk-widget-remove-controller.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>controller</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkEventController"><type>GtkEventController</type></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-direction" role="function">
<title>gtk_widget_set_direction&#160;()</title>
<indexterm zone="gtk-widget-set-direction"><primary>gtk_widget_set_direction</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_direction (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                          <parameter><link linkend="GtkTextDirection"><type>GtkTextDirection</type></link> dir</parameter>);</programlisting>
<para>Sets the reading direction on a particular widget. This direction
controls the primary direction for widgets containing text,
and also the direction in which the children of a container are
packed. The ability to set the direction is present in order
so that correct localization into languages with right-to-left
reading directions can be done. Generally, applications will
let the default reading direction present, except for containers
where the containers are arranged in an order that is explicitly
visual rather than logical (such as buttons for text justification).</para>
<para>If the direction is set to <link linkend="GTK-TEXT-DIR-NONE:CAPS"><literal>GTK_TEXT_DIR_NONE</literal></link>, then the value
set by <link linkend="gtk-widget-set-default-direction"><function>gtk_widget_set_default_direction()</function></link> will be used.</para>
<refsect3 id="gtk-widget-set-direction.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>dir</para></entry>
<entry role="parameter_description"><para>the new direction</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-direction" role="function">
<title>gtk_widget_get_direction&#160;()</title>
<indexterm zone="gtk-widget-get-direction"><primary>gtk_widget_get_direction</primary></indexterm>
<programlisting language="C"><link linkend="GtkTextDirection"><returnvalue>GtkTextDirection</returnvalue></link>
gtk_widget_get_direction (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets the reading direction for a particular widget. See
<link linkend="gtk-widget-set-direction"><function>gtk_widget_set_direction()</function></link>.</para>
<refsect3 id="gtk-widget-get-direction.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-direction.returns" role="returns">
<title>Returns</title>
<para> the reading direction for the widget.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-default-direction" role="function">
<title>gtk_widget_set_default_direction&#160;()</title>
<indexterm zone="gtk-widget-set-default-direction"><primary>gtk_widget_set_default_direction</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_default_direction (<parameter><link linkend="GtkTextDirection"><type>GtkTextDirection</type></link> dir</parameter>);</programlisting>
<para>Sets the default reading direction for widgets where the
direction has not been explicitly set by <link linkend="gtk-widget-set-direction"><function>gtk_widget_set_direction()</function></link>.</para>
<refsect3 id="gtk-widget-set-default-direction.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>dir</para></entry>
<entry role="parameter_description"><para>the new default direction. This cannot be
<link linkend="GTK-TEXT-DIR-NONE:CAPS"><literal>GTK_TEXT_DIR_NONE</literal></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-default-direction" role="function">
<title>gtk_widget_get_default_direction&#160;()</title>
<indexterm zone="gtk-widget-get-default-direction"><primary>gtk_widget_get_default_direction</primary></indexterm>
<programlisting language="C"><link linkend="GtkTextDirection"><returnvalue>GtkTextDirection</returnvalue></link>
gtk_widget_get_default_direction (<parameter><type>void</type></parameter>);</programlisting>
<para>Obtains the current default reading direction. See
<link linkend="gtk-widget-set-default-direction"><function>gtk_widget_set_default_direction()</function></link>.</para>
<refsect3 id="gtk-widget-get-default-direction.returns" role="returns">
<title>Returns</title>
<para> the current default direction.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-create-pango-context" role="function">
<title>gtk_widget_create_pango_context&#160;()</title>
<indexterm zone="gtk-widget-create-pango-context"><primary>gtk_widget_create_pango_context</primary></indexterm>
<programlisting language="C"><link linkend="PangoContext"><returnvalue>PangoContext</returnvalue></link>&#160;*
gtk_widget_create_pango_context (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Creates a new <link linkend="PangoContext"><type>PangoContext</type></link> with the appropriate font map,
font options, font description, and base direction for drawing
text for this widget. See also <link linkend="gtk-widget-get-pango-context"><function>gtk_widget_get_pango_context()</function></link>.</para>
<refsect3 id="gtk-widget-create-pango-context.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-create-pango-context.returns" role="returns">
<title>Returns</title>
<para>the new <link linkend="PangoContext"><type>PangoContext</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-pango-context" role="function">
<title>gtk_widget_get_pango_context&#160;()</title>
<indexterm zone="gtk-widget-get-pango-context"><primary>gtk_widget_get_pango_context</primary></indexterm>
<programlisting language="C"><link linkend="PangoContext"><returnvalue>PangoContext</returnvalue></link>&#160;*
gtk_widget_get_pango_context (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets a <link linkend="PangoContext"><type>PangoContext</type></link> with the appropriate font map, font description,
and base direction for this widget. Unlike the context returned
by <link linkend="gtk-widget-create-pango-context"><function>gtk_widget_create_pango_context()</function></link>, this context is owned by
the widget (it can be used until the screen for the widget changes
or the widget is removed from its toplevel), and will be updated to
match any changes to the widget’s attributes. This can be tracked
by listening to changes of the <link linkend="GtkWidget--root"><type>“root”</type></link> property on the widget.</para>
<refsect3 id="gtk-widget-get-pango-context.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-pango-context.returns" role="returns">
<title>Returns</title>
<para>the <link linkend="PangoContext"><type>PangoContext</type></link> for the widget. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-font-options" role="function">
<title>gtk_widget_set_font_options&#160;()</title>
<indexterm zone="gtk-widget-set-font-options"><primary>gtk_widget_set_font_options</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_font_options (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                             <parameter>const <link linkend="cairo-font-options-t"><type>cairo_font_options_t</type></link> *options</parameter>);</programlisting>
<para>Sets the <link linkend="cairo-font-options-t"><type>cairo_font_options_t</type></link> used for Pango rendering in this widget.
When not set, the default font options for the <link linkend="GdkDisplay"><type>GdkDisplay</type></link> will be used.</para>
<refsect3 id="gtk-widget-set-font-options.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>options</para></entry>
<entry role="parameter_description"><para>a <link linkend="cairo-font-options-t"><type>cairo_font_options_t</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to unset any
previously set default font options. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-font-options" role="function">
<title>gtk_widget_get_font_options&#160;()</title>
<indexterm zone="gtk-widget-get-font-options"><primary>gtk_widget_get_font_options</primary></indexterm>
<programlisting language="C">const <link linkend="cairo-font-options-t"><returnvalue>cairo_font_options_t</returnvalue></link>&#160;*
gtk_widget_get_font_options (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the <link linkend="cairo-font-options-t"><type>cairo_font_options_t</type></link> used for Pango rendering. When not set,
the defaults font options for the <link linkend="GdkDisplay"><type>GdkDisplay</type></link> will be used.</para>
<refsect3 id="gtk-widget-get-font-options.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-font-options.returns" role="returns">
<title>Returns</title>
<para>the <link linkend="cairo-font-options-t"><type>cairo_font_options_t</type></link> or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if not set. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-font-map" role="function">
<title>gtk_widget_set_font_map&#160;()</title>
<indexterm zone="gtk-widget-set-font-map"><primary>gtk_widget_set_font_map</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_font_map (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                         <parameter><link linkend="PangoFontMap"><type>PangoFontMap</type></link> *font_map</parameter>);</programlisting>
<para>Sets the font map to use for Pango rendering. When not set, the widget
will inherit the font map from its parent.</para>
<refsect3 id="gtk-widget-set-font-map.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>font_map</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFontMap"><type>PangoFontMap</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to unset any previously
set font map. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-font-map" role="function">
<title>gtk_widget_get_font_map&#160;()</title>
<indexterm zone="gtk-widget-get-font-map"><primary>gtk_widget_get_font_map</primary></indexterm>
<programlisting language="C"><link linkend="PangoFontMap"><returnvalue>PangoFontMap</returnvalue></link>&#160;*
gtk_widget_get_font_map (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets the font map that has been set with <link linkend="gtk-widget-set-font-map"><function>gtk_widget_set_font_map()</function></link>.</para>
<refsect3 id="gtk-widget-get-font-map.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-font-map.returns" role="returns">
<title>Returns</title>
<para>A <link linkend="PangoFontMap"><type>PangoFontMap</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-create-pango-layout" role="function">
<title>gtk_widget_create_pango_layout&#160;()</title>
<indexterm zone="gtk-widget-create-pango-layout"><primary>gtk_widget_create_pango_layout</primary></indexterm>
<programlisting language="C"><link linkend="PangoLayout"><returnvalue>PangoLayout</returnvalue></link>&#160;*
gtk_widget_create_pango_layout (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *text</parameter>);</programlisting>
<para>Creates a new <link linkend="PangoLayout"><type>PangoLayout</type></link> with the appropriate font map,
font description, and base direction for drawing text for
this widget.</para>
<para>If you keep a <link linkend="PangoLayout"><type>PangoLayout</type></link> created in this way around, you need
to re-create it when the widget <link linkend="PangoContext"><type>PangoContext</type></link> is replaced.
This can be tracked by listening to changes of the <link linkend="GtkWidget--root"><type>“root”</type></link> property
on the widget.</para>
<refsect3 id="gtk-widget-create-pango-layout.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>text</para></entry>
<entry role="parameter_description"><para>text to set on the layout (can be <link linkend="NULL:CAPS"><literal>NULL</literal></link>). </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-create-pango-layout.returns" role="returns">
<title>Returns</title>
<para>the new <link linkend="PangoLayout"><type>PangoLayout</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-cursor" role="function">
<title>gtk_widget_get_cursor&#160;()</title>
<indexterm zone="gtk-widget-get-cursor"><primary>gtk_widget_get_cursor</primary></indexterm>
<programlisting language="C"><link linkend="GdkCursor"><returnvalue>GdkCursor</returnvalue></link>&#160;*
gtk_widget_get_cursor (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Queries the cursor set via <link linkend="gtk-widget-set-cursor"><function>gtk_widget_set_cursor()</function></link>. See that function for
details.</para>
<refsect3 id="gtk-widget-get-cursor.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-cursor.returns" role="returns">
<title>Returns</title>
<para>the cursor currently in use or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
to use the default. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-cursor" role="function">
<title>gtk_widget_set_cursor&#160;()</title>
<indexterm zone="gtk-widget-set-cursor"><primary>gtk_widget_set_cursor</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_cursor (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                       <parameter><link linkend="GdkCursor"><type>GdkCursor</type></link> *cursor</parameter>);</programlisting>
<para>Sets the cursor to be shown when pointer devices point towards <parameter>widget</parameter>
.</para>
<para>If the <parameter>cursor</parameter>
 is NULL, <parameter>widget</parameter>
 will use the cursor inherited from the
parent widget.</para>
<refsect3 id="gtk-widget-set-cursor.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>cursor</para></entry>
<entry role="parameter_description"><para>the new cursor or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to use the default
cursor. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-cursor-from-name" role="function">
<title>gtk_widget_set_cursor_from_name&#160;()</title>
<indexterm zone="gtk-widget-set-cursor-from-name"><primary>gtk_widget_set_cursor_from_name</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_cursor_from_name (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                 <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>);</programlisting>
<para>Sets a named cursor to be shown when pointer devices point towards <parameter>widget</parameter>
.</para>
<para>This is a utility function that creates a cursor via
<link linkend="gdk-cursor-new-from-name"><function>gdk_cursor_new_from_name()</function></link> and then sets it on <parameter>widget</parameter>
 with
<link linkend="gtk-widget-set-cursor"><function>gtk_widget_set_cursor()</function></link>. See those 2 functions for details.</para>
<para>On top of that, this function allows <parameter>name</parameter>
 to be <link linkend="NULL:CAPS"><literal>NULL</literal></link>, which will
do the same as calling <link linkend="gtk-widget-set-cursor"><function>gtk_widget_set_cursor()</function></link> with a <link linkend="NULL:CAPS"><literal>NULL</literal></link> cursor.</para>
<refsect3 id="gtk-widget-set-cursor-from-name.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>The name of the cursor or <link linkend="NULL:CAPS"><literal>NULL</literal></link> to use the default
cursor. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-mnemonic-activate" role="function">
<title>gtk_widget_mnemonic_activate&#160;()</title>
<indexterm zone="gtk-widget-mnemonic-activate"><primary>gtk_widget_mnemonic_activate</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_mnemonic_activate (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                              <parameter><link linkend="gboolean"><type>gboolean</type></link> group_cycling</parameter>);</programlisting>
<para>Emits the <link linkend="GtkWidget-mnemonic-activate"><type>“mnemonic-activate”</type></link> signal.</para>
<refsect3 id="gtk-widget-mnemonic-activate.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>group_cycling</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if there are other widgets with the same mnemonic</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-mnemonic-activate.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the signal has been handled</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-set-accessible-type" role="function">
<title>gtk_widget_class_set_accessible_type&#160;()</title>
<indexterm zone="gtk-widget-class-set-accessible-type"><primary>gtk_widget_class_set_accessible_type</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_set_accessible_type (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                                      <parameter><link linkend="GType"><type>GType</type></link> type</parameter>);</programlisting>
<para>Sets the type to be used for creating accessibles for widgets of
<parameter>widget_class</parameter>
. The given <parameter>type</parameter>
 must be a subtype of the type used for
accessibles of the parent class.</para>
<para>This function should only be called from class init functions of widgets.</para>
<refsect3 id="gtk-widget-class-set-accessible-type.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>class to set the accessible type for</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>type</para></entry>
<entry role="parameter_description"><para>The object type that implements the accessible for <parameter>widget_class</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-set-accessible-role" role="function">
<title>gtk_widget_class_set_accessible_role&#160;()</title>
<indexterm zone="gtk-widget-class-set-accessible-role"><primary>gtk_widget_class_set_accessible_role</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_set_accessible_role (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                                      <parameter><link linkend="AtkRole"><type>AtkRole</type></link> role</parameter>);</programlisting>
<para>Sets the default <link linkend="AtkRole"><type>AtkRole</type></link> to be set on accessibles created for
widgets of <parameter>widget_class</parameter>
. Accessibles may decide to not honor this
setting if their role reporting is more refined. Calls to 
<link linkend="gtk-widget-class-set-accessible-type"><function>gtk_widget_class_set_accessible_type()</function></link> will reset this value.</para>
<para>In cases where you want more fine-grained control over the role of
accessibles created for <parameter>widget_class</parameter>
, you should provide your own
accessible type and use <link linkend="gtk-widget-class-set-accessible-type"><function>gtk_widget_class_set_accessible_type()</function></link>
instead.</para>
<para>If <parameter>role</parameter>
 is <link linkend="ATK-ROLE-INVALID:CAPS"><type>ATK_ROLE_INVALID</type></link>, the default role will not be changed
and the accessible’s default role will be used instead.</para>
<para>This function should only be called from class init functions of widgets.</para>
<refsect3 id="gtk-widget-class-set-accessible-role.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>class to set the accessible role for</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>role</para></entry>
<entry role="parameter_description"><para>The role to use for accessibles created for <parameter>widget_class</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-accessible" role="function">
<title>gtk_widget_get_accessible&#160;()</title>
<indexterm zone="gtk-widget-get-accessible"><primary>gtk_widget_get_accessible</primary></indexterm>
<programlisting language="C"><link linkend="AtkObject"><returnvalue>AtkObject</returnvalue></link>&#160;*
gtk_widget_get_accessible (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the accessible object that describes the widget to an
assistive technology.</para>
<para>If accessibility support is not available, this <link linkend="AtkObject"><type>AtkObject</type></link>
instance may be a no-op. Likewise, if no class-specific <link linkend="AtkObject"><type>AtkObject</type></link>
implementation is available for the widget instance in question,
it will inherit an <link linkend="AtkObject"><type>AtkObject</type></link> implementation from the first ancestor
class for which such an implementation is defined.</para>
<para>The documentation of the
<ulink url="http://developer.gnome.org/atk/stable/">ATK</ulink>
library contains more information about accessible objects and their uses.</para>
<refsect3 id="gtk-widget-get-accessible.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-accessible.returns" role="returns">
<title>Returns</title>
<para>the <link linkend="AtkObject"><type>AtkObject</type></link> associated with <parameter>widget</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-child-focus" role="function">
<title>gtk_widget_child_focus&#160;()</title>
<indexterm zone="gtk-widget-child-focus"><primary>gtk_widget_child_focus</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_child_focus (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                        <parameter><link linkend="GtkDirectionType"><type>GtkDirectionType</type></link> direction</parameter>);</programlisting>
<para>This function is used by custom widget implementations; if you're
writing an app, you’d use <link linkend="gtk-widget-grab-focus"><function>gtk_widget_grab_focus()</function></link> to move the focus
to a particular widget.</para>
<para>gtk_widget_child_focus() is called by widgets as the user moves
around the window using keyboard shortcuts. <parameter>direction</parameter>
 indicates
what kind of motion is taking place (up, down, left, right, tab
forward, tab backward). <link linkend="gtk-widget-child-focus"><function>gtk_widget_child_focus()</function></link> emits the
<link linkend="GtkWidget-focus"><type>“focus”</type></link> signal; widgets override the default handler
for this signal in order to implement appropriate focus behavior.</para>
<para>The default ::focus handler for a widget should return <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if
moving in <parameter>direction</parameter>
 left the focus on a focusable location inside
that widget, and <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if moving in <parameter>direction</parameter>
 moved the focus
outside the widget. If returning <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, widgets normally
call <link linkend="gtk-widget-grab-focus"><function>gtk_widget_grab_focus()</function></link> to place the focus accordingly;
if returning <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>, they don’t modify the current focus location.</para>
<refsect3 id="gtk-widget-child-focus.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>direction</para></entry>
<entry role="parameter_description"><para>direction of focus movement</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-child-focus.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if focus ended up inside <parameter>widget</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-child-visible" role="function">
<title>gtk_widget_get_child_visible&#160;()</title>
<indexterm zone="gtk-widget-get-child-visible"><primary>gtk_widget_get_child_visible</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_child_visible (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets the value set with <link linkend="gtk-widget-set-child-visible"><function>gtk_widget_set_child_visible()</function></link>.
If you feel a need to use this function, your code probably
needs reorganization.</para>
<para>This function is only useful for container implementations and
never should be called by an application.</para>
<refsect3 id="gtk-widget-get-child-visible.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-child-visible.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the widget is mapped with the parent.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-parent" role="function">
<title>gtk_widget_get_parent&#160;()</title>
<indexterm zone="gtk-widget-get-parent"><primary>gtk_widget_get_parent</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_widget_get_parent (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the parent widget of <parameter>widget</parameter>
.</para>
<refsect3 id="gtk-widget-get-parent.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-parent.returns" role="returns">
<title>Returns</title>
<para>the parent widget of <parameter>widget</parameter>
, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-settings" role="function">
<title>gtk_widget_get_settings&#160;()</title>
<indexterm zone="gtk-widget-get-settings"><primary>gtk_widget_get_settings</primary></indexterm>
<programlisting language="C"><link linkend="GtkSettings"><returnvalue>GtkSettings</returnvalue></link>&#160;*
gtk_widget_get_settings (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets the settings object holding the settings used for this widget.</para>
<para>Note that this function can only be called when the <link linkend="GtkWidget"><type>GtkWidget</type></link>
is attached to a toplevel, since the settings object is specific
to a particular <link linkend="GdkDisplay"><type>GdkDisplay</type></link>. If you want to monitor the widget for
changes in its settings, connect to notify::display.</para>
<refsect3 id="gtk-widget-get-settings.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-settings.returns" role="returns">
<title>Returns</title>
<para>the relevant <link linkend="GtkSettings"><type>GtkSettings</type></link> object. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-clipboard" role="function">
<title>gtk_widget_get_clipboard&#160;()</title>
<indexterm zone="gtk-widget-get-clipboard"><primary>gtk_widget_get_clipboard</primary></indexterm>
<programlisting language="C"><link linkend="GdkClipboard"><returnvalue>GdkClipboard</returnvalue></link>&#160;*
gtk_widget_get_clipboard (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>This is a utility function to get the clipboard object for the
<link linkend="GdkDisplay"><type>GdkDisplay</type></link> that <parameter>widget</parameter>
 is using.</para>
<para>Note that this function always works, even when <parameter>widget</parameter>
 is not
realized yet.</para>
<refsect3 id="gtk-widget-get-clipboard.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-clipboard.returns" role="returns">
<title>Returns</title>
<para>the appropriate clipboard object. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-primary-clipboard" role="function">
<title>gtk_widget_get_primary_clipboard&#160;()</title>
<indexterm zone="gtk-widget-get-primary-clipboard"><primary>gtk_widget_get_primary_clipboard</primary></indexterm>
<programlisting language="C"><link linkend="GdkClipboard"><returnvalue>GdkClipboard</returnvalue></link>&#160;*
gtk_widget_get_primary_clipboard (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>This is a utility function to get the primary clipboard object 
for the <link linkend="GdkDisplay"><type>GdkDisplay</type></link> that <parameter>widget</parameter>
 is using.</para>
<para>Note that this function always works, even when <parameter>widget</parameter>
 is not
realized yet.</para>
<refsect3 id="gtk-widget-get-primary-clipboard.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-primary-clipboard.returns" role="returns">
<title>Returns</title>
<para>the appropriate clipboard object. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-display" role="function">
<title>gtk_widget_get_display&#160;()</title>
<indexterm zone="gtk-widget-get-display"><primary>gtk_widget_get_display</primary></indexterm>
<programlisting language="C"><link linkend="GdkDisplay"><returnvalue>GdkDisplay</returnvalue></link>&#160;*
gtk_widget_get_display (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Get the <link linkend="GdkDisplay"><type>GdkDisplay</type></link> for the toplevel window associated with
this widget. This function can only be called after the widget
has been added to a widget hierarchy with a <link linkend="GtkWindow"><type>GtkWindow</type></link> at the top.</para>
<para>In general, you should only create display specific
resources when a widget has been realized, and you should
free those resources when the widget is unrealized.</para>
<refsect3 id="gtk-widget-get-display.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-display.returns" role="returns">
<title>Returns</title>
<para>the <link linkend="GdkDisplay"><type>GdkDisplay</type></link> for the toplevel for this widget. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-size-request" role="function">
<title>gtk_widget_get_size_request&#160;()</title>
<indexterm zone="gtk-widget-get-size-request"><primary>gtk_widget_get_size_request</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_get_size_request (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                             <parameter><link linkend="gint"><type>gint</type></link> *width</parameter>,
                             <parameter><link linkend="gint"><type>gint</type></link> *height</parameter>);</programlisting>
<para>Gets the size request that was explicitly set for the widget using
<link linkend="gtk-widget-set-size-request"><function>gtk_widget_set_size_request()</function></link>. A value of -1 stored in <parameter>width</parameter>
 or
<parameter>height</parameter>
 indicates that that dimension has not been set explicitly
and the natural requisition of the widget will be used instead. See
<link linkend="gtk-widget-set-size-request"><function>gtk_widget_set_size_request()</function></link>. To get the size a widget will
actually request, call <link linkend="gtk-widget-measure"><function>gtk_widget_measure()</function></link> instead of
this function.</para>
<refsect3 id="gtk-widget-get-size-request.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>width</para></entry>
<entry role="parameter_description"><para>return location for width, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>height</para></entry>
<entry role="parameter_description"><para>return location for height, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-child-visible" role="function">
<title>gtk_widget_set_child_visible&#160;()</title>
<indexterm zone="gtk-widget-set-child-visible"><primary>gtk_widget_set_child_visible</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_child_visible (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                              <parameter><link linkend="gboolean"><type>gboolean</type></link> child_visible</parameter>);</programlisting>
<para>Sets whether <parameter>widget</parameter>
 should be mapped along with its when its parent
is mapped and <parameter>widget</parameter>
 has been shown with <link linkend="gtk-widget-show"><function>gtk_widget_show()</function></link>.</para>
<para>The child visibility can be set for widget before it is added to
a container with <link linkend="gtk-widget-set-parent"><function>gtk_widget_set_parent()</function></link>, to avoid mapping
children unnecessary before immediately unmapping them. However
it will be reset to its default state of <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> when the widget
is removed from a container.</para>
<para>Note that changing the child visibility of a widget does not
queue a resize on the widget. Most of the time, the size of
a widget is computed from all visible children, whether or
not they are mapped. If this is not the case, the container
can queue a resize itself.</para>
<para>This function is only useful for container implementations and
never should be called by an application.</para>
<refsect3 id="gtk-widget-set-child-visible.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>child_visible</para></entry>
<entry role="parameter_description"><para>if <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, <parameter>widget</parameter>
should be mapped along with its parent.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-size-request" role="function">
<title>gtk_widget_set_size_request&#160;()</title>
<indexterm zone="gtk-widget-set-size-request"><primary>gtk_widget_set_size_request</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_size_request (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                             <parameter><link linkend="gint"><type>gint</type></link> width</parameter>,
                             <parameter><link linkend="gint"><type>gint</type></link> height</parameter>);</programlisting>
<para>Sets the minimum size of a widget; that is, the widget’s size
request will be at least <parameter>width</parameter>
 by <parameter>height</parameter>
. You can use this 
function to force a widget to be larger than it normally would be.</para>
<para>In most cases, <link linkend="gtk-window-set-default-size"><function>gtk_window_set_default_size()</function></link> is a better choice for
toplevel windows than this function; setting the default size will
still allow users to shrink the window. Setting the size request
will force them to leave the window at least as large as the size
request. When dealing with window sizes,
<link linkend="gtk-window-set-geometry-hints"><function>gtk_window_set_geometry_hints()</function></link> can be a useful function as well.</para>
<para>Note the inherent danger of setting any fixed size - themes,
translations into other languages, different fonts, and user action
can all change the appropriate size for a given widget. So, it's
basically impossible to hardcode a size that will always be
correct.</para>
<para>The size request of a widget is the smallest size a widget can
accept while still functioning well and drawing itself correctly.
However in some strange cases a widget may be allocated less than
its requested size, and in many cases a widget may be allocated more
space than it requested.</para>
<para>If the size request in a given direction is -1 (unset), then
the “natural” size request of the widget will be used instead.</para>
<para>The size request set here does not include any margin from the
<link linkend="GtkWidget"><type>GtkWidget</type></link> properties margin-left, margin-right, margin-top, and
margin-bottom, but it does include pretty much all other padding
or border properties set by any subclass of <link linkend="GtkWidget"><type>GtkWidget</type></link>.</para>
<refsect3 id="gtk-widget-set-size-request.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>width</para></entry>
<entry role="parameter_description"><para>width <parameter>widget</parameter>
should request, or -1 to unset</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>height</para></entry>
<entry role="parameter_description"><para>height <parameter>widget</parameter>
should request, or -1 to unset</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-list-mnemonic-labels" role="function">
<title>gtk_widget_list_mnemonic_labels&#160;()</title>
<indexterm zone="gtk-widget-list-mnemonic-labels"><primary>gtk_widget_list_mnemonic_labels</primary></indexterm>
<programlisting language="C"><link linkend="GList"><returnvalue>GList</returnvalue></link>&#160;*
gtk_widget_list_mnemonic_labels (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns a newly allocated list of the widgets, normally labels, for
which this widget is the target of a mnemonic (see for example,
<link linkend="gtk-label-set-mnemonic-widget"><function>gtk_label_set_mnemonic_widget()</function></link>).</para>
<para>The widgets in the list are not individually referenced. If you
want to iterate through the list and perform actions involving
callbacks that might destroy the widgets, you
must call <literal>g_list_foreach (result,
(GFunc)g_object_ref, NULL)</literal> first, and then unref all the
widgets afterwards.</para>
<refsect3 id="gtk-widget-list-mnemonic-labels.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-list-mnemonic-labels.returns" role="returns">
<title>Returns</title>
<para>the list of
mnemonic labels; free this list
with <link linkend="g-list-free"><function>g_list_free()</function></link> when you are done with it. </para>
<para><emphasis role="annotation">[<acronym>element-type</acronym> GtkWidget][<acronym>transfer container</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-add-mnemonic-label" role="function">
<title>gtk_widget_add_mnemonic_label&#160;()</title>
<indexterm zone="gtk-widget-add-mnemonic-label"><primary>gtk_widget_add_mnemonic_label</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_add_mnemonic_label (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                               <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *label</parameter>);</programlisting>
<para>Adds a widget to the list of mnemonic labels for
this widget. (See <link linkend="gtk-widget-list-mnemonic-labels"><function>gtk_widget_list_mnemonic_labels()</function></link>). Note the
list of mnemonic labels for the widget is cleared when the
widget is destroyed, so the caller must make sure to update
its internal state at this point as well, by using a connection
to the <link linkend="GtkWidget-destroy"><type>“destroy”</type></link> signal or a weak notifier.</para>
<refsect3 id="gtk-widget-add-mnemonic-label.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>label</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link> that acts as a mnemonic label for <parameter>widget</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-remove-mnemonic-label" role="function">
<title>gtk_widget_remove_mnemonic_label&#160;()</title>
<indexterm zone="gtk-widget-remove-mnemonic-label"><primary>gtk_widget_remove_mnemonic_label</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_remove_mnemonic_label (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                  <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *label</parameter>);</programlisting>
<para>Removes a widget from the list of mnemonic labels for
this widget. (See <link linkend="gtk-widget-list-mnemonic-labels"><function>gtk_widget_list_mnemonic_labels()</function></link>). The widget
must have previously been added to the list with
<link linkend="gtk-widget-add-mnemonic-label"><function>gtk_widget_add_mnemonic_label()</function></link>.</para>
<refsect3 id="gtk-widget-remove-mnemonic-label.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>label</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link> that was previously set as a mnemonic label for
<parameter>widget</parameter>
with <link linkend="gtk-widget-add-mnemonic-label"><function>gtk_widget_add_mnemonic_label()</function></link>.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-error-bell" role="function">
<title>gtk_widget_error_bell&#160;()</title>
<indexterm zone="gtk-widget-error-bell"><primary>gtk_widget_error_bell</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_error_bell (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Notifies the user about an input-related error on this widget.
If the <link linkend="GtkSettings--gtk-error-bell"><type>“gtk-error-bell”</type></link> setting is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, it calls
<link linkend="gdk-surface-beep"><function>gdk_surface_beep()</function></link>, otherwise it does nothing.</para>
<para>Note that the effect of <link linkend="gdk-surface-beep"><function>gdk_surface_beep()</function></link> can be configured in many
ways, depending on the windowing backend and the desktop environment
or window manager that is used.</para>
<refsect3 id="gtk-widget-error-bell.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-keynav-failed" role="function">
<title>gtk_widget_keynav_failed&#160;()</title>
<indexterm zone="gtk-widget-keynav-failed"><primary>gtk_widget_keynav_failed</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_keynav_failed (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                          <parameter><link linkend="GtkDirectionType"><type>GtkDirectionType</type></link> direction</parameter>);</programlisting>
<para>This function should be called whenever keyboard navigation within
a single widget hits a boundary. The function emits the
<link linkend="GtkWidget-keynav-failed"><type>“keynav-failed”</type></link> signal on the widget and its return
value should be interpreted in a way similar to the return value of
<link linkend="gtk-widget-child-focus"><function>gtk_widget_child_focus()</function></link>:</para>
<para>When <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> is returned, stay in the widget, the failed keyboard
navigation is OK and/or there is nowhere we can/should move the
focus to.</para>
<para>When <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is returned, the caller should continue with keyboard
navigation outside the widget, e.g. by calling
<link linkend="gtk-widget-child-focus"><function>gtk_widget_child_focus()</function></link> on the widget’s toplevel.</para>
<para>The default ::keynav-failed handler returns <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> for
<link linkend="GTK-DIR-TAB-FORWARD:CAPS"><literal>GTK_DIR_TAB_FORWARD</literal></link> and <link linkend="GTK-DIR-TAB-BACKWARD:CAPS"><literal>GTK_DIR_TAB_BACKWARD</literal></link>. For the other
values of <link linkend="GtkDirectionType"><type>GtkDirectionType</type></link> it returns <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>.</para>
<para>Whenever the default handler returns <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, it also calls
<link linkend="gtk-widget-error-bell"><function>gtk_widget_error_bell()</function></link> to notify the user of the failed keyboard
navigation.</para>
<para>A use case for providing an own implementation of ::keynav-failed
(either by connecting to it or by overriding it) would be a row of
<link linkend="GtkEntry"><type>GtkEntry</type></link> widgets where the user should be able to navigate the
entire row with the cursor keys, as e.g. known from user interfaces
that require entering license keys.</para>
<refsect3 id="gtk-widget-keynav-failed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>direction</para></entry>
<entry role="parameter_description"><para>direction of focus movement</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-keynav-failed.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if stopping keyboard navigation is fine, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>
if the emitting widget should try to handle the keyboard
navigation attempt in its parent container(s).</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-tooltip-markup" role="function">
<title>gtk_widget_get_tooltip_markup&#160;()</title>
<indexterm zone="gtk-widget-get-tooltip-markup"><primary>gtk_widget_get_tooltip_markup</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gtk_widget_get_tooltip_markup (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets the contents of the tooltip for <parameter>widget</parameter>
.</para>
<refsect3 id="gtk-widget-get-tooltip-markup.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-tooltip-markup.returns" role="returns">
<title>Returns</title>
<para>the tooltip text, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. You should free the
returned string with <link linkend="g-free"><function>g_free()</function></link> when done. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-tooltip-markup" role="function">
<title>gtk_widget_set_tooltip_markup&#160;()</title>
<indexterm zone="gtk-widget-set-tooltip-markup"><primary>gtk_widget_set_tooltip_markup</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_tooltip_markup (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                               <parameter>const <link linkend="gchar"><type>gchar</type></link> *markup</parameter>);</programlisting>
<para>Sets <parameter>markup</parameter>
 as the contents of the tooltip, which is marked up with
 the <link linkend="PangoMarkupFormat">Pango text markup language</link>.</para>
<para>This function will take care of setting <link linkend="GtkWidget--has-tooltip"><type>“has-tooltip”</type></link> to <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>
and of the default handler for the <link linkend="GtkWidget-query-tooltip"><type>“query-tooltip”</type></link> signal.</para>
<para>See also the <link linkend="GtkWidget--tooltip-markup"><type>“tooltip-markup”</type></link> property and
<link linkend="gtk-tooltip-set-markup"><function>gtk_tooltip_set_markup()</function></link>.</para>
<refsect3 id="gtk-widget-set-tooltip-markup.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>markup</para></entry>
<entry role="parameter_description"><para>the contents of the tooltip for <parameter>widget</parameter>
, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-tooltip-text" role="function">
<title>gtk_widget_get_tooltip_text&#160;()</title>
<indexterm zone="gtk-widget-get-tooltip-text"><primary>gtk_widget_get_tooltip_text</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gtk_widget_get_tooltip_text (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets the contents of the tooltip for <parameter>widget</parameter>
.</para>
<refsect3 id="gtk-widget-get-tooltip-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-tooltip-text.returns" role="returns">
<title>Returns</title>
<para>the tooltip text, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. You should free the
returned string with <link linkend="g-free"><function>g_free()</function></link> when done. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-tooltip-text" role="function">
<title>gtk_widget_set_tooltip_text&#160;()</title>
<indexterm zone="gtk-widget-set-tooltip-text"><primary>gtk_widget_set_tooltip_text</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_tooltip_text (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                             <parameter>const <link linkend="gchar"><type>gchar</type></link> *text</parameter>);</programlisting>
<para>Sets <parameter>text</parameter>
 as the contents of the tooltip. This function will take
care of setting <link linkend="GtkWidget--has-tooltip"><type>“has-tooltip”</type></link> to <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> and of the default
handler for the <link linkend="GtkWidget-query-tooltip"><type>“query-tooltip”</type></link> signal.</para>
<para>See also the <link linkend="GtkWidget--tooltip-text"><type>“tooltip-text”</type></link> property and <link linkend="gtk-tooltip-set-text"><function>gtk_tooltip_set_text()</function></link>.</para>
<refsect3 id="gtk-widget-set-tooltip-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>text</para></entry>
<entry role="parameter_description"><para>the contents of the tooltip for <parameter>widget</parameter>
. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-has-tooltip" role="function">
<title>gtk_widget_get_has_tooltip&#160;()</title>
<indexterm zone="gtk-widget-get-has-tooltip"><primary>gtk_widget_get_has_tooltip</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_has_tooltip (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the current value of the has-tooltip property.  See
<link linkend="GtkWidget--has-tooltip"><type>“has-tooltip”</type></link> for more information.</para>
<refsect3 id="gtk-widget-get-has-tooltip.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-has-tooltip.returns" role="returns">
<title>Returns</title>
<para> current value of has-tooltip on <parameter>widget</parameter>
.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-has-tooltip" role="function">
<title>gtk_widget_set_has_tooltip&#160;()</title>
<indexterm zone="gtk-widget-set-has-tooltip"><primary>gtk_widget_set_has_tooltip</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_has_tooltip (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                            <parameter><link linkend="gboolean"><type>gboolean</type></link> has_tooltip</parameter>);</programlisting>
<para>Sets the has-tooltip property on <parameter>widget</parameter>
 to <parameter>has_tooltip</parameter>
.  See
<link linkend="GtkWidget--has-tooltip"><type>“has-tooltip”</type></link> for more information.</para>
<refsect3 id="gtk-widget-set-has-tooltip.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>has_tooltip</para></entry>
<entry role="parameter_description"><para>whether or not <parameter>widget</parameter>
has a tooltip.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-trigger-tooltip-query" role="function">
<title>gtk_widget_trigger_tooltip_query&#160;()</title>
<indexterm zone="gtk-widget-trigger-tooltip-query"><primary>gtk_widget_trigger_tooltip_query</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_trigger_tooltip_query (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Triggers a tooltip query on the display where the toplevel of <parameter>widget</parameter>

is located. See <link linkend="gtk-tooltip-trigger-tooltip-query"><function>gtk_tooltip_trigger_tooltip_query()</function></link> for more
information.</para>
<refsect3 id="gtk-widget-trigger-tooltip-query.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-allocated-width" role="function">
<title>gtk_widget_get_allocated_width&#160;()</title>
<indexterm zone="gtk-widget-get-allocated-width"><primary>gtk_widget_get_allocated_width</primary></indexterm>
<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
gtk_widget_get_allocated_width (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the width that has currently been allocated to <parameter>widget</parameter>
.</para>
<refsect3 id="gtk-widget-get-allocated-width.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget to query</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-allocated-width.returns" role="returns">
<title>Returns</title>
<para> the width of the <parameter>widget</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-allocated-height" role="function">
<title>gtk_widget_get_allocated_height&#160;()</title>
<indexterm zone="gtk-widget-get-allocated-height"><primary>gtk_widget_get_allocated_height</primary></indexterm>
<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
gtk_widget_get_allocated_height (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the height that has currently been allocated to <parameter>widget</parameter>
.</para>
<refsect3 id="gtk-widget-get-allocated-height.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget to query</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-allocated-height.returns" role="returns">
<title>Returns</title>
<para> the height of the <parameter>widget</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-allocation" role="function">
<title>gtk_widget_get_allocation&#160;()</title>
<indexterm zone="gtk-widget-get-allocation"><primary>gtk_widget_get_allocation</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_get_allocation (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                           <parameter><link linkend="GtkAllocation"><type>GtkAllocation</type></link> *allocation</parameter>);</programlisting>
<para>Retrieves the widget’s allocation.</para>
<para>Note, when implementing a <link linkend="GtkContainer"><type>GtkContainer</type></link>: a widget’s allocation will
be its “adjusted” allocation, that is, the widget’s parent
container typically calls <link linkend="gtk-widget-size-allocate"><function>gtk_widget_size_allocate()</function></link> with an
allocation, and that allocation is then adjusted (to handle margin
and alignment for example) before assignment to the widget.
<link linkend="gtk-widget-get-allocation"><function>gtk_widget_get_allocation()</function></link> returns the adjusted allocation that
was actually assigned to the widget. The adjusted allocation is
guaranteed to be completely contained within the
<link linkend="gtk-widget-size-allocate"><function>gtk_widget_size_allocate()</function></link> allocation, however. So a <link linkend="GtkContainer"><type>GtkContainer</type></link>
is guaranteed that its children stay inside the assigned bounds,
but not that they have exactly the bounds the container assigned.</para>
<refsect3 id="gtk-widget-get-allocation.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>allocation</para></entry>
<entry role="parameter_description"><para>a pointer to a <link linkend="GtkAllocation"><type>GtkAllocation</type></link> to copy to. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-allocated-baseline" role="function">
<title>gtk_widget_get_allocated_baseline&#160;()</title>
<indexterm zone="gtk-widget-get-allocated-baseline"><primary>gtk_widget_get_allocated_baseline</primary></indexterm>
<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
gtk_widget_get_allocated_baseline (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the baseline that has currently been allocated to <parameter>widget</parameter>
.
This function is intended to be used when implementing handlers
for the <link linkend="GtkWidgetClass.snapshot"><function>GtkWidgetClass.snapshot()</function></link> function, and when allocating child
widgets in <link linkend="GtkWidget-size-allocate"><type>“size_allocate”</type></link>.</para>
<refsect3 id="gtk-widget-get-allocated-baseline.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget to query</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-allocated-baseline.returns" role="returns">
<title>Returns</title>
<para> the baseline of the <parameter>widget</parameter>
, or -1 if none</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-width" role="function">
<title>gtk_widget_get_width&#160;()</title>
<indexterm zone="gtk-widget-get-width"><primary>gtk_widget_get_width</primary></indexterm>
<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
gtk_widget_get_width (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the content width of the widget, as passed to its size-allocate implementation.
This is the size you should be using in GtkWidgetClass.snapshot(). For pointer
events, see <link linkend="gtk-widget-contains"><function>gtk_widget_contains()</function></link>.</para>
<refsect3 id="gtk-widget-get-width.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-width.returns" role="returns">
<title>Returns</title>
<para> The width of <parameter>widget</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-height" role="function">
<title>gtk_widget_get_height&#160;()</title>
<indexterm zone="gtk-widget-get-height"><primary>gtk_widget_get_height</primary></indexterm>
<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
gtk_widget_get_height (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the content height of the widget, as passed to its size-allocate implementation.
This is the size you should be using in GtkWidgetClass.snapshot(). For pointer
events, see <link linkend="gtk-widget-contains"><function>gtk_widget_contains()</function></link>.</para>
<refsect3 id="gtk-widget-get-height.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-height.returns" role="returns">
<title>Returns</title>
<para> The height of <parameter>widget</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-compute-bounds" role="function">
<title>gtk_widget_compute_bounds&#160;()</title>
<indexterm zone="gtk-widget-compute-bounds"><primary>gtk_widget_compute_bounds</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_compute_bounds (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                           <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *target</parameter>,
                           <parameter><link linkend="graphene-rect-t"><type>graphene_rect_t</type></link> *out_bounds</parameter>);</programlisting>
<para>Computes the bounds for <parameter>widget</parameter>
 in the coordinate space of <parameter>target</parameter>
.
FIXME: Explain what "bounds" are.</para>
<para>If the operation is successful, <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> is returned. If <parameter>widget</parameter>
 has no
bounds or the bounds cannot be expressed in <parameter>target</parameter>
's coordinate space
(for example if both widgets are in different windows), <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> is
returned and <parameter>bounds</parameter>
 is set to the zero rectangle.</para>
<para>It is valid for <parameter>widget</parameter>
 and <parameter>target</parameter>
 to be the same widget.</para>
<refsect3 id="gtk-widget-compute-bounds.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> to query</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>target</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>out_bounds</para></entry>
<entry role="parameter_description"><para>the rectangle taking the bounds. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out caller-allocates</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-compute-bounds.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the bounds could be computed</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-compute-transform" role="function">
<title>gtk_widget_compute_transform&#160;()</title>
<indexterm zone="gtk-widget-compute-transform"><primary>gtk_widget_compute_transform</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_compute_transform (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                              <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *target</parameter>,
                              <parameter><link linkend="graphene-matrix-t"><type>graphene_matrix_t</type></link> *out_transform</parameter>);</programlisting>
<para>Computes a matrix suitable to describe a transformation from
<parameter>widget</parameter>
's coordinate system into <parameter>target</parameter>
's coordinate system.</para>
<refsect3 id="gtk-widget-compute-transform.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>target</para></entry>
<entry role="parameter_description"><para>the target widget that the matrix will transform to</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>out_transform</para></entry>
<entry role="parameter_description"><para>location to
store the final transformation. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out caller-allocates</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-compute-transform.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the transform could be computed, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
The transform can not be computed in certain cases, for example when
<parameter>widget</parameter>
and <parameter>target</parameter>
do not share a common ancestor. In that
case <parameter>out_transform</parameter>
gets set to the identity matrix.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-compute-point" role="function">
<title>gtk_widget_compute_point&#160;()</title>
<indexterm zone="gtk-widget-compute-point"><primary>gtk_widget_compute_point</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_compute_point (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                          <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *target</parameter>,
                          <parameter>const <link linkend="graphene-point-t"><type>graphene_point_t</type></link> *point</parameter>,
                          <parameter><link linkend="graphene-point-t"><type>graphene_point_t</type></link> *out_point</parameter>);</programlisting>
<para>Translates the given <parameter>point</parameter>
 in <parameter>widget</parameter>
's coordinates to coordinates
relative to <parameter>target</parameter>
’s coodinate system. In order to perform this
operation, both widgets must share a common root.</para>
<refsect3 id="gtk-widget-compute-point.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> to query</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>target</para></entry>
<entry role="parameter_description"><para>the <link linkend="GtkWidget"><type>GtkWidget</type></link> to transform into</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>point</para></entry>
<entry role="parameter_description"><para>a point in <parameter>widget</parameter>
's coordinate system</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>out_point</para></entry>
<entry role="parameter_description"><para>Set to the corresponding coordinates in
<parameter>target</parameter>
's coordinate system. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out caller-allocates</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-compute-point.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the point could be determined, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> on failure.
In this case, 0 is stored in <parameter>out_point</parameter>
.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-contains" role="function">
<title>gtk_widget_contains&#160;()</title>
<indexterm zone="gtk-widget-contains"><primary>gtk_widget_contains</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_contains (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                     <parameter><link linkend="gdouble"><type>gdouble</type></link> x</parameter>,
                     <parameter><link linkend="gdouble"><type>gdouble</type></link> y</parameter>);</programlisting>
<para>Tests if the point at (<parameter>x</parameter>
, <parameter>y</parameter>
) is contained in <parameter>widget</parameter>
.</para>
<para>The coordinates for (<parameter>x</parameter>
, <parameter>y</parameter>
) must be in widget coordinates, so
(0, 0) is assumed to be the top left of <parameter>widget</parameter>
's content area.</para>
<refsect3 id="gtk-widget-contains.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget to query</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>X coordinate to test, relative to <parameter>widget</parameter>
's origin</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>Y coordinate to test, relative to <parameter>widget</parameter>
's origin</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-contains.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>widget</parameter>
contains (<parameter>x</parameter>
, <parameter>y</parameter>
).</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-pick" role="function">
<title>gtk_widget_pick&#160;()</title>
<indexterm zone="gtk-widget-pick"><primary>gtk_widget_pick</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_widget_pick (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                 <parameter><link linkend="gdouble"><type>gdouble</type></link> x</parameter>,
                 <parameter><link linkend="gdouble"><type>gdouble</type></link> y</parameter>,
                 <parameter><link linkend="GtkPickFlags"><type>GtkPickFlags</type></link> flags</parameter>);</programlisting>
<para>Finds the descendant of <parameter>widget</parameter>
 (including <parameter>widget</parameter>
 itself) closest
to the screen at the point (<parameter>x</parameter>
, <parameter>y</parameter>
). The point must be given in
widget coordinates, so (0, 0) is assumed to be the top left of
<parameter>widget</parameter>
's content area.</para>
<para>Usually widgets will return <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the given coordinate is not
contained in <parameter>widget</parameter>
 checked via <link linkend="gtk-widget-contains"><function>gtk_widget_contains()</function></link>. Otherwise
they will recursively try to find a child that does not return <link linkend="NULL:CAPS"><literal>NULL</literal></link>.
Widgets are however free to customize their picking algorithm.</para>
<para>This function is used on the toplevel to determine the widget below
the mouse cursor for purposes of hover hilighting and delivering events.</para>
<refsect3 id="gtk-widget-pick.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget to query</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>X coordinate to test, relative to <parameter>widget</parameter>
's origin</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>Y coordinate to test, relative to <parameter>widget</parameter>
's origin</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>Flags to influence what is picked</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-pick.returns" role="returns">
<title>Returns</title>
<para>The widget descendant at the given
coordinate or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if none. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-can-focus" role="function">
<title>gtk_widget_get_can_focus&#160;()</title>
<indexterm zone="gtk-widget-get-can-focus"><primary>gtk_widget_get_can_focus</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_can_focus (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Determines whether the input focus can enter <parameter>widget</parameter>
 or any
of its children.</para>
<para>See <link linkend="gtk-widget-set-focusable"><function>gtk_widget_set_focusable()</function></link>.</para>
<refsect3 id="gtk-widget-get-can-focus.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-can-focus.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the input focus can enter <parameter>widget</parameter>
, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-can-focus" role="function">
<title>gtk_widget_set_can_focus&#160;()</title>
<indexterm zone="gtk-widget-set-can-focus"><primary>gtk_widget_set_can_focus</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_can_focus (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                          <parameter><link linkend="gboolean"><type>gboolean</type></link> can_focus</parameter>);</programlisting>
<para>Specifies whether the input focus can enter the widget
or any of its children.</para>
<para>Applications should set <parameter>can_focus</parameter>
 to <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> to mark a
widget as for pointer/touch use only.</para>
<para>Note that having <parameter>can_focus</parameter>
 be <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> is only one of the
necessary conditions for being focusable. A widget must
also be sensitive and focusable and not have an ancestor
that is marked as not can-focus in order to receive input
focus.</para>
<para>See <link linkend="gtk-widget-grab-focus"><function>gtk_widget_grab_focus()</function></link> for actually setting the input
focus on a widget.</para>
<refsect3 id="gtk-widget-set-can-focus.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>can_focus</para></entry>
<entry role="parameter_description"><para>whether or not the input focus can enter
the widget or any of its children</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-focusable" role="function">
<title>gtk_widget_get_focusable&#160;()</title>
<indexterm zone="gtk-widget-get-focusable"><primary>gtk_widget_get_focusable</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_focusable (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Determines whether <parameter>widget</parameter>
 can own the input focus.
See <link linkend="gtk-widget-set-focusable"><function>gtk_widget_set_focusable()</function></link>.</para>
<refsect3 id="gtk-widget-get-focusable.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-focusable.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>widget</parameter>
can own the input focus, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-focusable" role="function">
<title>gtk_widget_set_focusable&#160;()</title>
<indexterm zone="gtk-widget-set-focusable"><primary>gtk_widget_set_focusable</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_focusable (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                          <parameter><link linkend="gboolean"><type>gboolean</type></link> focusable</parameter>);</programlisting>
<para>Specifies whether <parameter>widget</parameter>
 can own the input focus.</para>
<para>Widget implementations should set <parameter>focusable</parameter>
 to <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> in
their <link linkend="init"><function>init()</function></link> function if they want to receive keyboard input.</para>
<para>Note that having <parameter>focusable</parameter>
 be <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> is only one of the
necessary conditions for being focusable. A widget must
also be sensitive and can-focus and not have an ancestor
that is marked as not can-focus in order to receive input
focus.</para>
<para>See <link linkend="gtk-widget-grab-focus"><function>gtk_widget_grab_focus()</function></link> for actually setting the input
focus on a widget.</para>
<refsect3 id="gtk-widget-set-focusable.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>focusable</para></entry>
<entry role="parameter_description"><para>whether or not <parameter>widget</parameter>
can own the input focus</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-focus-on-click" role="function">
<title>gtk_widget_get_focus_on_click&#160;()</title>
<indexterm zone="gtk-widget-get-focus-on-click"><primary>gtk_widget_get_focus_on_click</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_focus_on_click (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns whether the widget should grab focus when it is clicked with the mouse.
See <link linkend="gtk-widget-set-focus-on-click"><function>gtk_widget_set_focus_on_click()</function></link>.</para>
<refsect3 id="gtk-widget-get-focus-on-click.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-focus-on-click.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the widget should grab focus when it is clicked with
the mouse.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-focus-on-click" role="function">
<title>gtk_widget_set_focus_on_click&#160;()</title>
<indexterm zone="gtk-widget-set-focus-on-click"><primary>gtk_widget_set_focus_on_click</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_focus_on_click (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                               <parameter><link linkend="gboolean"><type>gboolean</type></link> focus_on_click</parameter>);</programlisting>
<para>Sets whether the widget should grab focus when it is clicked with the mouse.
Making mouse clicks not grab focus is useful in places like toolbars where
you don’t want the keyboard focus removed from the main area of the
application.</para>
<refsect3 id="gtk-widget-set-focus-on-click.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>focus_on_click</para></entry>
<entry role="parameter_description"><para>whether the widget should grab focus when clicked with the mouse</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-focus-child" role="function">
<title>gtk_widget_set_focus_child&#160;()</title>
<indexterm zone="gtk-widget-set-focus-child"><primary>gtk_widget_set_focus_child</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_focus_child (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                            <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *child</parameter>);</programlisting>
<para>Set <parameter>child</parameter>
 as the current focus child of <parameter>widget</parameter>
. The previous
focus child will be unset.</para>
<para>This function is only suitable for widget implementations.
If you want a certain widget to get the input focus, call
<link linkend="gtk-widget-grab-focus"><function>gtk_widget_grab_focus()</function></link> on it.</para>
<refsect3 id="gtk-widget-set-focus-child.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>child</para></entry>
<entry role="parameter_description"><para>a direct child widget of <parameter>widget</parameter>
or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
to unset the focus child of <parameter>widget</parameter>
. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-can-target" role="function">
<title>gtk_widget_get_can_target&#160;()</title>
<indexterm zone="gtk-widget-get-can-target"><primary>gtk_widget_get_can_target</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_can_target (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Queries whether <parameter>widget</parameter>
 can be the target of pointer events.</para>
<refsect3 id="gtk-widget-get-can-target.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-can-target.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>widget</parameter>
can receive pointer events</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-can-target" role="function">
<title>gtk_widget_set_can_target&#160;()</title>
<indexterm zone="gtk-widget-set-can-target"><primary>gtk_widget_set_can_target</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_can_target (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                           <parameter><link linkend="gboolean"><type>gboolean</type></link> can_target</parameter>);</programlisting>
<para>Sets whether <parameter>widget</parameter>
 can be the target of pointer events.</para>
<refsect3 id="gtk-widget-set-can-target.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>can_target</para></entry>
<entry role="parameter_description"><para>whether this widget should be able to receive pointer events</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-sensitive" role="function">
<title>gtk_widget_get_sensitive&#160;()</title>
<indexterm zone="gtk-widget-get-sensitive"><primary>gtk_widget_get_sensitive</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_sensitive (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the widget’s sensitivity (in the sense of returning
the value that has been set using <link linkend="gtk-widget-set-sensitive"><function>gtk_widget_set_sensitive()</function></link>).</para>
<para>The effective sensitivity of a widget is however determined by both its
own and its parent widget’s sensitivity. See <link linkend="gtk-widget-is-sensitive"><function>gtk_widget_is_sensitive()</function></link>.</para>
<refsect3 id="gtk-widget-get-sensitive.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-sensitive.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the widget is sensitive</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-is-sensitive" role="function">
<title>gtk_widget_is_sensitive&#160;()</title>
<indexterm zone="gtk-widget-is-sensitive"><primary>gtk_widget_is_sensitive</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_is_sensitive (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the widget’s effective sensitivity, which means
it is sensitive itself and also its parent widget is sensitive</para>
<refsect3 id="gtk-widget-is-sensitive.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-is-sensitive.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the widget is effectively sensitive</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-visible" role="function">
<title>gtk_widget_get_visible&#160;()</title>
<indexterm zone="gtk-widget-get-visible"><primary>gtk_widget_get_visible</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_visible (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Determines whether the widget is visible. If you want to
take into account whether the widget’s parent is also marked as
visible, use <link linkend="gtk-widget-is-visible"><function>gtk_widget_is_visible()</function></link> instead.</para>
<para>This function does not check if the widget is obscured in any way.</para>
<para>See <link linkend="gtk-widget-set-visible"><function>gtk_widget_set_visible()</function></link>.</para>
<refsect3 id="gtk-widget-get-visible.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-visible.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the widget is visible</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-is-visible" role="function">
<title>gtk_widget_is_visible&#160;()</title>
<indexterm zone="gtk-widget-is-visible"><primary>gtk_widget_is_visible</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_is_visible (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Determines whether the widget and all its parents are marked as
visible.</para>
<para>This function does not check if the widget is obscured in any way.</para>
<para>See also <link linkend="gtk-widget-get-visible"><function>gtk_widget_get_visible()</function></link> and <link linkend="gtk-widget-set-visible"><function>gtk_widget_set_visible()</function></link></para>
<refsect3 id="gtk-widget-is-visible.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-is-visible.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the widget and all its parents are visible</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-visible" role="function">
<title>gtk_widget_set_visible&#160;()</title>
<indexterm zone="gtk-widget-set-visible"><primary>gtk_widget_set_visible</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_visible (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                        <parameter><link linkend="gboolean"><type>gboolean</type></link> visible</parameter>);</programlisting>
<para>Sets the visibility state of <parameter>widget</parameter>
. Note that setting this to
<link linkend="TRUE:CAPS"><literal>TRUE</literal></link> doesn’t mean the widget is actually viewable, see
<link linkend="gtk-widget-get-visible"><function>gtk_widget_get_visible()</function></link>.</para>
<para>This function simply calls <link linkend="gtk-widget-show"><function>gtk_widget_show()</function></link> or <link linkend="gtk-widget-hide"><function>gtk_widget_hide()</function></link>
but is nicer to use when the visibility of the widget depends on
some condition.</para>
<refsect3 id="gtk-widget-set-visible.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>visible</para></entry>
<entry role="parameter_description"><para>whether the widget should be shown or not</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-state-flags" role="function">
<title>gtk_widget_set_state_flags&#160;()</title>
<indexterm zone="gtk-widget-set-state-flags"><primary>gtk_widget_set_state_flags</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_state_flags (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                            <parameter><link linkend="GtkStateFlags"><type>GtkStateFlags</type></link> flags</parameter>,
                            <parameter><link linkend="gboolean"><type>gboolean</type></link> clear</parameter>);</programlisting>
<para>This function is for use in widget implementations. Turns on flag
values in the current widget state (insensitive, prelighted, etc.).</para>
<para>This function accepts the values <link linkend="GTK-STATE-FLAG-DIR-LTR:CAPS"><literal>GTK_STATE_FLAG_DIR_LTR</literal></link> and
<link linkend="GTK-STATE-FLAG-DIR-RTL:CAPS"><literal>GTK_STATE_FLAG_DIR_RTL</literal></link> but ignores them. If you want to set the widget's
direction, use <link linkend="gtk-widget-set-direction"><function>gtk_widget_set_direction()</function></link>.</para>
<para>It is worth mentioning that any other state than <link linkend="GTK-STATE-FLAG-INSENSITIVE:CAPS"><literal>GTK_STATE_FLAG_INSENSITIVE</literal></link>,
will be propagated down to all non-internal children if <parameter>widget</parameter>
 is a
<link linkend="GtkContainer"><type>GtkContainer</type></link>, while <link linkend="GTK-STATE-FLAG-INSENSITIVE:CAPS"><literal>GTK_STATE_FLAG_INSENSITIVE</literal></link> itself will be propagated
down to all <link linkend="GtkContainer"><type>GtkContainer</type></link> children by different means than turning on the
state flag down the hierarchy, both <link linkend="gtk-widget-get-state-flags"><function>gtk_widget_get_state_flags()</function></link> and
<link linkend="gtk-widget-is-sensitive"><function>gtk_widget_is_sensitive()</function></link> will make use of these.</para>
<refsect3 id="gtk-widget-set-state-flags.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>State flags to turn on</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>clear</para></entry>
<entry role="parameter_description"><para>Whether to clear state before turning on <parameter>flags</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-unset-state-flags" role="function">
<title>gtk_widget_unset_state_flags&#160;()</title>
<indexterm zone="gtk-widget-unset-state-flags"><primary>gtk_widget_unset_state_flags</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_unset_state_flags (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                              <parameter><link linkend="GtkStateFlags"><type>GtkStateFlags</type></link> flags</parameter>);</programlisting>
<para>This function is for use in widget implementations. Turns off flag
values for the current widget state (insensitive, prelighted, etc.).
See <link linkend="gtk-widget-set-state-flags"><function>gtk_widget_set_state_flags()</function></link>.</para>
<refsect3 id="gtk-widget-unset-state-flags.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>State flags to turn off</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-state-flags" role="function">
<title>gtk_widget_get_state_flags&#160;()</title>
<indexterm zone="gtk-widget-get-state-flags"><primary>gtk_widget_get_state_flags</primary></indexterm>
<programlisting language="C"><link linkend="GtkStateFlags"><returnvalue>GtkStateFlags</returnvalue></link>
gtk_widget_get_state_flags (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the widget state as a flag set. It is worth mentioning
that the effective <link linkend="GTK-STATE-FLAG-INSENSITIVE:CAPS"><literal>GTK_STATE_FLAG_INSENSITIVE</literal></link> state will be
returned, that is, also based on parent insensitivity, even if
<parameter>widget</parameter>
 itself is sensitive.</para>
<para>Also note that if you are looking for a way to obtain the
<link linkend="GtkStateFlags"><type>GtkStateFlags</type></link> to pass to a <link linkend="GtkStyleContext"><type>GtkStyleContext</type></link> method, you
should look at <link linkend="gtk-style-context-get-state"><function>gtk_style_context_get_state()</function></link>.</para>
<refsect3 id="gtk-widget-get-state-flags.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-state-flags.returns" role="returns">
<title>Returns</title>
<para> The state flags for widget</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-has-default" role="function">
<title>gtk_widget_has_default&#160;()</title>
<indexterm zone="gtk-widget-has-default"><primary>gtk_widget_has_default</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_has_default (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Determines whether <parameter>widget</parameter>
 is the current default widget within its
toplevel.</para>
<refsect3 id="gtk-widget-has-default.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-has-default.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>widget</parameter>
is the current default widget within
its toplevel, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-has-focus" role="function">
<title>gtk_widget_has_focus&#160;()</title>
<indexterm zone="gtk-widget-has-focus"><primary>gtk_widget_has_focus</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_has_focus (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Determines if the widget has the global input focus. See
<link linkend="gtk-widget-is-focus"><function>gtk_widget_is_focus()</function></link> for the difference between having the global
input focus, and only having the focus within a toplevel.</para>
<refsect3 id="gtk-widget-has-focus.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-has-focus.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the widget has the global input focus.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-has-visible-focus" role="function">
<title>gtk_widget_has_visible_focus&#160;()</title>
<indexterm zone="gtk-widget-has-visible-focus"><primary>gtk_widget_has_visible_focus</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_has_visible_focus (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Determines if the widget should show a visible indication that
it has the global input focus. This is a convenience function
that takes into account whether focus indication should currently
be shown in the toplevel window of <parameter>widget</parameter>
.
See <link linkend="gtk-window-get-focus-visible"><function>gtk_window_get_focus_visible()</function></link> for more information
about focus indication.</para>
<para>To find out if the widget has the global input focus, use
<link linkend="gtk-widget-has-focus"><function>gtk_widget_has_focus()</function></link>.</para>
<refsect3 id="gtk-widget-has-visible-focus.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-has-visible-focus.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the widget should display a “focus rectangle”</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-is-drawable" role="function">
<title>gtk_widget_is_drawable&#160;()</title>
<indexterm zone="gtk-widget-is-drawable"><primary>gtk_widget_is_drawable</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_is_drawable (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Determines whether <parameter>widget</parameter>
 can be drawn to. A widget can be drawn
if it is mapped and visible.</para>
<refsect3 id="gtk-widget-is-drawable.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-is-drawable.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>widget</parameter>
is drawable, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-receives-default" role="function">
<title>gtk_widget_set_receives_default&#160;()</title>
<indexterm zone="gtk-widget-set-receives-default"><primary>gtk_widget_set_receives_default</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_receives_default (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                 <parameter><link linkend="gboolean"><type>gboolean</type></link> receives_default</parameter>);</programlisting>
<para>Specifies whether <parameter>widget</parameter>
 will be treated as the default
widget within its toplevel when it has the focus, even if
another widget is the default.</para>
<refsect3 id="gtk-widget-set-receives-default.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>receives_default</para></entry>
<entry role="parameter_description"><para>whether or not <parameter>widget</parameter>
can be a default widget.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-receives-default" role="function">
<title>gtk_widget_get_receives_default&#160;()</title>
<indexterm zone="gtk-widget-get-receives-default"><primary>gtk_widget_get_receives_default</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_receives_default (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Determines whether <parameter>widget</parameter>
 is always treated as the default widget
within its toplevel when it has the focus, even if another widget
is the default.</para>
<para>See <link linkend="gtk-widget-set-receives-default"><function>gtk_widget_set_receives_default()</function></link>.</para>
<refsect3 id="gtk-widget-get-receives-default.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-receives-default.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>widget</parameter>
acts as the default widget when focused,
<link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-support-multidevice" role="function">
<title>gtk_widget_set_support_multidevice&#160;()</title>
<indexterm zone="gtk-widget-set-support-multidevice"><primary>gtk_widget_set_support_multidevice</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_support_multidevice (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                    <parameter><link linkend="gboolean"><type>gboolean</type></link> support_multidevice</parameter>);</programlisting>
<para>Enables or disables multiple pointer awareness. If this setting is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>,
<parameter>widget</parameter>
 will start receiving multiple, per device enter/leave events. Note
that if custom <link linkend="GdkSurfaces"><type>GdkSurfaces</type></link> are created in <link linkend="GtkWidget-realize"><type>“realize”</type></link>,
<link linkend="gdk-surface-set-support-multidevice"><function>gdk_surface_set_support_multidevice()</function></link> will have to be called manually on them.</para>
<refsect3 id="gtk-widget-set-support-multidevice.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>support_multidevice</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> to support input from multiple devices.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-support-multidevice" role="function">
<title>gtk_widget_get_support_multidevice&#160;()</title>
<indexterm zone="gtk-widget-get-support-multidevice"><primary>gtk_widget_get_support_multidevice</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_support_multidevice (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>widget</parameter>
 is multiple pointer aware. See
<link linkend="gtk-widget-set-support-multidevice"><function>gtk_widget_set_support_multidevice()</function></link> for more information.</para>
<refsect3 id="gtk-widget-get-support-multidevice.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-support-multidevice.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>widget</parameter>
is multidevice aware.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-realized" role="function">
<title>gtk_widget_get_realized&#160;()</title>
<indexterm zone="gtk-widget-get-realized"><primary>gtk_widget_get_realized</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_realized (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Determines whether <parameter>widget</parameter>
 is realized.</para>
<refsect3 id="gtk-widget-get-realized.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-realized.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>widget</parameter>
is realized, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-mapped" role="function">
<title>gtk_widget_get_mapped&#160;()</title>
<indexterm zone="gtk-widget-get-mapped"><primary>gtk_widget_get_mapped</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_mapped (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Whether the widget is mapped.</para>
<refsect3 id="gtk-widget-get-mapped.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-mapped.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the widget is mapped, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-device-is-shadowed" role="function">
<title>gtk_widget_device_is_shadowed&#160;()</title>
<indexterm zone="gtk-widget-device-is-shadowed"><primary>gtk_widget_device_is_shadowed</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_device_is_shadowed (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                               <parameter><link linkend="GdkDevice"><type>GdkDevice</type></link> *device</parameter>);</programlisting>
<para>Returns <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>device</parameter>
 has been shadowed by a GTK+
device grab on another widget, so it would stop sending
events to <parameter>widget</parameter>
. This may be used in the
<link linkend="GtkWidget-grab-notify"><type>“grab-notify”</type></link> signal to check for specific
devices. See <link linkend="gtk-device-grab-add"><function>gtk_device_grab_add()</function></link>.</para>
<refsect3 id="gtk-widget-device-is-shadowed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>device</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkDevice"><type>GdkDevice</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-device-is-shadowed.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if there is an ongoing grab on <parameter>device</parameter>
by another <link linkend="GtkWidget"><type>GtkWidget</type></link> than <parameter>widget</parameter>
.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-opacity" role="function">
<title>gtk_widget_get_opacity&#160;()</title>
<indexterm zone="gtk-widget-get-opacity"><primary>gtk_widget_get_opacity</primary></indexterm>
<programlisting language="C"><link linkend="double"><returnvalue>double</returnvalue></link>
gtk_widget_get_opacity (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Fetches the requested opacity for this widget.
See <link linkend="gtk-widget-set-opacity"><function>gtk_widget_set_opacity()</function></link>.</para>
<refsect3 id="gtk-widget-get-opacity.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-opacity.returns" role="returns">
<title>Returns</title>
<para> the requested opacity for this widget.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-opacity" role="function">
<title>gtk_widget_set_opacity&#160;()</title>
<indexterm zone="gtk-widget-set-opacity"><primary>gtk_widget_set_opacity</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_opacity (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                        <parameter><link linkend="double"><type>double</type></link> opacity</parameter>);</programlisting>
<para>Request the <parameter>widget</parameter>
 to be rendered partially transparent,
with opacity 0 being fully transparent and 1 fully opaque. (Opacity values
are clamped to the [0,1] range.).
This works on both toplevel widget, and child widgets, although there
are some limitations:</para>
<para>For toplevel widgets this depends on the capabilities of the windowing
system. On X11 this has any effect only on X displays with a compositing manager
running. See <link linkend="gdk-display-is-composited"><function>gdk_display_is_composited()</function></link>. On Windows it should work
always, although setting a window’s opacity after the window has been
shown causes it to flicker once on Windows.</para>
<para>For child widgets it doesn’t work if any affected widget has a native window.</para>
<refsect3 id="gtk-widget-set-opacity.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>opacity</para></entry>
<entry role="parameter_description"><para>desired opacity, between 0 and 1</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-overflow" role="function">
<title>gtk_widget_get_overflow&#160;()</title>
<indexterm zone="gtk-widget-get-overflow"><primary>gtk_widget_get_overflow</primary></indexterm>
<programlisting language="C"><link linkend="GtkOverflow"><returnvalue>GtkOverflow</returnvalue></link>
gtk_widget_get_overflow (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the value set via <link linkend="gtk-widget-set-overflow"><function>gtk_widget_set_overflow()</function></link>.</para>
<refsect3 id="gtk-widget-get-overflow.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-overflow.returns" role="returns">
<title>Returns</title>
<para> The widget's overflow.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-overflow" role="function">
<title>gtk_widget_set_overflow&#160;()</title>
<indexterm zone="gtk-widget-set-overflow"><primary>gtk_widget_set_overflow</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_overflow (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                         <parameter><link linkend="GtkOverflow"><type>GtkOverflow</type></link> overflow</parameter>);</programlisting>
<para>Sets how <parameter>widget</parameter>
 treats content that is drawn outside the widget's content area.
See the definition of <link linkend="GtkOverflow"><type>GtkOverflow</type></link> for details.</para>
<para>This setting is provided for widget implementations and should not be used by
application code.</para>
<para>The default value is <link linkend="GTK-OVERFLOW-VISIBLE:CAPS"><literal>GTK_OVERFLOW_VISIBLE</literal></link>.</para>
<refsect3 id="gtk-widget-set-overflow.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>overflow</para></entry>
<entry role="parameter_description"><para>desired overflow</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-measure" role="function">
<title>gtk_widget_measure&#160;()</title>
<indexterm zone="gtk-widget-measure"><primary>gtk_widget_measure</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_measure (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                    <parameter><link linkend="GtkOrientation"><type>GtkOrientation</type></link> orientation</parameter>,
                    <parameter><link linkend="int"><type>int</type></link> for_size</parameter>,
                    <parameter><link linkend="int"><type>int</type></link> *minimum</parameter>,
                    <parameter><link linkend="int"><type>int</type></link> *natural</parameter>,
                    <parameter><link linkend="int"><type>int</type></link> *minimum_baseline</parameter>,
                    <parameter><link linkend="int"><type>int</type></link> *natural_baseline</parameter>);</programlisting>
<para>Measures <parameter>widget</parameter>
 in the orientation <parameter>orientation</parameter>
 and for the given <parameter>for_size</parameter>
.
As an example, if <parameter>orientation</parameter>
 is <link linkend="GTK-ORIENTATION-HORIZONTAL:CAPS"><literal>GTK_ORIENTATION_HORIZONTAL</literal></link> and <parameter>for_size</parameter>
 is 300,
this functions will compute the minimum and natural width of <parameter>widget</parameter>
 if
it is allocated at a height of 300 pixels.</para>
<para>See <link linkend="geometry-management">GtkWidget’s geometry management section</link> for
a more details on implementing <link linkend="GtkWidgetClass.measure"><function>GtkWidgetClass.measure()</function></link>.</para>
<refsect3 id="gtk-widget-measure.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkWidget"><type>GtkWidget</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>orientation</para></entry>
<entry role="parameter_description"><para>the orientation to measure</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>for_size</para></entry>
<entry role="parameter_description"><para>Size for the opposite of <parameter>orientation</parameter>
, i.e.
if <parameter>orientation</parameter>
is <link linkend="GTK-ORIENTATION-HORIZONTAL:CAPS"><literal>GTK_ORIENTATION_HORIZONTAL</literal></link>, this is
the height the widget should be measured with. The <link linkend="GTK-ORIENTATION-VERTICAL:CAPS"><literal>GTK_ORIENTATION_VERTICAL</literal></link>
case is analogous. This way, both height-for-width and width-for-height
requests can be implemented. If no size is known, -1 can be passed.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum</para></entry>
<entry role="parameter_description"><para>location to store the minimum size, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>natural</para></entry>
<entry role="parameter_description"><para>location to store the natural size, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>minimum_baseline</para></entry>
<entry role="parameter_description"><para>location to store the baseline
position for the minimum size, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>natural_baseline</para></entry>
<entry role="parameter_description"><para>location to store the baseline
position for the natural size, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>optional</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-snapshot-child" role="function">
<title>gtk_widget_snapshot_child&#160;()</title>
<indexterm zone="gtk-widget-snapshot-child"><primary>gtk_widget_snapshot_child</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_snapshot_child (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                           <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *child</parameter>,
                           <parameter><link linkend="GtkSnapshot"><type>GtkSnapshot</type></link> *snapshot</parameter>);</programlisting>
<para>When a widget receives a call to the snapshot function, it must send
synthetic <link linkend="GtkWidgetClass.snapshot"><function>GtkWidgetClass.snapshot()</function></link> calls to all children. This function
provides a convenient way of doing this. A widget, when it receives
a call to its <link linkend="GtkWidgetClass.snapshot"><function>GtkWidgetClass.snapshot()</function></link> function, calls
<link linkend="gtk-widget-snapshot-child"><function>gtk_widget_snapshot_child()</function></link> once for each child, passing in
the <parameter>snapshot</parameter>
 the widget received.</para>
<para>gtk_widget_snapshot_child() takes care of translating the origin of
<parameter>snapshot</parameter>
, and deciding whether the child needs to be snapshot.</para>
<para>This function does nothing for children that implement <link linkend="GtkNative"><type>GtkNative</type></link>.</para>
<refsect3 id="gtk-widget-snapshot-child.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>child</para></entry>
<entry role="parameter_description"><para>a child of <parameter>widget</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>snapshot</para></entry>
<entry role="parameter_description"><para><link linkend="GtkSnapshot"><type>GtkSnapshot</type></link> as passed to the widget. In particular, no
calls to <link linkend="gtk-snapshot-translate"><function>gtk_snapshot_translate()</function></link> or other transform calls should
have been made.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-next-sibling" role="function">
<title>gtk_widget_get_next_sibling&#160;()</title>
<indexterm zone="gtk-widget-get-next-sibling"><primary>gtk_widget_get_next_sibling</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_widget_get_next_sibling (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<refsect3 id="gtk-widget-get-next-sibling.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-next-sibling.returns" role="returns">
<title>Returns</title>
<para>The widget's next sibling. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-prev-sibling" role="function">
<title>gtk_widget_get_prev_sibling&#160;()</title>
<indexterm zone="gtk-widget-get-prev-sibling"><primary>gtk_widget_get_prev_sibling</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_widget_get_prev_sibling (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<refsect3 id="gtk-widget-get-prev-sibling.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-prev-sibling.returns" role="returns">
<title>Returns</title>
<para>The widget's previous sibling. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-first-child" role="function">
<title>gtk_widget_get_first_child&#160;()</title>
<indexterm zone="gtk-widget-get-first-child"><primary>gtk_widget_get_first_child</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_widget_get_first_child (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<refsect3 id="gtk-widget-get-first-child.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-first-child.returns" role="returns">
<title>Returns</title>
<para>The widget's first child. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-last-child" role="function">
<title>gtk_widget_get_last_child&#160;()</title>
<indexterm zone="gtk-widget-get-last-child"><primary>gtk_widget_get_last_child</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_widget_get_last_child (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<refsect3 id="gtk-widget-get-last-child.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-last-child.returns" role="returns">
<title>Returns</title>
<para>The widget's last child. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-insert-before" role="function">
<title>gtk_widget_insert_before&#160;()</title>
<indexterm zone="gtk-widget-insert-before"><primary>gtk_widget_insert_before</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_insert_before (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                          <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *parent</parameter>,
                          <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *next_sibling</parameter>);</programlisting>
<para>Inserts <parameter>widget</parameter>
 into the child widget list of <parameter>parent</parameter>
.
It will be placed before <parameter>next_sibling</parameter>
, or at the end if <parameter>next_sibling</parameter>
 is <link linkend="NULL:CAPS"><literal>NULL</literal></link>.</para>
<para>After calling this function, gtk_widget_get_next_sibling(widget) will return <parameter>next_sibling</parameter>
.</para>
<para>If <parameter>parent</parameter>
 is already set as the parent widget of <parameter>widget</parameter>
, this function can also be used
to reorder <parameter>widget</parameter>
 in the child widget list of <parameter>parent</parameter>
.</para>
<refsect3 id="gtk-widget-insert-before.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>parent</para></entry>
<entry role="parameter_description"><para>the parent <link linkend="GtkWidget"><type>GtkWidget</type></link> to insert <parameter>widget</parameter>
into</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>next_sibling</para></entry>
<entry role="parameter_description"><para>the new next sibling of <parameter>widget</parameter>
or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-insert-after" role="function">
<title>gtk_widget_insert_after&#160;()</title>
<indexterm zone="gtk-widget-insert-after"><primary>gtk_widget_insert_after</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_insert_after (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                         <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *parent</parameter>,
                         <parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *previous_sibling</parameter>);</programlisting>
<para>Inserts <parameter>widget</parameter>
 into the child widget list of <parameter>parent</parameter>
.
It will be placed after <parameter>previous_sibling</parameter>
, or at the beginning if <parameter>previous_sibling</parameter>
 is <link linkend="NULL:CAPS"><literal>NULL</literal></link>.</para>
<para>After calling this function, gtk_widget_get_prev_sibling(widget) will return <parameter>previous_sibling</parameter>
.</para>
<para>If <parameter>parent</parameter>
 is already set as the parent widget of <parameter>widget</parameter>
, this function can also be used
to reorder <parameter>widget</parameter>
 in the child widget list of <parameter>parent</parameter>
.</para>
<refsect3 id="gtk-widget-insert-after.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>parent</para></entry>
<entry role="parameter_description"><para>the parent <link linkend="GtkWidget"><type>GtkWidget</type></link> to insert <parameter>widget</parameter>
into</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>previous_sibling</para></entry>
<entry role="parameter_description"><para>the new previous sibling of <parameter>widget</parameter>
or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-layout-manager" role="function">
<title>gtk_widget_set_layout_manager&#160;()</title>
<indexterm zone="gtk-widget-set-layout-manager"><primary>gtk_widget_set_layout_manager</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_layout_manager (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                               <parameter><link linkend="GtkLayoutManager"><type>GtkLayoutManager</type></link> *layout_manager</parameter>);</programlisting>
<para>Sets the layout manager delegate instance that provides an implementation
for measuring and allocating the children of <parameter>widget</parameter>
.</para>
<refsect3 id="gtk-widget-set-layout-manager.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>layout_manager</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkLayoutManager"><type>GtkLayoutManager</type></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer full</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-layout-manager" role="function">
<title>gtk_widget_get_layout_manager&#160;()</title>
<indexterm zone="gtk-widget-get-layout-manager"><primary>gtk_widget_get_layout_manager</primary></indexterm>
<programlisting language="C"><link linkend="GtkLayoutManager"><returnvalue>GtkLayoutManager</returnvalue></link>&#160;*
gtk_widget_get_layout_manager (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Retrieves the layout manager set using <link linkend="gtk-widget-set-layout-manager"><function>gtk_widget_set_layout_manager()</function></link>.</para>
<refsect3 id="gtk-widget-get-layout-manager.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-layout-manager.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GtkLayoutManager"><type>GtkLayoutManager</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-should-layout" role="function">
<title>gtk_widget_should_layout&#160;()</title>
<indexterm zone="gtk-widget-should-layout"><primary>gtk_widget_should_layout</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_should_layout (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns whether <parameter>widget</parameter>
 should contribute to
the measuring and allocation of its parent.
This is <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> for invisible children, but also
for children that have their own surface.</para>
<refsect3 id="gtk-widget-should-layout.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a widget</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-should-layout.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if child should be included in
measuring and allocating</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-css-name" role="function">
<title>gtk_widget_get_css_name&#160;()</title>
<indexterm zone="gtk-widget-get-css-name"><primary>gtk_widget_get_css_name</primary></indexterm>
<programlisting language="C">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
gtk_widget_get_css_name (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *self</parameter>);</programlisting>
<para>Returns the CSS name that is used for <parameter>self</parameter>
.</para>
<refsect3 id="gtk-widget-get-css-name.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-css-name.returns" role="returns">
<title>Returns</title>
<para>the CSS name. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-add-css-class" role="function">
<title>gtk_widget_add_css_class&#160;()</title>
<indexterm zone="gtk-widget-add-css-class"><primary>gtk_widget_add_css_class</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_add_css_class (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                          <parameter>const <link linkend="char"><type>char</type></link> *css_class</parameter>);</programlisting>
<para>Adds <parameter>css_class</parameter>
 to <parameter>widget</parameter>
. After calling this function, <parameter>widget</parameter>
's
style will match for <parameter>css_class</parameter>
, after the CSS matching rules.</para>
<refsect3 id="gtk-widget-add-css-class.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>css_class</para></entry>
<entry role="parameter_description"><para>The style class to add to <parameter>widget</parameter>
, without
the leading '.' used for notation of style classes</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-remove-css-class" role="function">
<title>gtk_widget_remove_css_class&#160;()</title>
<indexterm zone="gtk-widget-remove-css-class"><primary>gtk_widget_remove_css_class</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_remove_css_class (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                             <parameter>const <link linkend="char"><type>char</type></link> *css_class</parameter>);</programlisting>
<para>Removes <parameter>css_class</parameter>
 from <parameter>widget</parameter>
. After this, the style of <parameter>widget</parameter>

will stop matching for <parameter>css_class</parameter>
.</para>
<refsect3 id="gtk-widget-remove-css-class.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>css_class</para></entry>
<entry role="parameter_description"><para>The style class to remove from <parameter>widget</parameter>
, without
the leading '.' used for notation of style classes</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-has-css-class" role="function">
<title>gtk_widget_has_css_class&#160;()</title>
<indexterm zone="gtk-widget-has-css-class"><primary>gtk_widget_has_css_class</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_has_css_class (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                          <parameter>const <link linkend="char"><type>char</type></link> *css_class</parameter>);</programlisting>
<para>Returns whether <parameter>css_class</parameter>
 is currently applied to <parameter>widget</parameter>
.</para>
<refsect3 id="gtk-widget-has-css-class.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>css_class</para></entry>
<entry role="parameter_description"><para>A CSS style class, without the leading '.'
used for notation of style classes</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-has-css-class.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>css_class</parameter>
is currently applied to <parameter>widget</parameter>
,
<link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-css-classes" role="function">
<title>gtk_widget_get_css_classes&#160;()</title>
<indexterm zone="gtk-widget-get-css-classes"><primary>gtk_widget_get_css_classes</primary></indexterm>
<programlisting language="C"><link linkend="char"><returnvalue>char</returnvalue></link>&#160;**
gtk_widget_get_css_classes (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the list of css classes applied to <parameter>widget</parameter>
.</para>
<refsect3 id="gtk-widget-get-css-classes.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-css-classes.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated list of
css classes currently applied to <parameter>widget</parameter>
. The returned
list can be freed using <link linkend="g-strfreev"><function>g_strfreev()</function></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-css-classes" role="function">
<title>gtk_widget_set_css_classes&#160;()</title>
<indexterm zone="gtk-widget-set-css-classes"><primary>gtk_widget_set_css_classes</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_css_classes (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                            <parameter>const <link linkend="char"><type>char</type></link> **classes</parameter>);</programlisting>
<para>Will clear all css classes applied to <parameter>widget</parameter>

and replace them with <parameter>classes</parameter>
.</para>
<refsect3 id="gtk-widget-set-css-classes.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>classes</para></entry>
<entry role="parameter_description"><para><link linkend="NULL:CAPS"><literal>NULL</literal></link>-terminated list
of css classes to apply to <parameter>widget</parameter>
. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>array</acronym> zero-terminated=1]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-style-context" role="function">
<title>gtk_widget_get_style_context&#160;()</title>
<indexterm zone="gtk-widget-get-style-context"><primary>gtk_widget_get_style_context</primary></indexterm>
<programlisting language="C"><link linkend="GtkStyleContext"><returnvalue>GtkStyleContext</returnvalue></link>&#160;*
gtk_widget_get_style_context (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns the style context associated to <parameter>widget</parameter>
. The returned object is
guaranteed to be the same for the lifetime of <parameter>widget</parameter>
.</para>
<refsect3 id="gtk-widget-get-style-context.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-style-context.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GtkStyleContext"><type>GtkStyleContext</type></link>. This memory is owned by <parameter>widget</parameter>
and
must not be freed. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-get-css-name" role="function">
<title>gtk_widget_class_get_css_name&#160;()</title>
<indexterm zone="gtk-widget-class-get-css-name"><primary>gtk_widget_class_get_css_name</primary></indexterm>
<programlisting language="C">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
gtk_widget_class_get_css_name (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>);</programlisting>
<para>Gets the name used by this class for matching in CSS code. See
<link linkend="gtk-widget-class-set-css-name"><function>gtk_widget_class_set_css_name()</function></link> for details.</para>
<refsect3 id="gtk-widget-class-get-css-name.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>class to set the name on</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-class-get-css-name.returns" role="returns">
<title>Returns</title>
<para> the CSS name of the given class</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-set-css-name" role="function">
<title>gtk_widget_class_set_css_name&#160;()</title>
<indexterm zone="gtk-widget-class-set-css-name"><primary>gtk_widget_class_set_css_name</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_set_css_name (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                               <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>);</programlisting>
<para>Sets the name to be used for CSS matching of widgets.</para>
<para>If this function is not called for a given class, the name
of the parent class is used.</para>
<refsect3 id="gtk-widget-class-set-css-name.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>class to set the name on</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>name to use</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-requisition-new" role="function">
<title>gtk_requisition_new&#160;()</title>
<indexterm zone="gtk-requisition-new"><primary>gtk_requisition_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkRequisition"><returnvalue>GtkRequisition</returnvalue></link>&#160;*
gtk_requisition_new (<parameter><type>void</type></parameter>);</programlisting>
<para>Allocates a new <link linkend="GtkRequisition-struct"><type>GtkRequisition</type></link> and initializes its elements to zero.</para>
<refsect3 id="gtk-requisition-new.returns" role="returns">
<title>Returns</title>
<para> a new empty <link linkend="GtkRequisition"><type>GtkRequisition</type></link>. The newly allocated <link linkend="GtkRequisition"><type>GtkRequisition</type></link> should
be freed with <link linkend="gtk-requisition-free"><function>gtk_requisition_free()</function></link>.</para>
</refsect3></refsect2>
<refsect2 id="gtk-requisition-copy" role="function">
<title>gtk_requisition_copy&#160;()</title>
<indexterm zone="gtk-requisition-copy"><primary>gtk_requisition_copy</primary></indexterm>
<programlisting language="C"><link linkend="GtkRequisition"><returnvalue>GtkRequisition</returnvalue></link>&#160;*
gtk_requisition_copy (<parameter>const <link linkend="GtkRequisition"><type>GtkRequisition</type></link> *requisition</parameter>);</programlisting>
<para>Copies a <link linkend="GtkRequisition"><type>GtkRequisition</type></link>.</para>
<refsect3 id="gtk-requisition-copy.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>requisition</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkRequisition"><type>GtkRequisition</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-requisition-copy.returns" role="returns">
<title>Returns</title>
<para> a copy of <parameter>requisition</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-requisition-free" role="function">
<title>gtk_requisition_free&#160;()</title>
<indexterm zone="gtk-requisition-free"><primary>gtk_requisition_free</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_requisition_free (<parameter><link linkend="GtkRequisition"><type>GtkRequisition</type></link> *requisition</parameter>);</programlisting>
<para>Frees a <link linkend="GtkRequisition"><type>GtkRequisition</type></link>.</para>
<refsect3 id="gtk-requisition-free.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>requisition</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkRequisition"><type>GtkRequisition</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-request-mode" role="function">
<title>gtk_widget_get_request_mode&#160;()</title>
<indexterm zone="gtk-widget-get-request-mode"><primary>gtk_widget_get_request_mode</primary></indexterm>
<programlisting language="C"><link linkend="GtkSizeRequestMode"><returnvalue>GtkSizeRequestMode</returnvalue></link>
gtk_widget_get_request_mode (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets whether the widget prefers a height-for-width layout
or a width-for-height layout.</para>
<para><link linkend="GtkBin"><type>GtkBin</type></link> widgets generally propagate the preference of
their child, container widgets need to request something either in
context of their children or in context of their allocation
capabilities.</para>
<refsect3 id="gtk-widget-get-request-mode.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-request-mode.returns" role="returns">
<title>Returns</title>
<para> The <link linkend="GtkSizeRequestMode"><type>GtkSizeRequestMode</type></link> preferred by <parameter>widget</parameter>
.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-preferred-size" role="function">
<title>gtk_widget_get_preferred_size&#160;()</title>
<indexterm zone="gtk-widget-get-preferred-size"><primary>gtk_widget_get_preferred_size</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_get_preferred_size (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                               <parameter><link linkend="GtkRequisition"><type>GtkRequisition</type></link> *minimum_size</parameter>,
                               <parameter><link linkend="GtkRequisition"><type>GtkRequisition</type></link> *natural_size</parameter>);</programlisting>
<para>Retrieves the minimum and natural size of a widget, taking
into account the widget’s preference for height-for-width management.</para>
<para>This is used to retrieve a suitable size by container widgets which do
not impose any restrictions on the child placement. It can be used
to deduce toplevel window and menu sizes as well as child widgets in
free-form containers such as GtkLayout.</para>
<para>Handle with care. Note that the natural height of a height-for-width
widget will generally be a smaller size than the minimum height, since the required
height for the natural width is generally smaller than the required height for
the minimum width.</para>
<para>Use <link linkend="gtk-widget-measure"><function>gtk_widget_measure()</function></link> if you want to support
baseline alignment.</para>
<refsect3 id="gtk-widget-get-preferred-size.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum_size</para></entry>
<entry role="parameter_description"><para>location for storing the minimum size, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>natural_size</para></entry>
<entry role="parameter_description"><para>location for storing the natural size, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>][<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-distribute-natural-allocation" role="function">
<title>gtk_distribute_natural_allocation&#160;()</title>
<indexterm zone="gtk-distribute-natural-allocation"><primary>gtk_distribute_natural_allocation</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_distribute_natural_allocation (<parameter><link linkend="gint"><type>gint</type></link> extra_space</parameter>,
                                   <parameter><link linkend="guint"><type>guint</type></link> n_requested_sizes</parameter>,
                                   <parameter><link linkend="GtkRequestedSize"><type>GtkRequestedSize</type></link> *sizes</parameter>);</programlisting>
<para>Distributes <parameter>extra_space</parameter>
 to child <parameter>sizes</parameter>
 by bringing smaller
children up to natural size first.</para>
<para>The remaining space will be added to the <parameter>minimum_size</parameter>
 member of the
GtkRequestedSize struct. If all sizes reach their natural size then
the remaining space is returned.</para>
<refsect3 id="gtk-distribute-natural-allocation.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>extra_space</para></entry>
<entry role="parameter_description"><para>Extra space to redistribute among children after subtracting
minimum sizes and any child padding from the overall allocation</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>n_requested_sizes</para></entry>
<entry role="parameter_description"><para>Number of requests to fit into the allocation</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>sizes</para></entry>
<entry role="parameter_description"><para>An array of structs with a client pointer and a minimum/natural size
in the orientation of the allocation.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-distribute-natural-allocation.returns" role="returns">
<title>Returns</title>
<para> The remainder of <parameter>extra_space</parameter>
after redistributing space
to <parameter>sizes</parameter>
.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-halign" role="function">
<title>gtk_widget_get_halign&#160;()</title>
<indexterm zone="gtk-widget-get-halign"><primary>gtk_widget_get_halign</primary></indexterm>
<programlisting language="C"><link linkend="GtkAlign"><returnvalue>GtkAlign</returnvalue></link>
gtk_widget_get_halign (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets the value of the <link linkend="GtkWidget--halign"><type>“halign”</type></link> property.</para>
<para>For backwards compatibility reasons this method will never return
<link linkend="GTK-ALIGN-BASELINE:CAPS"><literal>GTK_ALIGN_BASELINE</literal></link>, but instead it will convert it to
<link linkend="GTK-ALIGN-FILL:CAPS"><literal>GTK_ALIGN_FILL</literal></link>. Baselines are not supported for horizontal
alignment.</para>
<refsect3 id="gtk-widget-get-halign.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-halign.returns" role="returns">
<title>Returns</title>
<para> the horizontal alignment of <parameter>widget</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-halign" role="function">
<title>gtk_widget_set_halign&#160;()</title>
<indexterm zone="gtk-widget-set-halign"><primary>gtk_widget_set_halign</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_halign (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                       <parameter><link linkend="GtkAlign"><type>GtkAlign</type></link> align</parameter>);</programlisting>
<para>Sets the horizontal alignment of <parameter>widget</parameter>
.
See the <link linkend="GtkWidget--halign"><type>“halign”</type></link> property.</para>
<refsect3 id="gtk-widget-set-halign.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>align</para></entry>
<entry role="parameter_description"><para>the horizontal alignment</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-valign" role="function">
<title>gtk_widget_get_valign&#160;()</title>
<indexterm zone="gtk-widget-get-valign"><primary>gtk_widget_get_valign</primary></indexterm>
<programlisting language="C"><link linkend="GtkAlign"><returnvalue>GtkAlign</returnvalue></link>
gtk_widget_get_valign (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets the value of the <link linkend="GtkWidget--valign"><type>“valign”</type></link> property.</para>
<refsect3 id="gtk-widget-get-valign.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-valign.returns" role="returns">
<title>Returns</title>
<para> the vertical alignment of <parameter>widget</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-valign" role="function">
<title>gtk_widget_set_valign&#160;()</title>
<indexterm zone="gtk-widget-set-valign"><primary>gtk_widget_set_valign</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_valign (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                       <parameter><link linkend="GtkAlign"><type>GtkAlign</type></link> align</parameter>);</programlisting>
<para>Sets the vertical alignment of <parameter>widget</parameter>
.
See the <link linkend="GtkWidget--valign"><type>“valign”</type></link> property.</para>
<refsect3 id="gtk-widget-set-valign.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>align</para></entry>
<entry role="parameter_description"><para>the vertical alignment</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-margin-start" role="function">
<title>gtk_widget_get_margin_start&#160;()</title>
<indexterm zone="gtk-widget-get-margin-start"><primary>gtk_widget_get_margin_start</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_widget_get_margin_start (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets the value of the <link linkend="GtkWidget--margin-start"><type>“margin-start”</type></link> property.</para>
<refsect3 id="gtk-widget-get-margin-start.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-margin-start.returns" role="returns">
<title>Returns</title>
<para> The start margin of <parameter>widget</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-margin-start" role="function">
<title>gtk_widget_set_margin_start&#160;()</title>
<indexterm zone="gtk-widget-set-margin-start"><primary>gtk_widget_set_margin_start</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_margin_start (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                             <parameter><link linkend="gint"><type>gint</type></link> margin</parameter>);</programlisting>
<para>Sets the start margin of <parameter>widget</parameter>
.
See the <link linkend="GtkWidget--margin-start"><type>“margin-start”</type></link> property.</para>
<refsect3 id="gtk-widget-set-margin-start.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>margin</para></entry>
<entry role="parameter_description"><para>the start margin</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-margin-end" role="function">
<title>gtk_widget_get_margin_end&#160;()</title>
<indexterm zone="gtk-widget-get-margin-end"><primary>gtk_widget_get_margin_end</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_widget_get_margin_end (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets the value of the <link linkend="GtkWidget--margin-end"><type>“margin-end”</type></link> property.</para>
<refsect3 id="gtk-widget-get-margin-end.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-margin-end.returns" role="returns">
<title>Returns</title>
<para> The end margin of <parameter>widget</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-margin-end" role="function">
<title>gtk_widget_set_margin_end&#160;()</title>
<indexterm zone="gtk-widget-set-margin-end"><primary>gtk_widget_set_margin_end</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_margin_end (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                           <parameter><link linkend="gint"><type>gint</type></link> margin</parameter>);</programlisting>
<para>Sets the end margin of <parameter>widget</parameter>
.
See the <link linkend="GtkWidget--margin-end"><type>“margin-end”</type></link> property.</para>
<refsect3 id="gtk-widget-set-margin-end.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>margin</para></entry>
<entry role="parameter_description"><para>the end margin</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-margin-top" role="function">
<title>gtk_widget_get_margin_top&#160;()</title>
<indexterm zone="gtk-widget-get-margin-top"><primary>gtk_widget_get_margin_top</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_widget_get_margin_top (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets the value of the <link linkend="GtkWidget--margin-top"><type>“margin-top”</type></link> property.</para>
<refsect3 id="gtk-widget-get-margin-top.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-margin-top.returns" role="returns">
<title>Returns</title>
<para> The top margin of <parameter>widget</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-margin-top" role="function">
<title>gtk_widget_set_margin_top&#160;()</title>
<indexterm zone="gtk-widget-set-margin-top"><primary>gtk_widget_set_margin_top</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_margin_top (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                           <parameter><link linkend="gint"><type>gint</type></link> margin</parameter>);</programlisting>
<para>Sets the top margin of <parameter>widget</parameter>
.
See the <link linkend="GtkWidget--margin-top"><type>“margin-top”</type></link> property.</para>
<refsect3 id="gtk-widget-set-margin-top.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>margin</para></entry>
<entry role="parameter_description"><para>the top margin</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-margin-bottom" role="function">
<title>gtk_widget_get_margin_bottom&#160;()</title>
<indexterm zone="gtk-widget-get-margin-bottom"><primary>gtk_widget_get_margin_bottom</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_widget_get_margin_bottom (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets the value of the <link linkend="GtkWidget--margin-bottom"><type>“margin-bottom”</type></link> property.</para>
<refsect3 id="gtk-widget-get-margin-bottom.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-margin-bottom.returns" role="returns">
<title>Returns</title>
<para> The bottom margin of <parameter>widget</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-margin-bottom" role="function">
<title>gtk_widget_set_margin_bottom&#160;()</title>
<indexterm zone="gtk-widget-set-margin-bottom"><primary>gtk_widget_set_margin_bottom</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_margin_bottom (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                              <parameter><link linkend="gint"><type>gint</type></link> margin</parameter>);</programlisting>
<para>Sets the bottom margin of <parameter>widget</parameter>
.
See the <link linkend="GtkWidget--margin-bottom"><type>“margin-bottom”</type></link> property.</para>
<refsect3 id="gtk-widget-set-margin-bottom.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>margin</para></entry>
<entry role="parameter_description"><para>the bottom margin</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-hexpand" role="function">
<title>gtk_widget_get_hexpand&#160;()</title>
<indexterm zone="gtk-widget-get-hexpand"><primary>gtk_widget_get_hexpand</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_hexpand (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets whether the widget would like any available extra horizontal
space. When a user resizes a <link linkend="GtkWindow"><type>GtkWindow</type></link>, widgets with expand=TRUE
generally receive the extra space. For example, a list or
scrollable area or document in your window would often be set to
expand.</para>
<para>Containers should use <link linkend="gtk-widget-compute-expand"><function>gtk_widget_compute_expand()</function></link> rather than
this function, to see whether a widget, or any of its children,
has the expand flag set. If any child of a widget wants to
expand, the parent may ask to expand also.</para>
<para>This function only looks at the widget’s own hexpand flag, rather
than computing whether the entire widget tree rooted at this widget
wants to expand.</para>
<refsect3 id="gtk-widget-get-hexpand.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-hexpand.returns" role="returns">
<title>Returns</title>
<para> whether hexpand flag is set</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-hexpand" role="function">
<title>gtk_widget_set_hexpand&#160;()</title>
<indexterm zone="gtk-widget-set-hexpand"><primary>gtk_widget_set_hexpand</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_hexpand (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                        <parameter><link linkend="gboolean"><type>gboolean</type></link> expand</parameter>);</programlisting>
<para>Sets whether the widget would like any available extra horizontal
space. When a user resizes a <link linkend="GtkWindow"><type>GtkWindow</type></link>, widgets with expand=TRUE
generally receive the extra space. For example, a list or
scrollable area or document in your window would often be set to
expand.</para>
<para>Call this function to set the expand flag if you would like your
widget to become larger horizontally when the window has extra
room.</para>
<para>By default, widgets automatically expand if any of their children
want to expand. (To see if a widget will automatically expand given
its current children and state, call <link linkend="gtk-widget-compute-expand"><function>gtk_widget_compute_expand()</function></link>. A
container can decide how the expandability of children affects the
expansion of the container by overriding the compute_expand virtual
method on <link linkend="GtkWidget"><type>GtkWidget</type></link>.).</para>
<para>Setting hexpand explicitly with this function will override the
automatic expand behavior.</para>
<para>This function forces the widget to expand or not to expand,
regardless of children.  The override occurs because
<link linkend="gtk-widget-set-hexpand"><function>gtk_widget_set_hexpand()</function></link> sets the hexpand-set property (see
<link linkend="gtk-widget-set-hexpand-set"><function>gtk_widget_set_hexpand_set()</function></link>) which causes the widget’s hexpand
value to be used, rather than looking at children and widget state.</para>
<refsect3 id="gtk-widget-set-hexpand.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>expand</para></entry>
<entry role="parameter_description"><para>whether to expand</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-hexpand-set" role="function">
<title>gtk_widget_get_hexpand_set&#160;()</title>
<indexterm zone="gtk-widget-get-hexpand-set"><primary>gtk_widget_get_hexpand_set</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_hexpand_set (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets whether <link linkend="gtk-widget-set-hexpand"><function>gtk_widget_set_hexpand()</function></link> has been used to
explicitly set the expand flag on this widget.</para>
<para>If hexpand is set, then it overrides any computed
expand value based on child widgets. If hexpand is not
set, then the expand value depends on whether any
children of the widget would like to expand.</para>
<para>There are few reasons to use this function, but it’s here
for completeness and consistency.</para>
<refsect3 id="gtk-widget-get-hexpand-set.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-hexpand-set.returns" role="returns">
<title>Returns</title>
<para> whether hexpand has been explicitly set</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-hexpand-set" role="function">
<title>gtk_widget_set_hexpand_set&#160;()</title>
<indexterm zone="gtk-widget-set-hexpand-set"><primary>gtk_widget_set_hexpand_set</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_hexpand_set (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                            <parameter><link linkend="gboolean"><type>gboolean</type></link> set</parameter>);</programlisting>
<para>Sets whether the hexpand flag (see <link linkend="gtk-widget-get-hexpand"><function>gtk_widget_get_hexpand()</function></link>) will
be used.</para>
<para>The hexpand-set property will be set automatically when you call
<link linkend="gtk-widget-set-hexpand"><function>gtk_widget_set_hexpand()</function></link> to set hexpand, so the most likely
reason to use this function would be to unset an explicit expand
flag.</para>
<para>If hexpand is set, then it overrides any computed
expand value based on child widgets. If hexpand is not
set, then the expand value depends on whether any
children of the widget would like to expand.</para>
<para>There are few reasons to use this function, but it’s here
for completeness and consistency.</para>
<refsect3 id="gtk-widget-set-hexpand-set.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>set</para></entry>
<entry role="parameter_description"><para>value for hexpand-set property</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-vexpand" role="function">
<title>gtk_widget_get_vexpand&#160;()</title>
<indexterm zone="gtk-widget-get-vexpand"><primary>gtk_widget_get_vexpand</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_vexpand (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets whether the widget would like any available extra vertical
space.</para>
<para>See <link linkend="gtk-widget-get-hexpand"><function>gtk_widget_get_hexpand()</function></link> for more detail.</para>
<refsect3 id="gtk-widget-get-vexpand.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-vexpand.returns" role="returns">
<title>Returns</title>
<para> whether vexpand flag is set</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-vexpand" role="function">
<title>gtk_widget_set_vexpand&#160;()</title>
<indexterm zone="gtk-widget-set-vexpand"><primary>gtk_widget_set_vexpand</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_vexpand (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                        <parameter><link linkend="gboolean"><type>gboolean</type></link> expand</parameter>);</programlisting>
<para>Sets whether the widget would like any available extra vertical
space.</para>
<para>See <link linkend="gtk-widget-set-hexpand"><function>gtk_widget_set_hexpand()</function></link> for more detail.</para>
<refsect3 id="gtk-widget-set-vexpand.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>expand</para></entry>
<entry role="parameter_description"><para>whether to expand</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-vexpand-set" role="function">
<title>gtk_widget_get_vexpand_set&#160;()</title>
<indexterm zone="gtk-widget-get-vexpand-set"><primary>gtk_widget_get_vexpand_set</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_get_vexpand_set (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Gets whether <link linkend="gtk-widget-set-vexpand"><function>gtk_widget_set_vexpand()</function></link> has been used to
explicitly set the expand flag on this widget.</para>
<para>See <link linkend="gtk-widget-get-hexpand-set"><function>gtk_widget_get_hexpand_set()</function></link> for more detail.</para>
<refsect3 id="gtk-widget-get-vexpand-set.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-vexpand-set.returns" role="returns">
<title>Returns</title>
<para> whether vexpand has been explicitly set</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-set-vexpand-set" role="function">
<title>gtk_widget_set_vexpand_set&#160;()</title>
<indexterm zone="gtk-widget-set-vexpand-set"><primary>gtk_widget_set_vexpand_set</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_set_vexpand_set (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                            <parameter><link linkend="gboolean"><type>gboolean</type></link> set</parameter>);</programlisting>
<para>Sets whether the vexpand flag (see <link linkend="gtk-widget-get-vexpand"><function>gtk_widget_get_vexpand()</function></link>) will
be used.</para>
<para>See <link linkend="gtk-widget-set-hexpand-set"><function>gtk_widget_set_hexpand_set()</function></link> for more detail.</para>
<refsect3 id="gtk-widget-set-vexpand-set.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>set</para></entry>
<entry role="parameter_description"><para>value for vexpand-set property</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-compute-expand" role="function">
<title>gtk_widget_compute_expand&#160;()</title>
<indexterm zone="gtk-widget-compute-expand"><primary>gtk_widget_compute_expand</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_compute_expand (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                           <parameter><link linkend="GtkOrientation"><type>GtkOrientation</type></link> orientation</parameter>);</programlisting>
<para>Computes whether a container should give this widget extra space
when possible. Containers should check this, rather than
looking at <link linkend="gtk-widget-get-hexpand"><function>gtk_widget_get_hexpand()</function></link> or <link linkend="gtk-widget-get-vexpand"><function>gtk_widget_get_vexpand()</function></link>.</para>
<para>This function already checks whether the widget is visible, so
visibility does not need to be checked separately. Non-visible
widgets are not expanded.</para>
<para>The computed expand value uses either the expand setting explicitly
set on the widget itself, or, if none has been explicitly set,
the widget may expand if some of its children do.</para>
<refsect3 id="gtk-widget-compute-expand.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>orientation</para></entry>
<entry role="parameter_description"><para>expand direction</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-compute-expand.returns" role="returns">
<title>Returns</title>
<para> whether widget tree rooted here should be expanded</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-init-template" role="function">
<title>gtk_widget_init_template&#160;()</title>
<indexterm zone="gtk-widget-init-template"><primary>gtk_widget_init_template</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_init_template (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Creates and initializes child widgets defined in templates. This
function must be called in the instance initializer for any
class which assigned itself a template using <link linkend="gtk-widget-class-set-template"><function>gtk_widget_class_set_template()</function></link></para>
<para>It is important to call this function in the instance initializer
of a <link linkend="GtkWidget"><type>GtkWidget</type></link> subclass and not in <link linkend="GObject.constructed"><function>GObject.constructed()</function></link> or
<link linkend="GObject.constructor"><function>GObject.constructor()</function></link> for two reasons.</para>
<para>One reason is that generally derived widgets will assume that parent
class composite widgets have been created in their instance
initializers.</para>
<para>Another reason is that when calling <link linkend="g-object-new"><function>g_object_new()</function></link> on a widget with
composite templates, it’s important to build the composite widgets
before the construct properties are set. Properties passed to <link linkend="g-object-new"><function>g_object_new()</function></link>
should take precedence over properties set in the private template XML.</para>
<refsect3 id="gtk-widget-init-template.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-set-template" role="function">
<title>gtk_widget_class_set_template&#160;()</title>
<indexterm zone="gtk-widget-class-set-template"><primary>gtk_widget_class_set_template</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_set_template (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                               <parameter><link linkend="GBytes"><type>GBytes</type></link> *template_bytes</parameter>);</programlisting>
<para>This should be called at class initialization time to specify
the GtkBuilder XML to be used to extend a widget.</para>
<para>For convenience, <link linkend="gtk-widget-class-set-template-from-resource"><function>gtk_widget_class_set_template_from_resource()</function></link> is also provided.</para>
<para>Note that any class that installs templates must call <link linkend="gtk-widget-init-template"><function>gtk_widget_init_template()</function></link>
in the widget’s instance initializer.</para>
<refsect3 id="gtk-widget-class-set-template.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>template_bytes</para></entry>
<entry role="parameter_description"><para>A <link linkend="GBytes"><type>GBytes</type></link> holding the <link linkend="GtkBuilder"><type>GtkBuilder</type></link> XML </para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-set-template-from-resource" role="function">
<title>gtk_widget_class_set_template_from_resource&#160;()</title>
<indexterm zone="gtk-widget-class-set-template-from-resource"><primary>gtk_widget_class_set_template_from_resource</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_set_template_from_resource
                               (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *resource_name</parameter>);</programlisting>
<para>A convenience function to call <link linkend="gtk-widget-class-set-template"><function>gtk_widget_class_set_template()</function></link>.</para>
<para>Note that any class that installs templates must call <link linkend="gtk-widget-init-template"><function>gtk_widget_init_template()</function></link>
in the widget’s instance initializer.</para>
<refsect3 id="gtk-widget-class-set-template-from-resource.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>resource_name</para></entry>
<entry role="parameter_description"><para>The name of the resource to load the template from</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-get-template-child" role="function">
<title>gtk_widget_get_template_child&#160;()</title>
<indexterm zone="gtk-widget-get-template-child"><primary>gtk_widget_get_template_child</primary></indexterm>
<programlisting language="C"><link linkend="GObject"><returnvalue>GObject</returnvalue></link>&#160;*
gtk_widget_get_template_child (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                               <parameter><link linkend="GType"><type>GType</type></link> widget_type</parameter>,
                               <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>);</programlisting>
<para>Fetch an object build from the template XML for <parameter>widget_type</parameter>
 in this <parameter>widget</parameter>
 instance.</para>
<para>This will only report children which were previously declared with
<link linkend="gtk-widget-class-bind-template-child-full"><function>gtk_widget_class_bind_template_child_full()</function></link> or one of its
variants.</para>
<para>This function is only meant to be called for code which is private to the <parameter>widget_type</parameter>
 which
declared the child and is meant for language bindings which cannot easily make use
of the GObject structure offsets.</para>
<refsect3 id="gtk-widget-get-template-child.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>widget_type</para></entry>
<entry role="parameter_description"><para>The <link linkend="GType"><type>GType</type></link> to get a template child for</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>The “id” of the child defined in the template XML</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-get-template-child.returns" role="returns">
<title>Returns</title>
<para>The object built in the template XML with the id <parameter>name</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-bind-template-child" role="macro">
<title>gtk_widget_class_bind_template_child()</title>
<indexterm zone="gtk-widget-class-bind-template-child"><primary>gtk_widget_class_bind_template_child</primary></indexterm>
<programlisting language="C">#define             gtk_widget_class_bind_template_child(widget_class, TypeName, member_name)</programlisting>
<para>Binds a child widget defined in a template to the <parameter>widget_class</parameter>
.</para>
<para>This macro is a convenience wrapper around the
<link linkend="gtk-widget-class-bind-template-child-full"><function>gtk_widget_class_bind_template_child_full()</function></link> function.</para>
<para>This macro will use the offset of the <parameter>member_name</parameter>
 inside the <parameter>TypeName</parameter>

instance structure.</para>
<refsect3 id="gtk-widget-class-bind-template-child.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>TypeName</para></entry>
<entry role="parameter_description"><para>the type name of this widget</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>member_name</para></entry>
<entry role="parameter_description"><para>name of the instance member in the instance struct for <parameter>data_type</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-bind-template-child-internal" role="macro">
<title>gtk_widget_class_bind_template_child_internal()</title>
<indexterm zone="gtk-widget-class-bind-template-child-internal"><primary>gtk_widget_class_bind_template_child_internal</primary></indexterm>
<programlisting language="C">#define             gtk_widget_class_bind_template_child_internal(widget_class, TypeName, member_name)</programlisting>
<para>Binds a child widget defined in a template to the <parameter>widget_class</parameter>
, and
also makes it available as an internal child in GtkBuilder, under the
name <parameter>member_name</parameter>
.</para>
<para>This macro is a convenience wrapper around the
<link linkend="gtk-widget-class-bind-template-child-full"><function>gtk_widget_class_bind_template_child_full()</function></link> function.</para>
<para>This macro will use the offset of the <parameter>member_name</parameter>
 inside the <parameter>TypeName</parameter>

instance structure.</para>
<refsect3 id="gtk-widget-class-bind-template-child-internal.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>TypeName</para></entry>
<entry role="parameter_description"><para>the type name, in CamelCase</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>member_name</para></entry>
<entry role="parameter_description"><para>name of the instance member in the instance struct for <parameter>data_type</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-bind-template-child-private" role="macro">
<title>gtk_widget_class_bind_template_child_private()</title>
<indexterm zone="gtk-widget-class-bind-template-child-private"><primary>gtk_widget_class_bind_template_child_private</primary></indexterm>
<programlisting language="C">#define             gtk_widget_class_bind_template_child_private(widget_class, TypeName, member_name)</programlisting>
<para>Binds a child widget defined in a template to the <parameter>widget_class</parameter>
.</para>
<para>This macro is a convenience wrapper around the
<link linkend="gtk-widget-class-bind-template-child-full"><function>gtk_widget_class_bind_template_child_full()</function></link> function.</para>
<para>This macro will use the offset of the <parameter>member_name</parameter>
 inside the <parameter>TypeName</parameter>

private data structure (it uses <link linkend="G-PRIVATE-OFFSET:CAPS"><function>G_PRIVATE_OFFSET()</function></link>, so the private struct
must be added with <link linkend="G-ADD-PRIVATE:CAPS"><function>G_ADD_PRIVATE()</function></link>).</para>
<refsect3 id="gtk-widget-class-bind-template-child-private.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>TypeName</para></entry>
<entry role="parameter_description"><para>the type name of this widget</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>member_name</para></entry>
<entry role="parameter_description"><para>name of the instance private member in the private struct for <parameter>data_type</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-bind-template-child-internal-private" role="macro">
<title>gtk_widget_class_bind_template_child_internal_private()</title>
<indexterm zone="gtk-widget-class-bind-template-child-internal-private"><primary>gtk_widget_class_bind_template_child_internal_private</primary></indexterm>
<programlisting language="C">#define             gtk_widget_class_bind_template_child_internal_private(widget_class, TypeName, member_name)</programlisting>
<para>Binds a child widget defined in a template to the <parameter>widget_class</parameter>
, and
also makes it available as an internal child in GtkBuilder, under the
name <parameter>member_name</parameter>
.</para>
<para>This macro is a convenience wrapper around the
<link linkend="gtk-widget-class-bind-template-child-full"><function>gtk_widget_class_bind_template_child_full()</function></link> function.</para>
<para>This macro will use the offset of the <parameter>member_name</parameter>
 inside the <parameter>TypeName</parameter>

private data structure.</para>
<refsect3 id="gtk-widget-class-bind-template-child-internal-private.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>TypeName</para></entry>
<entry role="parameter_description"><para>the type name, in CamelCase</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>member_name</para></entry>
<entry role="parameter_description"><para>name of the instance private member on the private struct for <parameter>data_type</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-bind-template-child-full" role="function">
<title>gtk_widget_class_bind_template_child_full&#160;()</title>
<indexterm zone="gtk-widget-class-bind-template-child-full"><primary>gtk_widget_class_bind_template_child_full</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_bind_template_child_full
                               (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                                <parameter><link linkend="gboolean"><type>gboolean</type></link> internal_child</parameter>,
                                <parameter><link linkend="gssize"><type>gssize</type></link> struct_offset</parameter>);</programlisting>
<para>Automatically assign an object declared in the class template XML to be set to a location
on a freshly built instance’s private data, or alternatively accessible via <link linkend="gtk-widget-get-template-child"><function>gtk_widget_get_template_child()</function></link>.</para>
<para>The struct can point either into the public instance, then you should use G_STRUCT_OFFSET(WidgetType, member)
for <parameter>struct_offset</parameter>
,  or in the private struct, then you should use G_PRIVATE_OFFSET(WidgetType, member).</para>
<para>An explicit strong reference will be held automatically for the duration of your
instance’s life cycle, it will be released automatically when <link linkend="GObjectClass.dispose"><function>GObjectClass.dispose()</function></link> runs
on your instance and if a <parameter>struct_offset</parameter>
 that is != 0 is specified, then the automatic location
in your instance public or private data will be set to <link linkend="NULL:CAPS"><literal>NULL</literal></link>. You can however access an automated child
pointer the first time your classes <link linkend="GObjectClass.dispose"><function>GObjectClass.dispose()</function></link> runs, or alternatively in
<link linkend="GtkWidgetClass.destroy"><function>GtkWidgetClass.destroy()</function></link>.</para>
<para>If <parameter>internal_child</parameter>
 is specified, <link linkend="GtkBuildableIface.get-internal-child"><function>GtkBuildableIface.get_internal_child()</function></link> will be automatically
implemented by the <link linkend="GtkWidget"><type>GtkWidget</type></link> class so there is no need to implement it manually.</para>
<para>The wrapper macros <link linkend="gtk-widget-class-bind-template-child"><function>gtk_widget_class_bind_template_child()</function></link>, <link linkend="gtk-widget-class-bind-template-child-internal"><function>gtk_widget_class_bind_template_child_internal()</function></link>,
<link linkend="gtk-widget-class-bind-template-child-private"><function>gtk_widget_class_bind_template_child_private()</function></link> and <link linkend="gtk-widget-class-bind-template-child-internal-private"><function>gtk_widget_class_bind_template_child_internal_private()</function></link>
might be more convenient to use.</para>
<para>Note that this must be called from a composite widget classes class
initializer after calling <link linkend="gtk-widget-class-set-template"><function>gtk_widget_class_set_template()</function></link>.</para>
<refsect3 id="gtk-widget-class-bind-template-child-full.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>The “id” of the child defined in the template XML</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>internal_child</para></entry>
<entry role="parameter_description"><para>Whether the child should be accessible as an “internal-child”
when this class is used in GtkBuilder XML</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>struct_offset</para></entry>
<entry role="parameter_description"><para>The structure offset into the composite widget’s instance public or private structure
where the automated child pointer should be set, or 0 to not assign the pointer.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-bind-template-callback" role="macro">
<title>gtk_widget_class_bind_template_callback()</title>
<indexterm zone="gtk-widget-class-bind-template-callback"><primary>gtk_widget_class_bind_template_callback</primary></indexterm>
<programlisting language="C">#define             gtk_widget_class_bind_template_callback(widget_class, callback)</programlisting>
<para>Binds a callback function defined in a template to the <parameter>widget_class</parameter>
.</para>
<para>This macro is a convenience wrapper around the
<link linkend="gtk-widget-class-bind-template-callback-full"><function>gtk_widget_class_bind_template_callback_full()</function></link> function. It is not
supported after <link linkend="gtk-widget-class-set-template-scope"><function>gtk_widget_class_set_template_scope()</function></link> has been used
on <parameter>widget_class</parameter>
.</para>
<refsect3 id="gtk-widget-class-bind-template-callback.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>callback</para></entry>
<entry role="parameter_description"><para>the callback symbol</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-bind-template-callback-full" role="function">
<title>gtk_widget_class_bind_template_callback_full&#160;()</title>
<indexterm zone="gtk-widget-class-bind-template-callback-full"><primary>gtk_widget_class_bind_template_callback_full</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_bind_template_callback_full
                               (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *callback_name</parameter>,
                                <parameter><link linkend="GCallback"><type>GCallback</type></link> callback_symbol</parameter>);</programlisting>
<para>Declares a <parameter>callback_symbol</parameter>
 to handle <parameter>callback_name</parameter>
 from the template XML
defined for <parameter>widget_type</parameter>
. This function is not supported after
<link linkend="gtk-widget-class-set-template-scope"><function>gtk_widget_class_set_template_scope()</function></link> has been used on <parameter>widget_class</parameter>
.
See <link linkend="gtk-builder-cscope-add-callback-symbol"><function>gtk_builder_cscope_add_callback_symbol()</function></link>.</para>
<para>Note that this must be called from a composite widget classes class
initializer after calling <link linkend="gtk-widget-class-set-template"><function>gtk_widget_class_set_template()</function></link>.</para>
<refsect3 id="gtk-widget-class-bind-template-callback-full.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>callback_name</para></entry>
<entry role="parameter_description"><para>The name of the callback as expected in the template XML</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>callback_symbol</para></entry>
<entry role="parameter_description"><para>The callback symbol. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>scope async</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-set-template-scope" role="function">
<title>gtk_widget_class_set_template_scope&#160;()</title>
<indexterm zone="gtk-widget-class-set-template-scope"><primary>gtk_widget_class_set_template_scope</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_set_template_scope (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                                     <parameter><link linkend="GtkBuilderScope"><type>GtkBuilderScope</type></link> *scope</parameter>);</programlisting>
<para>For use in language bindings, this will override the default <link linkend="GtkBuilderScope"><type>GtkBuilderScope</type></link> to be
used when parsing GtkBuilder XML from this class’s template data.</para>
<para>Note that this must be called from a composite widget classes class
initializer after calling <link linkend="gtk-widget-class-set-template"><function>gtk_widget_class_set_template()</function></link>.</para>
<refsect3 id="gtk-widget-class-set-template-scope.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>A <link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>scope</para></entry>
<entry role="parameter_description"><para>The <link linkend="GtkBuilderScope"><type>GtkBuilderScope</type></link> to use when loading the class template. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-observe-children" role="function">
<title>gtk_widget_observe_children&#160;()</title>
<indexterm zone="gtk-widget-observe-children"><primary>gtk_widget_observe_children</primary></indexterm>
<programlisting language="C"><link linkend="GListModel"><returnvalue>GListModel</returnvalue></link>&#160;*
gtk_widget_observe_children (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns a <link linkend="GListModel"><type>GListModel</type></link> to track the children of <parameter>widget</parameter>
. </para>
<para>Calling this function will enable extra internal bookkeeping to track
children and emit signals on the returned listmodel. It may slow down
operations a lot.</para>
<para>Applications should try hard to avoid calling this function because of
the slowdowns.</para>
<refsect3 id="gtk-widget-observe-children.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-observe-children.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="GListModel"><type>GListModel</type></link>
tracking <parameter>widget</parameter>
's children. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>][<acronym>attributes</acronym> element-type=GtkWidget]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-observe-controllers" role="function">
<title>gtk_widget_observe_controllers&#160;()</title>
<indexterm zone="gtk-widget-observe-controllers"><primary>gtk_widget_observe_controllers</primary></indexterm>
<programlisting language="C"><link linkend="GListModel"><returnvalue>GListModel</returnvalue></link>&#160;*
gtk_widget_observe_controllers (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Returns a <link linkend="GListModel"><type>GListModel</type></link> to track the <link linkend="GtkEventControllers"><type>GtkEventControllers</type></link> of <parameter>widget</parameter>
. </para>
<para>Calling this function will enable extra internal bookkeeping to track
controllers and emit signals on the returned listmodel. It may slow down
operations a lot.</para>
<para>Applications should try hard to avoid calling this function because of
the slowdowns.</para>
<refsect3 id="gtk-widget-observe-controllers.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-observe-controllers.returns" role="returns">
<title>Returns</title>
<para>a
<link linkend="GListModel"><type>GListModel</type></link> tracking <parameter>widget</parameter>
's controllers. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>][<acronym>attributes</acronym> element-type=GtkEventController]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-insert-action-group" role="function">
<title>gtk_widget_insert_action_group&#160;()</title>
<indexterm zone="gtk-widget-insert-action-group"><primary>gtk_widget_insert_action_group</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_insert_action_group (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                                <parameter><link linkend="GActionGroup"><type>GActionGroup</type></link> *group</parameter>);</programlisting>
<para>Inserts <parameter>group</parameter>
 into <parameter>widget</parameter>
. Children of <parameter>widget</parameter>
 that implement
<link linkend="GtkActionable"><type>GtkActionable</type></link> can then be associated with actions in <parameter>group</parameter>
 by
setting their “action-name” to <parameter>prefix</parameter>
.<literal>action-name</literal>.</para>
<para>Note that inheritance is defined for individual actions. I.e.
even if you insert a group with prefix <parameter>prefix</parameter>
, actions with
the same prefix will still be inherited from the parent, unless
the group contains an action with the same name.</para>
<para>If <parameter>group</parameter>
 is <link linkend="NULL:CAPS"><literal>NULL</literal></link>, a previously inserted group for <parameter>name</parameter>
 is
removed from <parameter>widget</parameter>
.</para>
<refsect3 id="gtk-widget-insert-action-group.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>the prefix for actions in <parameter>group</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>group</para></entry>
<entry role="parameter_description"><para>a <link linkend="GActionGroup"><type>GActionGroup</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-activate-action" role="function">
<title>gtk_widget_activate_action&#160;()</title>
<indexterm zone="gtk-widget-activate-action"><primary>gtk_widget_activate_action</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_activate_action (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                            <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                            <parameter>const <link linkend="char"><type>char</type></link> *format_string</parameter>,
                            <parameter>...</parameter>);</programlisting>
<para>Looks up the action in the action groups associated
with <parameter>widget</parameter>
 and its ancestors, and activates it.</para>
<para>This is a wrapper around <link linkend="gtk-widget-activate-action-variant"><function>gtk_widget_activate_action_variant()</function></link>
that constructs the <parameter>args</parameter>
 variant according to <parameter>format_string</parameter>
.</para>
<refsect3 id="gtk-widget-activate-action.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>the name of the action to activate</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>format_string</para></entry>
<entry role="parameter_description"><para>GVariant format string for arguments or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
for no arguments</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>...</para></entry>
<entry role="parameter_description"><para>arguments, as given by format string</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-activate-action.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the action was activated, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if the action does
not exist.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-activate-action-variant" role="function">
<title>gtk_widget_activate_action_variant&#160;()</title>
<indexterm zone="gtk-widget-activate-action-variant"><primary>gtk_widget_activate_action_variant</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_activate_action_variant (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                    <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>,
                                    <parameter><link linkend="GVariant"><type>GVariant</type></link> *args</parameter>);</programlisting>
<para>Looks up the action in the action groups associated
with <parameter>widget</parameter>
 and its ancestors, and activates it.</para>
<para>If the action is in an action group added with
<link linkend="gtk-widget-insert-action-group"><function>gtk_widget_insert_action_group()</function></link>, the <parameter>name</parameter>
 is
expected to be prefixed with the prefix that was
used when the group was inserted.</para>
<para>The arguments must match the actions expected parameter
type, as returned by <link linkend="g-action-get-parameter-type"><function>g_action_get_parameter_type()</function></link>.</para>

<para><emphasis role="annotation">[<acronym>rename-to</acronym> gtk_widget_activate_action]</emphasis></para><refsect3 id="gtk-widget-activate-action-variant.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>the name of the action to activate</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>args</para></entry>
<entry role="parameter_description"><para>parameters to use, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-activate-action-variant.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the action was activated, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if the action does
not exist.</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-activate-default" role="function">
<title>gtk_widget_activate_default&#160;()</title>
<indexterm zone="gtk-widget-activate-default"><primary>gtk_widget_activate_default</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_activate_default (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>);</programlisting>
<para>Activate the default.activate action from <parameter>widget</parameter>
.</para>
<refsect3 id="gtk-widget-activate-default.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="GtkWidgetActionActivateFunc" role="function">
<title>GtkWidgetActionActivateFunc&#160;()</title>
<indexterm zone="GtkWidgetActionActivateFunc"><primary>GtkWidgetActionActivateFunc</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
<phrase role="c_punctuation">(</phrase>*GtkWidgetActionActivateFunc<phrase role="c_punctuation">)</phrase> (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                                <parameter>const <link linkend="char"><type>char</type></link> *action_name</parameter>,
                                <parameter><link linkend="GVariant"><type>GVariant</type></link> *parameter</parameter>);</programlisting>
<para>The type of the callback functions used for activating
actions installed with <link linkend="gtk-widget-class-install-action"><function>gtk_widget_class_install_action()</function></link>.</para>
<para>The <parameter>parameter</parameter>
 must match the <parameter>parameter_type</parameter>
 of the action.</para>
<refsect3 id="GtkWidgetActionActivateFunc.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the widget to which the action belongs</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>action_name</para></entry>
<entry role="parameter_description"><para>the action name</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>parameter</para></entry>
<entry role="parameter_description"><para>parameter for activation</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-install-action" role="function">
<title>gtk_widget_class_install_action&#160;()</title>
<indexterm zone="gtk-widget-class-install-action"><primary>gtk_widget_class_install_action</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_install_action (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                                 <parameter>const <link linkend="char"><type>char</type></link> *action_name</parameter>,
                                 <parameter>const <link linkend="char"><type>char</type></link> *parameter_type</parameter>,
                                 <parameter><link linkend="GtkWidgetActionActivateFunc"><type>GtkWidgetActionActivateFunc</type></link> activate</parameter>);</programlisting>
<para>This should be called at class initialization time to specify
actions to be added for all instances of this class.</para>
<para>Actions installed by this function are stateless. The only state
they have is whether they are enabled or not.</para>
<refsect3 id="gtk-widget-class-install-action.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>action_name</para></entry>
<entry role="parameter_description"><para>a prefixed action name, such as "clipboard.paste"</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>parameter_type</para></entry>
<entry role="parameter_description"><para>the parameter type, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>activate</para></entry>
<entry role="parameter_description"><para>callback to use when the action is activated. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>scope call</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-install-property-action" role="function">
<title>gtk_widget_class_install_property_action&#160;()</title>
<indexterm zone="gtk-widget-class-install-property-action"><primary>gtk_widget_class_install_property_action</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_class_install_property_action
                               (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                                <parameter>const <link linkend="char"><type>char</type></link> *action_name</parameter>,
                                <parameter>const <link linkend="char"><type>char</type></link> *property_name</parameter>);</programlisting>
<para>Installs an action called <parameter>action_name</parameter>
 on <parameter>widget_class</parameter>
 and binds its
state to the value of the <parameter>property_name</parameter>
 property.</para>
<para>This function will perform a few santity checks on the property selected
via <parameter>property_name</parameter>
. Namely, the property must exist, must be readable,
writable and must not be construct-only. There are also restrictions
on the type of the given property, it must be boolean, int, unsigned int,
double or string. If any of these conditions are not met, a critical
warning will be printed and no action will be added.</para>
<para>The state type of the action matches the property type.</para>
<para>If the property is boolean, the action will have no parameter and
toggle the property value. Otherwise, the action will have a parameter
of the same type as the property.</para>
<refsect3 id="gtk-widget-class-install-property-action.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>action_name</para></entry>
<entry role="parameter_description"><para>name of the action</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>property_name</para></entry>
<entry role="parameter_description"><para>name of the property in instances of <parameter>widget_class</parameter>
or any parent class.</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-widget-class-query-action" role="function">
<title>gtk_widget_class_query_action&#160;()</title>
<indexterm zone="gtk-widget-class-query-action"><primary>gtk_widget_class_query_action</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_widget_class_query_action (<parameter><link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link> *widget_class</parameter>,
                               <parameter><link linkend="guint"><type>guint</type></link> index_</parameter>,
                               <parameter><link linkend="GType"><type>GType</type></link> *owner</parameter>,
                               <parameter>const <link linkend="char"><type>char</type></link> **action_name</parameter>,
                               <parameter>const <link linkend="GVariantType"><type>GVariantType</type></link> **parameter_type</parameter>,
                               <parameter>const <link linkend="char"><type>char</type></link> **property_name</parameter>);</programlisting>
<para>Queries the actions that have been installed for
a widget class using <link linkend="gtk-widget-class-install-action"><function>gtk_widget_class_install_action()</function></link>
during class initialization.</para>
<para>Note that this function will also return actions defined
by parent classes. You can identify those by looking
at <parameter>owner</parameter>
.</para>
<refsect3 id="gtk-widget-class-query-action.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget_class</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidgetClass"><type>GtkWidgetClass</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>index_</para></entry>
<entry role="parameter_description"><para>position of the action to query</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>owner</para></entry>
<entry role="parameter_description"><para>return location for the type where the action was defined. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>action_name</para></entry>
<entry role="parameter_description"><para>return location for the action name. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>parameter_type</para></entry>
<entry role="parameter_description"><para>return location for the parameter type. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>property_name</para></entry>
<entry role="parameter_description"><para>return location for the property name. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-widget-class-query-action.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the action was found,
<link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if <parameter>index_</parameter>
is out of range</para>
</refsect3></refsect2>
<refsect2 id="gtk-widget-action-set-enabled" role="function">
<title>gtk_widget_action_set_enabled&#160;()</title>
<indexterm zone="gtk-widget-action-set-enabled"><primary>gtk_widget_action_set_enabled</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_widget_action_set_enabled (<parameter><link linkend="GtkWidget"><type>GtkWidget</type></link> *widget</parameter>,
                               <parameter>const <link linkend="char"><type>char</type></link> *action_name</parameter>,
                               <parameter><link linkend="gboolean"><type>gboolean</type></link> enabled</parameter>);</programlisting>
<para>Enable or disable an action installed with
<link linkend="gtk-widget-class-install-action"><function>gtk_widget_class_install_action()</function></link>.</para>
<refsect3 id="gtk-widget-action-set-enabled.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkWidget"><type>GtkWidget</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>action_name</para></entry>
<entry role="parameter_description"><para>action name, such as "clipboard.paste"</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>enabled</para></entry>
<entry role="parameter_description"><para>whether the action is now enabled</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkWidget.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkWidget-struct" role="struct">
<title>GtkWidget</title>
<indexterm zone="GtkWidget-struct"><primary>GtkWidget</primary></indexterm>
<programlisting language="C">typedef struct _GtkWidget GtkWidget;</programlisting>
</refsect2>
<refsect2 id="GtkWidgetClass" role="struct">
<title>struct GtkWidgetClass</title>
<indexterm zone="GtkWidgetClass"><primary>GtkWidgetClass</primary></indexterm>
<programlisting language="C">struct GtkWidgetClass {
  GInitiallyUnownedClass parent_class;

  guint activate_signal;

  /* basics */
  void (* show)                (GtkWidget        *widget);
  void (* hide)                (GtkWidget        *widget);
  void (* map)                 (GtkWidget        *widget);
  void (* unmap)               (GtkWidget        *widget);
  void (* realize)             (GtkWidget        *widget);
  void (* unrealize)           (GtkWidget        *widget);
  void (* root)                (GtkWidget        *widget);
  void (* unroot)              (GtkWidget        *widget);
  void (* size_allocate)       (GtkWidget           *widget,
                                int                  width,
                                int                  height,
                                int                  baseline);
  void (* state_flags_changed) (GtkWidget        *widget,
                                GtkStateFlags     previous_state_flags);
  void (* direction_changed)   (GtkWidget        *widget,
                                GtkTextDirection  previous_direction);
  void (* grab_notify)         (GtkWidget        *widget,
                                gboolean          was_grabbed);

  /* size requests */
  GtkSizeRequestMode (* get_request_mode)               (GtkWidget      *widget);
  void              (* measure) (GtkWidget      *widget,
                                 GtkOrientation  orientation,
                                 int             for_size,
                                 int            *minimum,
                                 int            *natural,
                                 int            *minimum_baseline,
                                 int            *natural_baseline);

  /* Mnemonics */
  gboolean (* mnemonic_activate)        (GtkWidget           *widget,
                                         gboolean             group_cycling);

  /* explicit focus */
  gboolean (* grab_focus)               (GtkWidget           *widget);
  gboolean (* focus)                    (GtkWidget           *widget,
                                         GtkDirectionType     direction);
  void     (* set_focus_child)          (GtkWidget           *widget,
                                         GtkWidget           *child);

  /* keyboard navigation */
  void     (* move_focus)               (GtkWidget           *widget,
                                         GtkDirectionType     direction);
  gboolean (* keynav_failed)            (GtkWidget           *widget,
                                         GtkDirectionType     direction);

  /* accessibility support
   */
  AtkObject *  (* get_accessible)     (GtkWidget       *widget);

  gboolean     (* query_tooltip)      (GtkWidget  *widget,
                                       gint        x,
                                       gint        y,
                                       gboolean    keyboard_tooltip,
                                       GtkTooltip *tooltip);

  void         (* compute_expand)     (GtkWidget  *widget,
                                       gboolean   *hexpand_p,
                                       gboolean   *vexpand_p);

  void         (* css_changed)                 (GtkWidget            *widget,
                                                GtkCssStyleChange    *change);

  void         (* system_setting_changed)      (GtkWidget            *widget,
                                                GtkSystemSetting      settings);

  void         (* snapshot)                    (GtkWidget            *widget,
                                                GtkSnapshot          *snapshot);

  gboolean     (* contains)                    (GtkWidget *widget,
                                                gdouble    x,
                                                gdouble    y);
};
</programlisting>
<refsect3 id="GtkWidgetClass.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="guint"><type>guint</type></link>&#160;<structfield id="GtkWidgetClass.activate-signal">activate_signal</structfield>;</para></entry>
<entry role="struct_member_description"><para>The signal to emit when a widget of this class is
activated, <link linkend="gtk-widget-activate"><function>gtk_widget_activate()</function></link> handles the emission.
Implementation of this signal is optional.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.show">show</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Signal emitted when widget is shown</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.hide">hide</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Signal emitted when widget is hidden.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.map">map</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Signal emitted when widget is going to be mapped, that is
when the widget is visible (which is controlled with
<link linkend="gtk-widget-set-visible"><function>gtk_widget_set_visible()</function></link>) and all its parents up to the toplevel
widget are also visible.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.unmap">unmap</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Signal emitted when widget is going to be unmapped, which
means that either it or any of its parents up to the toplevel
widget have been set as hidden.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.realize">realize</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Signal emitted when widget is associated with a
<link linkend="GdkSurface"><type>GdkSurface</type></link>, which means that <link linkend="gtk-widget-realize"><function>gtk_widget_realize()</function></link> has been called or
the widget has been mapped (that is, it is going to be drawn).</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.unrealize">unrealize</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Signal emitted when the GdkSurface associated with
widget is destroyed, which means that <link linkend="gtk-widget-unrealize"><function>gtk_widget_unrealize()</function></link> has
been called or the widget has been unmapped (that is, it is going
to be hidden).</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.root">root</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Called when the widget gets added to a <link linkend="GtkRoot"><type>GtkRoot</type></link> widget. Must chain up</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.unroot">unroot</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Called when the widget is about to be removed from its <link linkend="GtkRoot"><type>GtkRoot</type></link> widget. Must chain up</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.size-allocate">size_allocate</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Signal emitted to get the widget allocation.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.state-flags-changed">state_flags_changed</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Signal emitted when the widget state changes,
see <link linkend="gtk-widget-get-state-flags"><function>gtk_widget_get_state_flags()</function></link>.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.direction-changed">direction_changed</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Signal emitted when the text direction of a
widget changes.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.grab-notify">grab_notify</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Signal emitted when a widget becomes shadowed by a
GTK+ grab (not a pointer or keyboard grab) on another widget, or
when it becomes unshadowed due to a grab being removed.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.get-request-mode">get_request_mode</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>This allows a widget to tell its parent container whether
it prefers to be allocated in <link linkend="GTK-SIZE-REQUEST-HEIGHT-FOR-WIDTH:CAPS"><literal>GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH</literal></link> or
<link linkend="GTK-SIZE-REQUEST-WIDTH-FOR-HEIGHT:CAPS"><literal>GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT</literal></link> mode.
<link linkend="GTK-SIZE-REQUEST-HEIGHT-FOR-WIDTH:CAPS"><literal>GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH</literal></link> means the widget prefers to have
<link linkend="GtkWidgetClass.measure"><function>GtkWidgetClass.measure()</function></link> called first to get the default width (passing
a for_size of -1), then again to get the height for said default width.
<link linkend="GTK-SIZE-REQUEST-CONSTANT-SIZE:CAPS"><literal>GTK_SIZE_REQUEST_CONSTANT_SIZE</literal></link> disables any height-for-width or
width-for-height geometry management for said widget and is the
default return.
It’s important to note that any widget
which trades height-for-width or width-for-height must respond properly
to a for_size value &gt;= -1 passed to <link linkend="GtkWidgetClass.measure"><type>GtkWidgetClass.measure</type></link>, for both
possible orientations.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.measure">measure</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>This is called by containers to obtain the minimum and natural
size of the widget. Depending on the orientation parameter, the passed
for_size can be interpreted as width or height. A widget will never be
allocated less than its minimum size.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.mnemonic-activate">mnemonic_activate</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Activates the <parameter>widget</parameter>
if <parameter>group_cycling</parameter>
is
<link linkend="FALSE:CAPS"><literal>FALSE</literal></link>, and just grabs the focus if <parameter>group_cycling</parameter>
is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.grab-focus">grab_focus</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Causes <parameter>widget</parameter>
to have the keyboard focus for the
<link linkend="GtkWindow"><type>GtkWindow</type></link> it’s inside.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.focus">focus</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Vfunc for <link linkend="gtk-widget-child-focus"><function>gtk_widget_child_focus()</function></link></para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.set-focus-child">set_focus_child</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Sets the focused child of a widget. Must chain up</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.move-focus">move_focus</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Signal emitted when a change of focus is requested</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.keynav-failed">keynav_failed</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Signal emitted if keyboard navigation fails.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.get-accessible">get_accessible</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Returns the accessible object that describes the
widget to an assistive technology.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.query-tooltip">query_tooltip</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Signal emitted when “has-tooltip” is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> and the
hover timeout has expired with the cursor hovering “above”
widget; or emitted when widget got focus in keyboard mode.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.compute-expand">compute_expand</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Computes whether a container should give this
widget extra space when possible.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.css-changed">css_changed</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Vfunc called when the CSS used by widget was changed. Widgets
should then discard their caches that depend on CSS and queue resizes or
redraws accordingly. The default implementation will take care of this for
all the default CSS properties, so implementations must chain up.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.system-setting-changed">system_setting_changed</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Emitted when a system setting was changed. Must chain up.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.snapshot">snapshot</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Vfunc called when a new snapshot of the widget has to be taken.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><structfield id="GtkWidgetClass.contains">contains</structfield>&#160;()</para></entry>
<entry role="struct_member_description"><para>Vfunc for <link linkend="gtk-widget-contains"><function>gtk_widget_contains()</function></link>.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="GtkRequisition" role="struct">
<title>GtkRequisition</title>
<indexterm zone="GtkRequisition"><primary>GtkRequisition</primary></indexterm>
<programlisting language="C">typedef struct {
  gint width;
  gint height;
} GtkRequisition;
</programlisting>
<para>A <link linkend="GtkRequisition-struct"><type>GtkRequisition</type></link> represents the desired size of a widget. See
<link linkend="geometry-management">GtkWidget’s geometry management section</link> for
more information.</para>
<refsect3 id="GtkRequisition.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="gint"><type>gint</type></link>&#160;<structfield id="GtkRequisition.width">width</structfield>;</para></entry>
<entry role="struct_member_description"><para>the widget’s desired width</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gint"><type>gint</type></link>&#160;<structfield id="GtkRequisition.height">height</structfield>;</para></entry>
<entry role="struct_member_description"><para>the widget’s desired height</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="GtkAllocation" role="typedef">
<title>GtkAllocation</title>
<indexterm zone="GtkAllocation"><primary>GtkAllocation</primary></indexterm>
<programlisting language="C">typedef         GdkRectangle       GtkAllocation;
</programlisting>
<para>A <link linkend="GtkAllocation-struct"><type>GtkAllocation</type></link> of a widget represents region
which has been allocated to the widget by its parent. It is a subregion
of its parents allocation. See
<link linkend="geometry-management">GtkWidget’s geometry management section</link> for
more information.</para>
</refsect2>
<refsect2 id="GtkTextDirection" role="enum">
<title>enum GtkTextDirection</title>
<indexterm zone="GtkTextDirection"><primary>GtkTextDirection</primary></indexterm>
<para>Reading directions for text.</para>
<refsect3 id="GtkTextDirection.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="GTK-TEXT-DIR-NONE:CAPS">GTK_TEXT_DIR_NONE</para></entry>
<entry role="enum_member_description"><para>No direction.</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-TEXT-DIR-LTR:CAPS">GTK_TEXT_DIR_LTR</para></entry>
<entry role="enum_member_description"><para>Left to right text direction.</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-TEXT-DIR-RTL:CAPS">GTK_TEXT_DIR_RTL</para></entry>
<entry role="enum_member_description"><para>Right to left text direction.</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="GtkPickFlags" role="enum">
<title>enum GtkPickFlags</title>
<indexterm zone="GtkPickFlags"><primary>GtkPickFlags</primary></indexterm>
<para>Flags that influence the behavior of <link linkend="gtk-widget-pick"><function>gtk_widget_pick()</function></link></para>
<refsect3 id="GtkPickFlags.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="GTK-PICK-DEFAULT:CAPS">GTK_PICK_DEFAULT</para></entry>
<entry role="enum_member_description"><para>The default behavior, include widgets that are receiving events</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-PICK-INSENSITIVE:CAPS">GTK_PICK_INSENSITIVE</para></entry>
<entry role="enum_member_description"><para>Include widgets that are insensitive</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-PICK-NON-TARGETABLE:CAPS">GTK_PICK_NON_TARGETABLE</para></entry>
<entry role="enum_member_description"><para>Include widgets that are marked as non-targetable. See <link linkend="GtkWidget--can-target"><type>“can-target”</type></link> </para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="GtkOverflow" role="enum">
<title>enum GtkOverflow</title>
<indexterm zone="GtkOverflow"><primary>GtkOverflow</primary></indexterm>
<para>Defines how content overflowing a given area should be handled, such as
with <link linkend="gtk-widget-set-overflow"><function>gtk_widget_set_overflow()</function></link>. This property is modeled after the CSS overflow
property, but implements it only partially.</para>
<refsect3 id="GtkOverflow.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="GTK-OVERFLOW-VISIBLE:CAPS">GTK_OVERFLOW_VISIBLE</para></entry>
<entry role="enum_member_description"><para>No change is applied. Content is drawn at the specified
position.</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-OVERFLOW-HIDDEN:CAPS">GTK_OVERFLOW_HIDDEN</para></entry>
<entry role="enum_member_description"><para>Content is clipped to the bounds of the area. Content
outside the area is not drawn and cannot be interacted with.</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="GtkSizeRequestMode" role="enum">
<title>enum GtkSizeRequestMode</title>
<indexterm zone="GtkSizeRequestMode"><primary>GtkSizeRequestMode</primary></indexterm>
<para>Specifies a preference for height-for-width or
width-for-height geometry management.</para>
<refsect3 id="GtkSizeRequestMode.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="GTK-SIZE-REQUEST-HEIGHT-FOR-WIDTH:CAPS">GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH</para></entry>
<entry role="enum_member_description"><para>Prefer height-for-width geometry management</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-SIZE-REQUEST-WIDTH-FOR-HEIGHT:CAPS">GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT</para></entry>
<entry role="enum_member_description"><para>Prefer width-for-height geometry management</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-SIZE-REQUEST-CONSTANT-SIZE:CAPS">GTK_SIZE_REQUEST_CONSTANT_SIZE</para></entry>
<entry role="enum_member_description"><para>Don’t trade height-for-width or width-for-height</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="GtkRequestedSize" role="struct">
<title>struct GtkRequestedSize</title>
<indexterm zone="GtkRequestedSize"><primary>GtkRequestedSize</primary></indexterm>
<programlisting language="C">struct GtkRequestedSize {
  gpointer data;
  gint     minimum_size;
  gint     natural_size;
};
</programlisting>
<para>Represents a request of a screen object in a given orientation. These
are primarily used in container implementations when allocating a natural
size for children calling. See <link linkend="gtk-distribute-natural-allocation"><function>gtk_distribute_natural_allocation()</function></link>.</para>
<refsect3 id="GtkRequestedSize.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="gpointer"><type>gpointer</type></link>&#160;<structfield id="GtkRequestedSize.data">data</structfield>;</para></entry>
<entry role="struct_member_description"><para>A client pointer</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gint"><type>gint</type></link>&#160;<structfield id="GtkRequestedSize.minimum-size">minimum_size</structfield>;</para></entry>
<entry role="struct_member_description"><para>The minimum size needed for allocation in a given orientation</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gint"><type>gint</type></link>&#160;<structfield id="GtkRequestedSize.natural-size">natural_size</structfield>;</para></entry>
<entry role="struct_member_description"><para>The natural size for allocation in a given orientation</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="GtkAlign" role="enum">
<title>enum GtkAlign</title>
<indexterm zone="GtkAlign"><primary>GtkAlign</primary></indexterm>
<para>Controls how a widget deals with extra space in a single (x or y)
dimension.</para>
<para>Alignment only matters if the widget receives a “too large” allocation,
for example if you packed the widget with the <link linkend="GtkWidget--expand"><type>“expand”</type></link>
flag inside a <link linkend="GtkBox"><type>GtkBox</type></link>, then the widget might get extra space.  If
you have for example a 16x16 icon inside a 32x32 space, the icon
could be scaled and stretched, it could be centered, or it could be
positioned to one side of the space.</para>
<para>Note that in horizontal context <parameter>GTK_ALIGN_START</parameter>
 and <parameter>GTK_ALIGN_END</parameter>

are interpreted relative to text direction.</para>
<para><parameter>GTK_ALIGN_BASELINE</parameter>
 support is optional for containers and widgets, and
it is only supported for vertical alignment.  When it's not supported by
a child or a container it is treated as <parameter>GTK_ALIGN_FILL</parameter>
.</para>
<refsect3 id="GtkAlign.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="GTK-ALIGN-FILL:CAPS">GTK_ALIGN_FILL</para></entry>
<entry role="enum_member_description"><para>stretch to fill all space if possible, center if
no meaningful way to stretch</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-ALIGN-START:CAPS">GTK_ALIGN_START</para></entry>
<entry role="enum_member_description"><para>snap to left or top side, leaving space on right
or bottom</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-ALIGN-END:CAPS">GTK_ALIGN_END</para></entry>
<entry role="enum_member_description"><para>snap to right or bottom side, leaving space on left
or top</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-ALIGN-CENTER:CAPS">GTK_ALIGN_CENTER</para></entry>
<entry role="enum_member_description"><para>center natural width of widget inside the
allocation</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-ALIGN-BASELINE:CAPS">GTK_ALIGN_BASELINE</para></entry>
<entry role="enum_member_description"><para>align the widget according to the baseline. See
<link linkend="GtkWidget"><type>GtkWidget</type></link></para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkWidget.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkWidget--can-focus" role="property"><title>The <literal>“can-focus”</literal> property</title>
<indexterm zone="GtkWidget--can-focus"><primary>GtkWidget:can-focus</primary></indexterm>
<programlisting>  “can-focus”                <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the widget or any of its descendents can accept
the input focus.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkWidget--can-target" role="property"><title>The <literal>“can-target”</literal> property</title>
<indexterm zone="GtkWidget--can-target"><primary>GtkWidget:can-target</primary></indexterm>
<programlisting>  “can-target”               <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the widget can receive pointer events.</para><para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkWidget--css-classes" role="property"><title>The <literal>“css-classes”</literal> property</title>
<indexterm zone="GtkWidget--css-classes"><primary>GtkWidget:css-classes</primary></indexterm>
<programlisting>  “css-classes”              <link linkend="GStrv"><type>GStrv</type></link></programlisting>
<para>A list of css classes applied to this widget.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkWidget--css-name" role="property"><title>The <literal>“css-name”</literal> property</title>
<indexterm zone="GtkWidget--css-name"><primary>GtkWidget:css-name</primary></indexterm>
<programlisting>  “css-name”                 <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The name of this widget in the CSS tree.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write / Construct&#160;Only</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkWidget--cursor" role="property"><title>The <literal>“cursor”</literal> property</title>
<indexterm zone="GtkWidget--cursor"><primary>GtkWidget:cursor</primary></indexterm>
<programlisting>  “cursor”                   <link linkend="GdkCursor"><type>GdkCursor</type></link>&#160;*</programlisting>
<para>The cursor used by <parameter>widget</parameter>
. See <link linkend="gtk-widget-set-cursor"><function>gtk_widget_set_cursor()</function></link> for details.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkWidget--focus-on-click" role="property"><title>The <literal>“focus-on-click”</literal> property</title>
<indexterm zone="GtkWidget--focus-on-click"><primary>GtkWidget:focus-on-click</primary></indexterm>
<programlisting>  “focus-on-click”           <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the widget should grab focus when it is clicked with the mouse.</para>
<para>This property is only relevant for widgets that can take focus.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkWidget--focusable" role="property"><title>The <literal>“focusable”</literal> property</title>
<indexterm zone="GtkWidget--focusable"><primary>GtkWidget:focusable</primary></indexterm>
<programlisting>  “focusable”                <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether this widget itself will accept the input focus.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkWidget--halign" role="property"><title>The <literal>“halign”</literal> property</title>
<indexterm zone="GtkWidget--halign"><primary>GtkWidget:halign</primary></indexterm>
<programlisting>  “halign”                   <link linkend="GtkAlign"><type>GtkAlign</type></link></programlisting>
<para>How to distribute horizontal space if widget gets extra space, see <link linkend="GtkAlign"><type>GtkAlign</type></link></para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: GTK_ALIGN_FILL</para>
</refsect2>
<refsect2 id="GtkWidget--has-default" role="property"><title>The <literal>“has-default”</literal> property</title>
<indexterm zone="GtkWidget--has-default"><primary>GtkWidget:has-default</primary></indexterm>
<programlisting>  “has-default”              <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the widget is the default widget.</para><para>Owner: GtkWidget</para>
<para>Flags: Read</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkWidget--has-focus" role="property"><title>The <literal>“has-focus”</literal> property</title>
<indexterm zone="GtkWidget--has-focus"><primary>GtkWidget:has-focus</primary></indexterm>
<programlisting>  “has-focus”                <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the widget has the input focus.</para><para>Owner: GtkWidget</para>
<para>Flags: Read</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkWidget--has-tooltip" role="property"><title>The <literal>“has-tooltip”</literal> property</title>
<indexterm zone="GtkWidget--has-tooltip"><primary>GtkWidget:has-tooltip</primary></indexterm>
<programlisting>  “has-tooltip”              <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Enables or disables the emission of <link linkend="GtkWidget-query-tooltip"><type>“query-tooltip”</type></link> on <parameter>widget</parameter>
.
A value of <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> indicates that <parameter>widget</parameter>
 can have a tooltip, in this case
the widget will be queried using <link linkend="GtkWidget-query-tooltip"><type>“query-tooltip”</type></link> to determine
whether it will provide a tooltip or not.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkWidget--height-request" role="property"><title>The <literal>“height-request”</literal> property</title>
<indexterm zone="GtkWidget--height-request"><primary>GtkWidget:height-request</primary></indexterm>
<programlisting>  “height-request”           <link linkend="gint"><type>gint</type></link></programlisting>
<para>Override for height request of the widget, or -1 if natural request should be used.</para><para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= -1</para>
<para>Default value: -1</para>
</refsect2>
<refsect2 id="GtkWidget--hexpand" role="property"><title>The <literal>“hexpand”</literal> property</title>
<indexterm zone="GtkWidget--hexpand"><primary>GtkWidget:hexpand</primary></indexterm>
<programlisting>  “hexpand”                  <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether to expand horizontally. See <link linkend="gtk-widget-set-hexpand"><function>gtk_widget_set_hexpand()</function></link>.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkWidget--hexpand-set" role="property"><title>The <literal>“hexpand-set”</literal> property</title>
<indexterm zone="GtkWidget--hexpand-set"><primary>GtkWidget:hexpand-set</primary></indexterm>
<programlisting>  “hexpand-set”              <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether to use the <link linkend="GtkWidget--hexpand"><type>“hexpand”</type></link> property. See <link linkend="gtk-widget-get-hexpand-set"><function>gtk_widget_get_hexpand_set()</function></link>.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkWidget--layout-manager" role="property"><title>The <literal>“layout-manager”</literal> property</title>
<indexterm zone="GtkWidget--layout-manager"><primary>GtkWidget:layout-manager</primary></indexterm>
<programlisting>  “layout-manager”           <link linkend="GtkLayoutManager"><type>GtkLayoutManager</type></link>&#160;*</programlisting>
<para>The <link linkend="GtkLayoutManager"><type>GtkLayoutManager</type></link> instance to use to compute the preferred size
of the widget, and allocate its children.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkWidget--margin-bottom" role="property"><title>The <literal>“margin-bottom”</literal> property</title>
<indexterm zone="GtkWidget--margin-bottom"><primary>GtkWidget:margin-bottom</primary></indexterm>
<programlisting>  “margin-bottom”            <link linkend="gint"><type>gint</type></link></programlisting>
<para>Margin on bottom side of widget.</para>
<para>This property adds margin outside of the widget's normal size
request, the margin will be added in addition to the size from
<link linkend="gtk-widget-set-size-request"><function>gtk_widget_set_size_request()</function></link> for example.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Allowed values: [0,32767]</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkWidget--margin-end" role="property"><title>The <literal>“margin-end”</literal> property</title>
<indexterm zone="GtkWidget--margin-end"><primary>GtkWidget:margin-end</primary></indexterm>
<programlisting>  “margin-end”               <link linkend="gint"><type>gint</type></link></programlisting>
<para>Margin on end of widget, horizontally. This property supports
left-to-right and right-to-left text directions.</para>
<para>This property adds margin outside of the widget's normal size
request, the margin will be added in addition to the size from
<link linkend="gtk-widget-set-size-request"><function>gtk_widget_set_size_request()</function></link> for example.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Allowed values: [0,32767]</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkWidget--margin-start" role="property"><title>The <literal>“margin-start”</literal> property</title>
<indexterm zone="GtkWidget--margin-start"><primary>GtkWidget:margin-start</primary></indexterm>
<programlisting>  “margin-start”             <link linkend="gint"><type>gint</type></link></programlisting>
<para>Margin on start of widget, horizontally. This property supports
left-to-right and right-to-left text directions.</para>
<para>This property adds margin outside of the widget's normal size
request, the margin will be added in addition to the size from
<link linkend="gtk-widget-set-size-request"><function>gtk_widget_set_size_request()</function></link> for example.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Allowed values: [0,32767]</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkWidget--margin-top" role="property"><title>The <literal>“margin-top”</literal> property</title>
<indexterm zone="GtkWidget--margin-top"><primary>GtkWidget:margin-top</primary></indexterm>
<programlisting>  “margin-top”               <link linkend="gint"><type>gint</type></link></programlisting>
<para>Margin on top side of widget.</para>
<para>This property adds margin outside of the widget's normal size
request, the margin will be added in addition to the size from
<link linkend="gtk-widget-set-size-request"><function>gtk_widget_set_size_request()</function></link> for example.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Allowed values: [0,32767]</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkWidget--name" role="property"><title>The <literal>“name”</literal> property</title>
<indexterm zone="GtkWidget--name"><primary>GtkWidget:name</primary></indexterm>
<programlisting>  “name”                     <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The name of the widget.</para><para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkWidget--opacity" role="property"><title>The <literal>“opacity”</literal> property</title>
<indexterm zone="GtkWidget--opacity"><primary>GtkWidget:opacity</primary></indexterm>
<programlisting>  “opacity”                  <link linkend="gdouble"><type>gdouble</type></link></programlisting>
<para>The requested opacity of the widget. See <link linkend="gtk-widget-set-opacity"><function>gtk_widget_set_opacity()</function></link> for
more details about window opacity.</para>
<para>Before 3.8 this was only available in GtkWindow</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Allowed values: [0,1]</para>
<para>Default value: 1</para>
</refsect2>
<refsect2 id="GtkWidget--overflow" role="property"><title>The <literal>“overflow”</literal> property</title>
<indexterm zone="GtkWidget--overflow"><primary>GtkWidget:overflow</primary></indexterm>
<programlisting>  “overflow”                 <link linkend="GtkOverflow"><type>GtkOverflow</type></link></programlisting>
<para>How content outside the widget's content area is treated.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: GTK_OVERFLOW_VISIBLE</para>
</refsect2>
<refsect2 id="GtkWidget--parent" role="property"><title>The <literal>“parent”</literal> property</title>
<indexterm zone="GtkWidget--parent"><primary>GtkWidget:parent</primary></indexterm>
<programlisting>  “parent”                   <link linkend="GtkWidget"><type>GtkWidget</type></link>&#160;*</programlisting>
<para>The parent widget of this widget.</para><para>Owner: GtkWidget</para>
<para>Flags: Read</para>
</refsect2>
<refsect2 id="GtkWidget--receives-default" role="property"><title>The <literal>“receives-default”</literal> property</title>
<indexterm zone="GtkWidget--receives-default"><primary>GtkWidget:receives-default</primary></indexterm>
<programlisting>  “receives-default”         <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>If TRUE, the widget will receive the default action when it is focused.</para><para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkWidget--root" role="property"><title>The <literal>“root”</literal> property</title>
<indexterm zone="GtkWidget--root"><primary>GtkWidget:root</primary></indexterm>
<programlisting>  “root”                     <link linkend="GtkRoot"><type>GtkRoot</type></link>&#160;*</programlisting>
<para>The <link linkend="GtkRoot"><type>GtkRoot</type></link> widget of the widget tree containing this widget or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if
the widget is not contained in a root widget.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read</para>
</refsect2>
<refsect2 id="GtkWidget--scale-factor" role="property"><title>The <literal>“scale-factor”</literal> property</title>
<indexterm zone="GtkWidget--scale-factor"><primary>GtkWidget:scale-factor</primary></indexterm>
<programlisting>  “scale-factor”             <link linkend="gint"><type>gint</type></link></programlisting>
<para>The scale factor of the widget. See <link linkend="gtk-widget-get-scale-factor"><function>gtk_widget_get_scale_factor()</function></link> for
more details about widget scaling.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read</para>
<para>Allowed values: &gt;= 1</para>
<para>Default value: 1</para>
</refsect2>
<refsect2 id="GtkWidget--sensitive" role="property"><title>The <literal>“sensitive”</literal> property</title>
<indexterm zone="GtkWidget--sensitive"><primary>GtkWidget:sensitive</primary></indexterm>
<programlisting>  “sensitive”                <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the widget responds to input.</para><para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkWidget--tooltip-markup" role="property"><title>The <literal>“tooltip-markup”</literal> property</title>
<indexterm zone="GtkWidget--tooltip-markup"><primary>GtkWidget:tooltip-markup</primary></indexterm>
<programlisting>  “tooltip-markup”           <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Sets the text of tooltip to be the given string, which is marked up
with the <link linkend="PangoMarkupFormat">Pango text markup language</link>.
Also see <link linkend="gtk-tooltip-set-markup"><function>gtk_tooltip_set_markup()</function></link>.</para>
<para>This is a convenience property which will take care of getting the
tooltip shown if the given string is not <link linkend="NULL:CAPS"><literal>NULL</literal></link>: <link linkend="GtkWidget--has-tooltip"><type>“has-tooltip”</type></link>
will automatically be set to <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> and there will be taken care of
<link linkend="GtkWidget-query-tooltip"><type>“query-tooltip”</type></link> in the default signal handler.</para>
<para>Note that if both <link linkend="GtkWidget--tooltip-text"><type>“tooltip-text”</type></link> and <link linkend="GtkWidget--tooltip-markup"><type>“tooltip-markup”</type></link>
are set, the last one wins.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkWidget--tooltip-text" role="property"><title>The <literal>“tooltip-text”</literal> property</title>
<indexterm zone="GtkWidget--tooltip-text"><primary>GtkWidget:tooltip-text</primary></indexterm>
<programlisting>  “tooltip-text”             <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Sets the text of tooltip to be the given string.</para>
<para>Also see <link linkend="gtk-tooltip-set-text"><function>gtk_tooltip_set_text()</function></link>.</para>
<para>This is a convenience property which will take care of getting the
tooltip shown if the given string is not <link linkend="NULL:CAPS"><literal>NULL</literal></link>: <link linkend="GtkWidget--has-tooltip"><type>“has-tooltip”</type></link>
will automatically be set to <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> and there will be taken care of
<link linkend="GtkWidget-query-tooltip"><type>“query-tooltip”</type></link> in the default signal handler.</para>
<para>Note that if both <link linkend="GtkWidget--tooltip-text"><type>“tooltip-text”</type></link> and <link linkend="GtkWidget--tooltip-markup"><type>“tooltip-markup”</type></link>
are set, the last one wins.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkWidget--valign" role="property"><title>The <literal>“valign”</literal> property</title>
<indexterm zone="GtkWidget--valign"><primary>GtkWidget:valign</primary></indexterm>
<programlisting>  “valign”                   <link linkend="GtkAlign"><type>GtkAlign</type></link></programlisting>
<para>How to distribute vertical space if widget gets extra space, see <link linkend="GtkAlign"><type>GtkAlign</type></link></para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: GTK_ALIGN_FILL</para>
</refsect2>
<refsect2 id="GtkWidget--vexpand" role="property"><title>The <literal>“vexpand”</literal> property</title>
<indexterm zone="GtkWidget--vexpand"><primary>GtkWidget:vexpand</primary></indexterm>
<programlisting>  “vexpand”                  <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether to expand vertically. See <link linkend="gtk-widget-set-vexpand"><function>gtk_widget_set_vexpand()</function></link>.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkWidget--vexpand-set" role="property"><title>The <literal>“vexpand-set”</literal> property</title>
<indexterm zone="GtkWidget--vexpand-set"><primary>GtkWidget:vexpand-set</primary></indexterm>
<programlisting>  “vexpand-set”              <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether to use the <link linkend="GtkWidget--vexpand"><type>“vexpand”</type></link> property. See <link linkend="gtk-widget-get-vexpand-set"><function>gtk_widget_get_vexpand_set()</function></link>.</para>
<para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkWidget--visible" role="property"><title>The <literal>“visible”</literal> property</title>
<indexterm zone="GtkWidget--visible"><primary>GtkWidget:visible</primary></indexterm>
<programlisting>  “visible”                  <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the widget is visible.</para><para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkWidget--width-request" role="property"><title>The <literal>“width-request”</literal> property</title>
<indexterm zone="GtkWidget--width-request"><primary>GtkWidget:width-request</primary></indexterm>
<programlisting>  “width-request”            <link linkend="gint"><type>gint</type></link></programlisting>
<para>Override for width request of the widget, or -1 if natural request should be used.</para><para>Owner: GtkWidget</para>
<para>Flags: Read / Write</para>
<para>Allowed values: &gt;= -1</para>
<para>Default value: -1</para>
</refsect2>

</refsect1>
<refsect1 id="GtkWidget.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkWidget-destroy" role="signal"><title>The <literal>“destroy”</literal> signal</title>
<indexterm zone="GtkWidget-destroy"><primary>GtkWidget::destroy</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkWidget"><type>GtkWidget</type></link> *object,
               <link linkend="gpointer"><type>gpointer</type></link>   user_data)</programlisting>
<para>Signals that all holders of a reference to the widget should release
the reference that they hold. May result in finalization of the widget
if all references are released.</para>
<para>This signal is not suitable for saving widget state.</para>
<refsect3 id="GtkWidget-destroy.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>object</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-NO-HOOKS:CAPS">No Hooks</link></para>
</refsect2><refsect2 id="GtkWidget-direction-changed" role="signal"><title>The <literal>“direction-changed”</literal> signal</title>
<indexterm zone="GtkWidget-direction-changed"><primary>GtkWidget::direction-changed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkWidget"><type>GtkWidget</type></link>       *widget,
               <link linkend="GtkTextDirection"><type>GtkTextDirection</type></link> previous_direction,
               <link linkend="gpointer"><type>gpointer</type></link>         user_data)</programlisting>
<para>The ::direction-changed signal is emitted when the text direction
of a widget changes.</para>
<refsect3 id="GtkWidget-direction-changed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object on which the signal is emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>previous_direction</para></entry>
<entry role="parameter_description"><para>the previous text direction of <parameter>widget</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></para>
</refsect2><refsect2 id="GtkWidget-grab-notify" role="signal"><title>The <literal>“grab-notify”</literal> signal</title>
<indexterm zone="GtkWidget-grab-notify"><primary>GtkWidget::grab-notify</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkWidget"><type>GtkWidget</type></link> *widget,
               <link linkend="gboolean"><type>gboolean</type></link>   was_grabbed,
               <link linkend="gpointer"><type>gpointer</type></link>   user_data)</programlisting>
<para>The ::grab-notify signal is emitted when a widget becomes
shadowed by a GTK+ grab (not a pointer or keyboard grab) on
another widget, or when it becomes unshadowed due to a grab
being removed.</para>
<para>A widget is shadowed by a <link linkend="gtk-grab-add"><function>gtk_grab_add()</function></link> when the topmost
grab widget in the grab stack of its window group is not
its ancestor.</para>
<refsect3 id="GtkWidget-grab-notify.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>was_grabbed</para></entry>
<entry role="parameter_description"><para><link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if the widget becomes shadowed, <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>
if it becomes unshadowed</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></para>
</refsect2><refsect2 id="GtkWidget-hide" role="signal"><title>The <literal>“hide”</literal> signal</title>
<indexterm zone="GtkWidget-hide"><primary>GtkWidget::hide</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkWidget"><type>GtkWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>   user_data)</programlisting>
<para>The ::hide signal is emitted when <parameter>widget</parameter>
 is hidden, for example with
<link linkend="gtk-widget-hide"><function>gtk_widget_hide()</function></link>.</para>
<refsect3 id="GtkWidget-hide.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></para>
</refsect2><refsect2 id="GtkWidget-keynav-failed" role="signal"><title>The <literal>“keynav-failed”</literal> signal</title>
<indexterm zone="GtkWidget-keynav-failed"><primary>GtkWidget::keynav-failed</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
user_function (<link linkend="GtkWidget"><type>GtkWidget</type></link>       *widget,
               <link linkend="GtkDirectionType"><type>GtkDirectionType</type></link> direction,
               <link linkend="gpointer"><type>gpointer</type></link>         user_data)</programlisting>
<para>Gets emitted if keyboard navigation fails.
See <link linkend="gtk-widget-keynav-failed"><function>gtk_widget_keynav_failed()</function></link> for details.</para>
<refsect3 id="GtkWidget-keynav-failed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>direction</para></entry>
<entry role="parameter_description"><para>the direction of movement</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="GtkWidget-keynav-failed.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if stopping keyboard navigation is fine, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>
if the emitting widget should try to handle the keyboard
navigation attempt in its parent widget(s).</para>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2><refsect2 id="GtkWidget-map" role="signal"><title>The <literal>“map”</literal> signal</title>
<indexterm zone="GtkWidget-map"><primary>GtkWidget::map</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkWidget"><type>GtkWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>   user_data)</programlisting>
<para>The ::map signal is emitted when <parameter>widget</parameter>
 is going to be mapped, that is
when the widget is visible (which is controlled with
<link linkend="gtk-widget-set-visible"><function>gtk_widget_set_visible()</function></link>) and all its parents up to the toplevel widget
are also visible.</para>
<para>The ::map signal can be used to determine whether a widget will be drawn,
for instance it can resume an animation that was stopped during the
emission of <link linkend="GtkWidget-unmap"><type>“unmap”</type></link>.</para>
<refsect3 id="GtkWidget-map.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></para>
</refsect2><refsect2 id="GtkWidget-mnemonic-activate" role="signal"><title>The <literal>“mnemonic-activate”</literal> signal</title>
<indexterm zone="GtkWidget-mnemonic-activate"><primary>GtkWidget::mnemonic-activate</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
user_function (<link linkend="GtkWidget"><type>GtkWidget</type></link> *widget,
               <link linkend="gboolean"><type>gboolean</type></link>   group_cycling,
               <link linkend="gpointer"><type>gpointer</type></link>   user_data)</programlisting>
<para>The default handler for this signal activates <parameter>widget</parameter>
 if <parameter>group_cycling</parameter>

is <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>, or just makes <parameter>widget</parameter>
 grab focus if <parameter>group_cycling</parameter>
 is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>.</para>
<refsect3 id="GtkWidget-mnemonic-activate.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>group_cycling</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if there are other widgets with the same mnemonic</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="GtkWidget-mnemonic-activate.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> to stop other handlers from being invoked for the event.
<link linkend="FALSE:CAPS"><literal>FALSE</literal></link> to propagate the event further.</para>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2><refsect2 id="GtkWidget-move-focus" role="signal"><title>The <literal>“move-focus”</literal> signal</title>
<indexterm zone="GtkWidget-move-focus"><primary>GtkWidget::move-focus</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkWidget"><type>GtkWidget</type></link>       *widget,
               <link linkend="GtkDirectionType"><type>GtkDirectionType</type></link> direction,
               <link linkend="gpointer"><type>gpointer</type></link>         user_data)</programlisting>
<refsect3 id="GtkWidget-move-focus.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkWidget-query-tooltip" role="signal"><title>The <literal>“query-tooltip”</literal> signal</title>
<indexterm zone="GtkWidget-query-tooltip"><primary>GtkWidget::query-tooltip</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
user_function (<link linkend="GtkWidget"><type>GtkWidget</type></link>  *widget,
               <link linkend="gint"><type>gint</type></link>        x,
               <link linkend="gint"><type>gint</type></link>        y,
               <link linkend="gboolean"><type>gboolean</type></link>    keyboard_mode,
               <link linkend="GtkTooltip"><type>GtkTooltip</type></link> *tooltip,
               <link linkend="gpointer"><type>gpointer</type></link>    user_data)</programlisting>
<para>Emitted when <link linkend="GtkWidget--has-tooltip"><type>“has-tooltip”</type></link> is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> and the hover timeout
has expired with the cursor hovering "above" <parameter>widget</parameter>
; or emitted when <parameter>widget</parameter>
 got
focus in keyboard mode.</para>
<para>Using the given coordinates, the signal handler should determine
whether a tooltip should be shown for <parameter>widget</parameter>
. If this is the case
<link linkend="TRUE:CAPS"><literal>TRUE</literal></link> should be returned, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.  Note that if
<parameter>keyboard_mode</parameter>
 is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, the values of <parameter>x</parameter>
 and <parameter>y</parameter>
 are undefined and
should not be used.</para>
<para>The signal handler is free to manipulate <parameter>tooltip</parameter>
 with the therefore
destined function calls.</para>
<refsect3 id="GtkWidget-query-tooltip.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>x</para></entry>
<entry role="parameter_description"><para>the x coordinate of the cursor position where the request has
been emitted, relative to <parameter>widget</parameter>
's left side</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>y</para></entry>
<entry role="parameter_description"><para>the y coordinate of the cursor position where the request has
been emitted, relative to <parameter>widget</parameter>
's top</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>keyboard_mode</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the tooltip was triggered using the keyboard</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>tooltip</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkTooltip"><type>GtkTooltip</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="GtkWidget-query-tooltip.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>tooltip</parameter>
should be shown right now, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.</para>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2><refsect2 id="GtkWidget-realize" role="signal"><title>The <literal>“realize”</literal> signal</title>
<indexterm zone="GtkWidget-realize"><primary>GtkWidget::realize</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkWidget"><type>GtkWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>   user_data)</programlisting>
<para>The ::realize signal is emitted when <parameter>widget</parameter>
 is associated with a
<link linkend="GdkSurface"><type>GdkSurface</type></link>, which means that <link linkend="gtk-widget-realize"><function>gtk_widget_realize()</function></link> has been called or the
widget has been mapped (that is, it is going to be drawn).</para>
<refsect3 id="GtkWidget-realize.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></para>
</refsect2><refsect2 id="GtkWidget-show" role="signal"><title>The <literal>“show”</literal> signal</title>
<indexterm zone="GtkWidget-show"><primary>GtkWidget::show</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkWidget"><type>GtkWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>   user_data)</programlisting>
<para>The ::show signal is emitted when <parameter>widget</parameter>
 is shown, for example with
<link linkend="gtk-widget-show"><function>gtk_widget_show()</function></link>.</para>
<refsect3 id="GtkWidget-show.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></para>
</refsect2><refsect2 id="GtkWidget-state-flags-changed" role="signal"><title>The <literal>“state-flags-changed”</literal> signal</title>
<indexterm zone="GtkWidget-state-flags-changed"><primary>GtkWidget::state-flags-changed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkWidget"><type>GtkWidget</type></link>    *widget,
               <link linkend="GtkStateFlags"><type>GtkStateFlags</type></link> flags,
               <link linkend="gpointer"><type>gpointer</type></link>      user_data)</programlisting>
<para>The ::state-flags-changed signal is emitted when the widget state
changes, see <link linkend="gtk-widget-get-state-flags"><function>gtk_widget_get_state_flags()</function></link>.</para>
<refsect3 id="GtkWidget-state-flags-changed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>The previous state flags.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></para>
</refsect2><refsect2 id="GtkWidget-unmap" role="signal"><title>The <literal>“unmap”</literal> signal</title>
<indexterm zone="GtkWidget-unmap"><primary>GtkWidget::unmap</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkWidget"><type>GtkWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>   user_data)</programlisting>
<para>The ::unmap signal is emitted when <parameter>widget</parameter>
 is going to be unmapped, which
means that either it or any of its parents up to the toplevel widget have
been set as hidden.</para>
<para>As ::unmap indicates that a widget will not be shown any longer, it can be
used to, for example, stop an animation on the widget.</para>
<refsect3 id="GtkWidget-unmap.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></para>
</refsect2><refsect2 id="GtkWidget-unrealize" role="signal"><title>The <literal>“unrealize”</literal> signal</title>
<indexterm zone="GtkWidget-unrealize"><primary>GtkWidget::unrealize</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkWidget"><type>GtkWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>   user_data)</programlisting>
<para>The ::unrealize signal is emitted when the <link linkend="GdkSurface"><type>GdkSurface</type></link> associated with
<parameter>widget</parameter>
 is destroyed, which means that <link linkend="gtk-widget-unrealize"><function>gtk_widget_unrealize()</function></link> has been
called or the widget has been unmapped (that is, it is going to be
hidden).</para>
<refsect3 id="GtkWidget-unrealize.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2>
</refsect1>

</refentry>
