<?xml version="1.0" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id="gtk-functions">
  <refnamediv>
    <refname>gtk Functions</refname>
    <refpurpose>miscellaneous functions</refpurpose>
  </refnamediv>

  <refsect1>
    <title>Synopsis</title>

    <refsect2>
      <title><link linkend="class-gtkaboutdialog"><classname>gtk.AboutDialog</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--about-dialog-set-email-hook">gtk.about_dialog_set_email_hook</link></methodname>
	  <methodparam><parameter role="keyword">func</parameter></methodparam>
	  <methodparam><parameter role="keyword">data</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--about-dialog-set-url-hook">gtk.about_dialog_set_url_hook</link></methodname>
	  <methodparam><parameter role="keyword">func</parameter></methodparam>
	  <methodparam><parameter role="keyword">data</parameter></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkaccelgroup"><classname>gtk.AccelGroup</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accelerator-valid">gtk.accelerator_valid</link></methodname>
	  <methodparam><parameter role="keyword">keyval</parameter></methodparam>
	  <methodparam><parameter role="keyword">modifiers</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accelerator-parse">gtk.accelerator_parse</link></methodname>
	  <methodparam><parameter role="keyword">accelerator</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accelerator-name">gtk.accelerator_name</link></methodname>
	  <methodparam><parameter role="keyword">accelerator_key</parameter></methodparam>
	  <methodparam><parameter role="keyword">accelerator_mods</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accelerator-set-default-mod-mask">gtk.accelerator_set_default_mod_mask</link></methodname>
	  <methodparam><parameter role="keyword">default_mod_mask</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accelerator-get-default-mod-mask">gtk.accelerator_get_default_mod_mask</link></methodname>
	</methodsynopsis><methodsynopsis language="python">
	<methodname><link
linkend="function-gtk--accelerator-get-label">gtk.accelerator_get_label</link></methodname>
	<methodparam><parameter role="keyword">accelerator_key</parameter></methodparam>
	<methodparam><parameter role="keyword">accelerator_mods</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
	<methodname><link
linkend="function-gtk--accel-groups-from-object">gtk.accel_groups_from_object</link></methodname>
	<methodparam><parameter>object</parameter></methodparam>
      </methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkaccelmap"><classname>gtk.AccelMap</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accel-map-add-entry">gtk.accel_map_add_entry</link></methodname>
	  <methodparam><parameter role="keyword">accel_path</parameter></methodparam>
	  <methodparam><parameter role="keyword">accel_key</parameter></methodparam>
	  <methodparam><parameter role="keyword">accel_mods</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accel-map-change-entry">gtk.accel_map_lookup_entry</link></methodname>
	  <methodparam><parameter role="keyword">accel_path</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accel-map-change-entry">gtk.accel_map_change_entry</link></methodname>
	  <methodparam><parameter role="keyword">accel_path</parameter></methodparam>
	  <methodparam><parameter role="keyword">accel_key</parameter></methodparam>
	  <methodparam><parameter role="keyword">accel_mods</parameter></methodparam>
	  <methodparam><parameter role="keyword">replace</parameter></methodparam>  </methodsynopsis><methodsynopsis language="python">
      <methodname><link linkend="function-gtk--accel-map-foreach">gtk.accel_map_foreach</link></methodname>
      <methodparam><parameter role="keyword">foreach_func</parameter></methodparam>
      <methodparam><parameter role="keyword">data</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis><methodsynopsis language="python">
      <methodname><link linkend="function-gtk--accel-map-foreach-unfiltered">gtk.accel_map_foreach_unfiltered</link></methodname>
      <methodparam><parameter role="keyword">foreach_func</parameter></methodparam>
      <methodparam><parameter role="keyword">data</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis><methodsynopsis language="python">
      <methodname><link linkend="function-gtk--accel-map-get">gtk.accel_map_get</link></methodname>
      <methodparam></methodparam>
      </methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accel-map-load">gtk.accel_map_load</link></methodname>
	  <methodparam><parameter role="keyword">file_name</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accel-map-save">gtk.accel_map_save</link></methodname>
	  <methodparam><parameter role="keyword">file_name</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accel-map-load-fd">gtk.accel_map_load_fd</link></methodname>
	  <methodparam><parameter role="keyword">fd</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accel-map-save-fd">gtk.accel_map_save_fd</link></methodname>
	  <methodparam><parameter role="keyword">fd</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accel-map-lock-path">gtk.accel_map_lock_path</link></methodname>
	  <methodparam><parameter role="keyword">accel_path</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accel-map-unlock-path">gtk.accel_map_unlock_path</link></methodname>
	  <methodparam><parameter role="keyword">accel_path</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--accel-map-add-filter">gtk.accel_map_add_filter</link></methodname>
	  <methodparam><parameter role="keyword">filter_pattern</parameter></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkcellview"><classname>gtk.CellView</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--cell-view-new-with-text">gtk.cell_view_new_with_text</link></methodname>
    <methodparam><parameter role="keyword">text</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--cell-view-new-with-markup">gtk.cell_view_new_with_markup</link></methodname>
    <methodparam><parameter role="keyword">markup</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--cell-view-new-with-pixbuf">gtk.cell_view_new_with_pixbuf</link></methodname>
    <methodparam><parameter role="keyword">pixbuf</parameter></methodparam>
  </methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkclipboard"><classname>gtk.Clipboard</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--clipboard-get">gtk.clipboard_get</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkcolorselection"><classname>gtk.ColorSelection</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--color-selection-palette-from-string">gtk.color_selection_palette_from_string</link></methodname>
	  <methodparam><parameter role="keyword">str</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--color-selection-palette-to-string">gtk.color_selection_palette_to_string</link></methodname>
	  <methodparam><parameter role="keyword">colors</parameter></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkcombobox"><classname>gtk.ComboBox</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--combo-box-new-text">gtk.combo_box_new_text</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkcomboboxentry"><classname>gtk.ComboBoxEntry</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--combo-box-entry-new-text">gtk.combo_box_entry_new_text</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkcomboboxtext"><classname>gtk.ComboBoxText</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--combo-box-text-new-with-entry">gtk.combo_box_text_new_with_entry</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

     <refsect2>
      <title><link linkend="class-gtkcomboboxentry"><classname>gtk.Container</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
        <methodname><link linkend="function-gtk--container-class-install-child-property">gtk.container_class_install_child_property</link></methodname>
        <methodparam><parameter role="keyword">klass</parameter></methodparam>
        <methodparam><parameter role="keyword">property_id</parameter></methodparam>
        <methodparam><parameter role="keyword">pspec</parameter></methodparam>
      </methodsynopsis><methodsynopsis language="python">
        <methodname><link linkend="function-gtk--container-class-list-child-properties">gtk.container_class_list_child_properties</link></methodname>
        <methodparam><parameter role="keyword">klass</parameter></methodparam>
      </methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkdialog"><classname>gtk.Dialog</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
        <methodname><link
linkend="function-gtk--alternative-dialog-button-order">gtk.alternative_dialog_button_order</link></methodname>
        <methodparam><parameter role="keyword">screen</parameter><initializer>None</initializer></methodparam>
  </methodsynopsis></programlisting>

    </refsect2>

   <refsect2>
      <title><link linkend="class-gtkexpander"><classname>gtk.Expander</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--expander-new-with-mnemonic">gtk.expander_new_with_mnemonic</link></methodname>
	  <methodparam><parameter role="keyword">label</parameter></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkiconfactory"><classname>gtk.IconFactory</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--icon-factory-lookup-default">gtk.icon_factory_lookup_default</link></methodname>
	  <methodparam><parameter role="keyword">stock_id</parameter>
	  </methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkiconsource"><classname>gtk.IconSource</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--icon-size-lookup">gtk.icon_size_lookup</link></methodname>
	  <methodparam><parameter
			 role="keyword">icon_size</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--icon-size-lookup-for-settings">gtk.icon_size_lookup_for_settings</link></methodname>
	  <methodparam><parameter
			 role="keyword">settings</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">icon_size</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--icon-size-register">gtk.icon_size_register</link></methodname>
	  <methodparam><parameter
			 role="keyword">name</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">width</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">height</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--icon-size-register-alias">gtk.icon_size_register_alias</link></methodname>
	  <methodparam><parameter
			 role="keyword">alias</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">target</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--icon-size-from-name">gtk.icon_size_from_name</link></methodname>
	  <methodparam><parameter
			 role="keyword">name</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--icon-size-get-name">gtk.icon_size_get_name</link></methodname>
	  <methodparam><parameter
			 role="keyword">size</parameter></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkicontheme"><classname>gtk.IconTheme</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--icon-theme-get-default">gtk.icon_theme_get_default</link></methodname>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--icon-theme-get-for-screen">gtk.icon_theme_get_for_screen</link></methodname>
	  <methodparam><parameter role="keyword">screen</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--icon-theme-add-builtin-icon">gtk.icon_theme_add_builtin_icon</link></methodname>
	  <methodparam><parameter role="keyword">icon_name</parameter></methodparam>
	  <methodparam><parameter role="keyword">size</parameter></methodparam>
	  <methodparam><parameter role="keyword">pixbuf</parameter></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkimage"><classname>gtk.Image</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--image-new-from-stock">gtk.image_new_from_stock</link></methodname>
	  <methodparam><parameter role="keyword">stock_id</parameter></methodparam>
	  <methodparam><parameter role="keyword">size</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--image-new-from-icon-set">gtk.image_new_from_icon_set</link></methodname>
	  <methodparam><parameter role="keyword">icon_set</parameter></methodparam>
	  <methodparam><parameter role="keyword">size</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--image-new-from-animation">gtk.image_new_from_animation</link></methodname>
	  <methodparam><parameter role="keyword">animation</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--image-new-from-animation">gtk.image_new_from_icon_name</link></methodname>
    <methodparam><parameter role="keyword">icon_name</parameter></methodparam>
    <methodparam><parameter role="keyword">size</parameter></methodparam>
  </methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkitemfactory"><classname>gtk.ItemFactory</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--item-factory-from-widget">gtk.item_factory_from_widget</link></methodname>
	  <methodparam><parameter role="keyword">widget</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--item-factory-path-from-widget">gtk.item_factory_path_from_widget</link></methodname>
	  <methodparam><parameter role="keyword">widget</parameter></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtklinkbutton"><classname>gtk.LinkButton</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
        <methodname><link linkend="function-gtk--link-button-set-uri-hook">gtk.link_button_set_uri_hook</link></methodname>
        <methodparam><parameter role="keyword">func</parameter></methodparam>
        <methodparam><parameter role="keyword">data</parameter><initializer>None</initializer></methodparam>
    </methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkobject"><classname>gtk.Object</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--bindings-activate">gtk.bindings_activate</link></methodname>
	  <methodparam><parameter
			 role="keyword">object</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">keyval</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">modifiers</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--bindings-activate">gtk.bindings_activate_event</link></methodname>
	  <methodparam><parameter
			 role="keyword">object</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">event</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--binding-entry-add-signal">gtk.binding_entry_add_signal</link></methodname>
	  <methodparam><parameter>object</parameter></methodparam>
	  <methodparam><parameter>keyval</parameter></methodparam>
	  <methodparam><parameter>modifiers</parameter></methodparam>
	  <methodparam><parameter>signal_name</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--binding-entry-remove">gtk.binding_entry_remove</link></methodname>
	  <methodparam><parameter
                         role="keyword">class_type</parameter></methodparam>
	  <methodparam><parameter
                         role="keyword">keyval</parameter></methodparam>
	  <methodparam><parameter
                         role="keyword">modifiers</parameter></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkpapersize"><classname>gtk.PaperSize</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--paper-size-new-from-ppd">gtk.paper_size_new_from_ppd</link></methodname>
    <methodparam><parameter role="keyword">ppd_name</parameter></methodparam>
    <methodparam><parameter role="keyword">ppd_display_name</parameter></methodparam>
    <methodparam><parameter role="keyword">width</parameter></methodparam>
    <methodparam><parameter role="keyword">height</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--paper-size-new-custom">gtk.paper_size_new_cutom</link></methodname>
    <methodparam><parameter role="keyword">name</parameter></methodparam>
    <methodparam><parameter role="keyword">display_name</parameter></methodparam>
    <methodparam><parameter role="keyword">width</parameter></methodparam>
    <methodparam><parameter role="keyword">height</parameter></methodparam>
    <methodparam><parameter role="keyword">unit</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--paper-size-get-default">gtk.paper_size_get_default</link></methodname>
    <methodparam><parameter role="keyword"></parameter></methodparam>
  </methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkplug"><classname>gtk.Plug</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--plug-new-for-display">gtk.plug_new_for_display</link></methodname>
	  <methodparam><parameter role="keyword">display</parameter></methodparam>        <methodparam><parameter role="keyword">socket_id</parameter></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkrcstyle"><classname>gtk.RcStyle</classname></link> Functions</title>
      
      <programlisting><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--rc-add-default-file">gtk.rc_add_default_file</link></methodname>
	  <methodparam><parameter role="keyword">filename</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--rc-set-default-files">gtk.rc_set_default_files</link></methodname>
	  <methodparam><parameter role="keyword">filenames</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--rc-get-default-files">gtk.rc_get_default_files</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--rc-get-style-by-paths">gtk.rc_get_style_by_paths</link></methodname>
	  <methodparam><parameter role="keyword">settings</parameter></methodparam>
	  <methodparam><parameter role="keyword">widget_path</parameter></methodparam>    <methodparam><parameter role="keyword">class_path</parameter></methodparam>
	  <methodparam><parameter role="keyword">type</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--rc-reparse-all-for-settings">gtk.rc_reparse_all_for_settings</link></methodname>
	  <methodparam><parameter role="keyword">settings</parameter></methodparam>
	  <methodparam><parameter role="keyword">force_load</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--rc-reset-styles">gtk.rc_reset_styles</link></methodname>
	  <methodparam><parameter role="keyword">settings</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--rc-parse">gtk.rc_parse</link></methodname>
	  <methodparam><parameter role="keyword">filename</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--rc-parse-string">gtk.rc_parse_string</link></methodname>
	  <methodparam><parameter role="keyword">rc_string</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--rc-reparse-all">gtk.rc_reparse_all</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--rc-find-module-in-path">gtk.rc_find_module_in_path</link></methodname>
	  <methodparam><parameter role="keyword">module_file</parameter></methodparam>  </methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--rc-get-theme-dir">gtk.rc_get_theme_dir</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--rc-get-module-dir">gtk.rc_get_module_dir</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--rc-get-im-module-path">gtk.rc_get_im_module_path</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--rc-get-im-module-file">gtk.rc_get_im_module_file</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkrecentmanager"><classname>gtk.RecentManager</classname></link> Functions</title>
    
      <programlisting><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--recent-manager-get-default">gtk.recent_manager_get_default</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--recent-manager-get-for-screen">gtk.recent_manager_get_for_screen</link></methodname>
    <methodparam><parameter role="keyword">screen</parameter></methodparam>
  </methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkselectiondata"><classname>gtk.SelectionData</classname></link> Functions</title>
    
      <programlisting><methodsynopsis language="python">
          <methodname><link linkend="function-gtk--selection-owner-set-for-display">gtk.selection_owner_set_for_display</link></methodname>
          <methodparam><parameter role="keyword">display</parameter></methodparam>
          <methodparam><parameter role="keyword">widget</parameter></methodparam>
          <methodparam><parameter role="keyword">selection</parameter></methodparam>
          <methodparam><parameter role="keyword">time</parameter><initializer>0</initializer></methodparam>
        </methodsynopsis><methodsynopsis language="python">
	<methodname><link linkend="function-gtk--target-list-add-image-targets">gtk.target_list_add_image_targets</link></methodname>
	<methodparam><parameter role="keyword">list</parameter><initializer>None</initializer></methodparam>
	<methodparam><parameter role="keyword">info</parameter><initializer>0</initializer></methodparam>
	<methodparam><parameter role="keyword">writable</parameter><initializer>False</initializer></methodparam>
      </methodsynopsis><methodsynopsis language="python">
	<methodname><link linkend="function-gtk--target-list-add-text-targets">gtk.target_list_add_text_targets</link></methodname>
	<methodparam><parameter role="keyword">list</parameter><initializer>None</initializer></methodparam>
	<methodparam><parameter role="keyword">info</parameter><initializer>0</initializer></methodparam>
      </methodsynopsis><methodsynopsis language="python">
	<methodname><link linkend="function-gtk--target-list-add-uri-targets">gtk.target_list_add_uri_targets</link></methodname>
	<methodparam><parameter role="keyword">list</parameter><initializer>None</initializer></methodparam>
	<methodparam><parameter role="keyword">info</parameter><initializer>0</initializer></methodparam>
      </methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtksettings"><classname>gtk.Settings</classname></link> Functions</title>
    
      <programlisting><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--settings-get-default">gtk.settings_get_default</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--settings-get-for-screen">gtk.settings_get_for_screen</link></methodname>
	  <methodparam><parameter
			 role="keyword">screen</parameter></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkstatusicon"><classname>gtk.StatusIcon</classname></link> Functions</title>
    
      <programlisting><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--status-icon-new-from-pixbuf">gtk.status_icon_new_from_pixbuf</link></methodname>
    <methodparam><parameter role="keyword">pixbuf</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--status-icon-new-from-file">gtk.status_icon_new_from_file</link></methodname>
    <methodparam><parameter role="keyword">filename</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--status-icon-new-from-stock">gtk.status_icon_new_from_stock</link></methodname>
    <methodparam><parameter role="keyword">stock_id</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--status-icon-new-from-icon-name">gtk.status_icon_new_from_icon_name</link></methodname>
    <methodparam><parameter role="keyword">icon_name</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--status-icon-position-menu">gtk.status_icon_position_menu</link></methodname>
    <methodparam><parameter>menu</parameter></methodparam>
    <methodparam><parameter>statusicon</parameter></methodparam>
  </methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtktooltips"><classname>gtk.Tooltips</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--tooltips-data-get">gtk.tooltips_data_get</link></methodname>
	  <methodparam><parameter
			 role="keyword">widget</parameter></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtktreemodel"><classname>gtk.TreeModel</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
          <methodname><link
linkend="function-gtk--tree-row-reference-inserted">gtk.tree_row_reference_inserted</link></methodname>
          <methodparam><parameter
                         role="keyword">proxy</parameter></methodparam>
          <methodparam><parameter
                         role="keyword">path</parameter></methodparam>
        </methodsynopsis><methodsynopsis language="python">
          <methodname><link
linkend="function-gtk--tree-row-reference-deleted">gtk.tree_row_reference_deleted</link></methodname>
          <methodparam><parameter
                         role="keyword">proxy</parameter></methodparam>
          <methodparam><parameter
                         role="keyword">path</parameter></methodparam>
        </methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--widget-push-colormap">gtk.widget_push_colormap</link></methodname>
	  <methodparam><parameter role="keyword">cmap</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--widget-push-composite-child">gtk.widget_push_composite_child</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--widget-pop-composite-child">gtk.widget_pop_composite_child</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--widget-pop-colormap">gtk.widget_pop_colormap</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--widget-get-default-style">gtk.widget_get_default_style</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--widget-set-default-colormap">gtk.widget_set_default_colormap</link></methodname>
	  <methodparam><parameter role="keyword">colormap</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--widget-get-default-colormap">gtk.widget_get_default_colormap</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--widget-get-default-visual">gtk.widget_get_default_visual</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--widget-set-default-direction">gtk.widget_set_default_direction</link></methodname>
	  <methodparam><parameter role="keyword">dir</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--widget-get-default-direction">gtk.widget_get_default_direction</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--widget-class-list-style-properties">gtk.widget_class_list_style_properties</link></methodname>
	  <methodparam><parameter role="keyword">widget</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--widget-class-install-style-property">gtk.widget_class_install_style_property</link></methodname>
    <methodparam><parameter role="keyword">widget</parameter></methodparam>
    <methodparam><parameter role="keyword">pspec</parameter></methodparam>
  </methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="class-gtkwindow"><classname>gtk.Window</classname></link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--window-set-default-icon">gtk.window_set_default_icon</link></methodname>
	  <methodparam><parameter role="keyword">icon</parameter></methodparam> </methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--window-set-default-icon-from-file">gtk.window_set_default_icon_from_file</link></methodname>
	  <methodparam><parameter role="keyword">filename</parameter></methodparam> </methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--window-set-default-icon-list">gtk.window_set_default_icon_list</link></methodname>
	  <methodparam><parameter>...</parameter></methodparam> </methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--window-get-default-icon-list">gtk.window_get_default_icon_list</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--window-set-auto-startup-notification">gtk.window_set_auto_startup_notification</link></methodname>
	  <methodparam><parameter role="keyword">setting</parameter></methodparam>      </methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--window-list-toplevels">gtk.window_list_toplevels</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	<methodname><link
linkend="function-gtk--window-set-default-icon-name">gtk.window_set_default_icon_name</link></methodname>
	<methodparam><parameter role="keyword">name</parameter></methodparam>
      </methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title><link linkend="gtk-stock-items">Stock Item</link> Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--stock-add">gtk.stock_add</link></methodname>
	  <methodparam><parameter role="keyword">items</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--stock-lookup">gtk.stock_lookup</link></methodname>
	  <methodparam><parameter>stock_id</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link linkend="function-gtk--stock-list-ids">gtk.stock_list_ids</link></methodname>
	  <methodparam><parameter role="keyword"></parameter></methodparam>
	</methodsynopsis></programlisting>

    </refsect2>

    <refsect2>
      <title>Miscellaneous Functions</title>

      <programlisting><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--check-version">gtk.check_version</link></methodname>
	  <methodparam><parameter
			 role="keyword">required_major</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">required_minor</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">required_micro</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--draw-insertion-cursor">gtk.draw_insertion_cursor</link></methodname>
	  <methodparam><parameter
			 role="keyword">widget</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">drawable</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">area</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">location</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">is_primary</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">direction</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">draw_arrow</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--get-default-language">gtk.get_default_language</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--events-pending">gtk.events_pending</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--main-do-event">gtk.main_do_event</link></methodname>
	  <methodparam><parameter
			 role="keyword">event</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--main">gtk.main</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--main-level">gtk.main_level</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--main-quit">gtk.main_quit</link></methodname>
	  <methodparam></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--main-iteration">gtk.main_iteration</link></methodname>
	  <methodparam><parameter
			 role="keyword">block</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--main-iteration-do">gtk.main_iteration_do</link></methodname>
	  <methodparam><parameter
			 role="keyword">block</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--grab-get-current">gtk.grab_get_current</link></methodname>
	  <methodparam><parameter role="keyword"></parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--quit-add">gtk.quit_add</link></methodname>
	  <methodparam><parameter>level</parameter></methodparam>
	  <methodparam><parameter>func</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--quit-remove">gtk.quit_remove</link></methodname>
	  <methodparam><parameter
			 role="keyword">quit_handler_id</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--get-current-event">gtk.get_current_event</link></methodname>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--get-current-event-state">gtk.get_current_event_state</link></methodname>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--get-current-event-time">gtk.get_current_event_time</link></methodname>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--init-check">gtk.init_check</link></methodname>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--remove-log-handlers">gtk.remove_log_handlers</link></methodname>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--add-log-handlers">gtk.add_log_handlers</link></methodname>
	</methodsynopsis><methodsynopsis language="python">
	  <methodname><link
linkend="function-gtk--set-interactive">gtk.set_interactive</link></methodname>
    <methodparam><parameter>interactive</parameter></methodparam>
	</methodsynopsis><methodsynopsis language="python">
    <methodname><link
linkend="function-gtk--show-uri">gtk.show_uri</link></methodname>
    <methodparam><parameter role="keyword">screen</parameter></methodparam>
    <methodparam><parameter role="keyword">uri</parameter></methodparam>
    <methodparam><parameter role="keyword">timestamp</parameter></methodparam>
  </methodsynopsis>
</programlisting>

    </refsect2>

  </refsect1>

  <refsect1>
    <title>Description</title>

    <para>All <literal>PyGTK</literal> functions for the gtk module are
listed above categorized by class. Those functions associated with a class
have their descriptions included with the class reference. Those functions
that are not associated with a specific class are described below.</para>

  </refsect1>

  <refsect1>
    <title>Functions</title>

    <refsect2 id="function-gtk--check-version">
      <title>gtk.check_version</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.check_version</methodname>
	  <methodparam><parameter
			 role="keyword">required_major</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">required_minor</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">required_micro</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
role="keyword">required_major</parameter>&nbsp;:</term>
	  <listitem><simpara>the required major version
number</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">required_minor</parameter>&nbsp;:</term>
	  <listitem><simpara>the required minor version
number</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">required_micro</parameter>&nbsp;:</term>
	  <listitem><simpara>the required micro version
number</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>None</literal> if the underlying
<literal>GTK+</literal> library is compatible or a string describing the
mismatch</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.check_version</function>() function checks the
underlying <literal>GTK+</literal> library version against the version
specified by <parameter>required_major</parameter>,
<parameter>required_minor</parameter> and
<parameter>required_micro</parameter>. If the library is compatible this
function returns <literal>None</literal>; otherwise it returns a string
describing the mismatch.</para>

    </refsect2>

    <refsect2 id="function-gtk--draw-insertion-cursor">
      <title>gtk.draw_insertion_cursor</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.draw_insertion_cursor</methodname>
	  <methodparam><parameter
			 role="keyword">widget</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">drawable</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">area</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">location</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">is_primary</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">direction</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">draw_arrow</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">widget</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
	  linkend="class-gtkwidget"><classname>gtk.Widget</classname></link></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
	  role="keyword">drawable</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link linkend="class-gdkdrawable"><classname>gtk.gdk.Drawable</classname></link></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">area</parameter>&nbsp;:</term>
	  <listitem><simpara>the rectangle to which the output is clipped, or
<literal>None</literal> if the output should not be clipped</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">location</parameter>&nbsp;:</term>
	  <listitem><simpara>the location to draw the cursor
	  (<parameter>location.width</parameter> is
	  ignored)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
	  role="keyword">is_primary</parameter>&nbsp;:</term>
	  <listitem><simpara> if <literal>True</literal> the cursor should
	  be the primary cursor color.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
	  role="keyword">direction</parameter>&nbsp;:</term>
	  <listitem><simpara>the direction of the cursor; either
	  <literal>gtk.TEXT_DIR_LTR</literal> or
	  <literal>gtk.TEXT_DIR_RTL</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
	  role="keyword">draw_arrow</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> draw a directional
	  arrow on the cursor. Should be <literal>False</literal> unless the
	  cursor is split.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This function is available in PyGTK 2.4 and above.</para>
      </note>

      <para>The <function>gtk.draw_insertion_cursor</function>() function
draws a text caret on the <link
linkend="class-gdkdrawable"><classname>gtk.gdk.Drawable</classname></link>
specified by <parameter>drawable</parameter> at the position specified by
<parameter>location</parameter>. <parameter>area</parameter> specifies a
clipping rectangle or is <literal>None</literal> if the output should not be
clipped. If <parameter>is_primary</parameter> is <literal>True</literal> the
cursor should be the primary cursor color. <parameter>direction</parameter>
specifies whether the cursor is right-to-left or left-to-right. This is a
convenience function for drawing the standard cursor shape.</para>

    </refsect2>

    <refsect2 id="function-gtk--get-default-language">
      <title>gtk.get_default_language</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.get_default_language</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-pangolanguage"><classname>pango.Language</classname></link>
object for the default language</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.get_default_language</function>() function
returns a <link
linkend="class-pangolanguage"><classname>pango.Language</classname></link>
describing the default language.</para>

    </refsect2>

    <refsect2 id="function-gtk--events-pending">
      <title>gtk.events_pending</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.events_pending</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if any events are
pending</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.events_pending</function>() function returns
<literal>True</literal> if any events are pending. This can be used to
update the user interface and invoke timeouts etc. while doing some time
intensive computation.</para>

    </refsect2>

    <refsect2 id="function-gtk--main-do-event">
      <title>gtk.main_do_event</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.main_do_event</methodname>
	  <methodparam><parameter
			 role="keyword"></parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">event</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gdkevent"><classname>gtk.gdk.Event</classname></link> to
process</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.main_do_event</function>() function processes
a single <link
linkend="class-gdkevent"><classname>gtk.gdk.Event</classname></link>. This
function is public only to allow filtering of events between
<literal>GDK</literal> and <literal>GTK+</literal>. You will not usually
need to call this function directly. While you should not call this function
directly, you might want to know how exactly events are handled. So here is
what this function does with the event:</para>

      <orderedlist>
	<listitem>
	  <simpara>Compress enter/leave notify events. If the event passed
builds an enter-leave pair together with the next event (peeked from
<literal>GDK</literal>) both events are thrown away. This is to avoid a
backlog of (de-)highlighting widgets crossed by the pointer.</simpara>
	</listitem>
	<listitem>
	  <simpara>Find the widget which got the event. If the widget can't
be determined the event is thrown away unless it belongs to a
<literal>INCR</literal> transaction. In that case it is passed to
<function>gtk_selection_incr_event</function>().</simpara>
	</listitem>
	<listitem>
	  <simpara>Then the event is passed on a stack so you can query the
currently handled event with <link
linkend="function-gtk--get-current-event"><function>gtk.get_current_event</function>()</link>.</simpara>
	</listitem>
	<listitem>
	  <simpara>The event is sent to a widget. If a grab is active all
events for widgets that are not in the contained in the grab widget are sent
to the latter with a few exceptions:</simpara>
	  <itemizedlist>
	    <listitem>
	      <simpara>Deletion and destruction events are still sent to the
event widget for obvious reasons. </simpara>
	    </listitem>
	    <listitem>
	      <simpara>Events which directly relate to the visual
representation of the event widget. </simpara>
	    </listitem>
	    <listitem>
	      <simpara>Leave events are delivered to the event widget if
there was an enter event delivered to it before without the paired leave
event. </simpara>
	    </listitem>
	    <listitem>
	      <simpara>Drag events are not redirected because it is unclear
what the semantics of that would be. </simpara>
	    </listitem>
	  </itemizedlist>
	  <simpara>Another point of interest might be that all key events
are first passed through the key snooper functions if there are any. Read
the description of <function>gtk_key_snooper_install</function>() if you
need this feature.</simpara>
	</listitem>
	<listitem>
	  <simpara>After finishing the delivery the event is popped from the
event stack. </simpara>
	</listitem>
      </orderedlist>

      <para></para>

    </refsect2>

    <refsect2 id="function-gtk--main">
      <title>gtk.main</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.main</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>

      <para>The <function>gtk.main</function>() function runs the main loop
until the <link
linkend="function-gtk--main-quit"><function>gtk.main_quit</function>()</link> 
function is called. You can nest calls to <function>gtk.main</function>().
In that case the call to the <link
linkend="function-gtk--main-quit"><function>gtk.main_quit</function>()</link> 
function will make the innermost invocation of the main loop return.</para>

    </refsect2>

    <refsect2 id="function-gtk--main-level">
      <title>gtk.main_level</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.main_level</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the nesting level of the current invocation of
the main loop</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.main_level</function>() function returns the
current nesting level of the main loop. The nesting level is increased by
calling the <link
linkend="function-gtk--main"><function>gtk.main</function>()</link> function
and reduced by calling the <link
linkend="function-gtk--main-quit"><function>gtk.main_quit</function>()</link> 
function.</para>

    </refsect2>

    <refsect2 id="function-gtk--main-quit">
      <title>gtk.main_quit</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.main_quit</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>

      <para>The <function>gtk.main_quit</function>() function terminates the
current main loop level started by the most recent call to the <link
linkend="function-gtk--main"><function>gtk.main</function>()</link>
function. The nesting level of the main loop is reduced by calling this
function.</para>

    </refsect2>

    <refsect2 id="function-gtk--main-iteration">
      <title>gtk.main_iteration</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.main_iteration</methodname>
	  <methodparam><parameter
			 role="keyword">block</parameter>
	    <initializer>True</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">block</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> block if no events
are pending</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the <link
linkend="function-gtk--main-quit"><function>gtk.main_quit</function>()</link> 
function has been called for the innermost main loop.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.main_iteration</function>() function runs a
single iteration of the mainloop. If no events are waiting to be processed
<literal>PyGTK</literal> will block until the next event is noticed if
<parameter>block</parameter> is <literal>True</literal>. This function is
identical to the <link
linkend="function-gtk--main-iteration-do"><function>gtk.main_iteration_do</function>()</link> 
function.</para>

    </refsect2>

    <refsect2 id="function-gtk--main-iteration-do">
      <title>gtk.main_iteration_do</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.main_iteration_do</methodname>
	  <methodparam><parameter
			 role="keyword">block</parameter>
	    <initializer>True</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">block</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> block if no events
are pending</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the <link
linkend="function-gtk--main-quit"><function>gtk.main_quit</function>()</link> 
function has been called for the innermost main loop.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.main_iteration_do</function>() function runs a
single iteration of the main loop. If <parameter>block</parameter> is
<literal>True</literal> block until an event occurs. This function is
identical to the <link
linkend="function-gtk--main-iteration"><function>gtk.main_iteration</function>()</link> 
function.</para>

    </refsect2>

    <refsect2 id="function-gtk--grab-get-current">
      <title>gtk.grab_get_current</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.grab_get_current</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> that has
the grab currently or <literal>None</literal> if no grab is
active</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.grab_get_current</function>() function returns
the <link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>
that has the grab or <literal>None</literal> if no grab is active.</para>

    </refsect2>

    <refsect2 id="function-gtk--quit-add">
      <title>gtk.quit_add</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.quit_add</methodname>
	  <methodparam><parameter>level</parameter></methodparam>
	  <methodparam><parameter>func</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">level</parameter>&nbsp;:</term>
	  <listitem><simpara>the level at which termination
<parameter>func</parameter> shall be called. You can pass 0 here to have
<parameter>func</parameter> run at the termination of the current main
loop.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">func</parameter>&nbsp;:</term>
	  <listitem><simpara>the function to call - it should return 0 to be
removed from the list of quit handlers</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">...</parameter>&nbsp;:</term>
	  <listitem><simpara>optional parameter(s) to be passed to
<parameter>func</parameter></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a handle for this quit handler (you need this
for the <link
linkend="function-gtk--quit-remove"><function>gtk.quit_remove</function>()</link> 
function).</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.quit_add</function>() function registers a
function specified by <parameter>func</parameter> to be called when the
specified main loop <parameter>level</parameter> is exited.
<parameter>func</parameter> should return 0 to be removed from the list of
quit handlers. This function returns a handler ID that is used when removing
the handler with the <link
linkend="function-gtk--quit-remove"><function>gtk.quit_remove</function>()</link> 
function.</para>

    </refsect2>

    <refsect2 id="function-gtk--quit-remove">
      <title>gtk.quit_remove</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.quit_remove</methodname>
	  <methodparam><parameter
			 role="keyword">quit_handler_id</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
role="keyword">quit_handler_id</parameter>&nbsp;:</term>
	  <listitem><simpara>the ID of a quit handler</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.quit_remove</function>() function removes the
quit handler specified by <parameter>quit_handler_id</parameter> from the
list of quit handlers.</para>

    </refsect2>

    <refsect2 id="function-gtk--get-current-event">
      <title>gtk.get_current_event</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.get_current_event</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a copy of the current event or
<literal>None</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This function is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <function>gtk.get_current_event</function>() function
returns a copy of the event currently being processed by GTK+. For example,
if you get a "clicked" signal from <link
linkend="class-gtkbutton"><classname>gtk.Button</classname></link>, the
current event will be the GdkEventButton that triggered the "clicked"
signal. If there is no current event, the function returns
<literal>None</literal>.</para>

    </refsect2>

    <refsect2 id="function-gtk--get-current-event-state">
      <title>gtk.get_current_event_state</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.get_current_event_state</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the state of the current event if any or
<literal>None</literal> if there is no current event or
state</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This function is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <function>gtk.get_current_event_state</function>() function
returns the state of the current event or <literal>None</literal> if there
is no current event or state.</para>

    </refsect2>

    <refsect2 id="function-gtk--get-current-event-time">
      <title>gtk.get_current_event_time</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.get_current_event_time</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the timestamp of the current event or
0L</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.get_current_event_time</function>() function
returns the timestamp from the current event or 0L if there is no current
event.</para>

    </refsect2>

    <refsect2 id="function-gtk--init-check">
      <title>gtk.init_check</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>gtk.init_check</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if GTK has been
          successfully initialized</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <function>gtk.init_check</function>() function tries to
      initialize GTK and returns <literal>True</literal> if
      successful.</para>

    </refsect2>

    <refsect2 id="function-gtk--remove-log-handlers">
      <title>gtk.remove_log_handlers</title>

      <programlisting><methodsynopsis language="python">
        <methodname>gtk.remove_log_handlers</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <note>
        <para>This function is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <function>gtk.remove_log_handlers</function>() function
      removes the default PyGTK log handlers,</para>

    </refsect2>

    <refsect2 id="function-gtk--add-log-handlers">
      <title>gtk.add_log_handlers</title>

      <programlisting><methodsynopsis language="python">
        <methodname>gtk.add_log_handlers</methodname>
        <methodparam></methodparam>
      </methodsynopsis></programlisting>

      <note>
        <para>This function is available in PyGTK 2.10 and above.</para>
      </note>

      <para>The <function>gtk.add_log_handlers</function>() function
      installs the default PyGTK log handlers,</para>

    </refsect2>

    <refsect2 id="function-gtk--set-interactive">
      <title>gtk.set_interactive</title>

      <programlisting><methodsynopsis language="python">
        <methodname>gtk.set_interactive</methodname>
        <methodparam><parameter>interactive</parameter></methodparam>
      </methodsynopsis></programlisting>
      <variablelist>
        <varlistentry>
          <term><parameter>interactive</parameter>&nbsp;:</term>
          <listitem><simpara>If <literal>True</literal> interactive usage is enabled</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This function is available in PyGTK 2.16 and above.</para>
      </note>

      <para>The <function>gtk.set_interactive</function>() function can be used to
enable or disable interactive usage of PyGTK. By default, interactive usage is switched
on when importing gtk. You can then use PyGTK from the Python command prompt and see the
results immediately without having to call <function>gtk.main</function>().</para>

    </refsect2>

    <refsect2 id="function-gtk--show-uri">
        <title>gtk.show_uri</title>

        <programlisting><methodsynopsis language="python">
            <methodname>show_uri</methodname>
            <methodparam><parameter>screen</parameter></methodparam>
            <methodparam><parameter>uri</parameter></methodparam>
            <methodparam><parameter>timestamp</parameter></methodparam>
        </methodsynopsis></programlisting>
        
        <variablelist>
            <varlistentry>
                <term><parameter role="keyword">screen</parameter>&nbsp;:</term>
                    <listitem><simpara>A
                        <link linkend="class-gdkscreen"><classname>gtk.gdk.Screen</classname></link>
                        to show the uri on or <literal>None</literal> for the default screen.
                    </simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">uri</parameter>&nbsp;:</term>
                    <listitem><simpara>the uri to show.</simpara></listitem>
            </varlistentry>
            <varlistentry>
                <term><parameter role="keyword">timestamp</parameter>&nbsp;:</term>
                    <listitem><simpara>a timestamp to prevent focus stealing.
                    </simpara></listitem>
            </varlistentry>
        </variablelist>

        <note>
            <para>This function is available in PyGTK 2.14 and above.</para>
        </note>

        <para>
            The <methodname>show_uri</methodname>() function is a convenience
            function for launching the default application to show the uri.
            The uri must be of a form understood by GIO. Typical examples are:
        </para>
<programlisting>
file:///home/gnome/pict.jpg
http://www.gnome.org
mailto:me@gnome.org
</programlisting>

        <para>
            Ideally the timestamp is taken from the event triggering the
            <methodname><link linkend="function-gtk--show-uri">gtk.show_uri</link></methodname>()
            call. If timestamp is not known you can take gtk.gdk.CURRENT_TIME.
        </para>
        <para>
            This function can be used as a replacement for gnome_vfs_url_show() and gnome_url_show().
        </para>
    </refsect2>

  </refsect1>

</refentry>
