.. PyGObject Tutorial documentation master file, created by
   sphinx-quickstart on Fri Aug 26 11:38:48 2011.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

The Python GTK+ 3 Tutorial
==========================

:Release: |version|
:Date: |today|
:Copyright: 2011, The PyGObject Community

This tutorial gives an introduction to writing GTK+ 3 applications in Python.

Prior to working through this tutorial, it is recommended that you
have a reasonable grasp of the Python programming language.
GUI programming introduces new problems compared to interacting
with the standard output (console / terminal).
It is necessary for you to know how to create and run Python files,
understand basic interpreter errors, and work with strings, integers,
floats and Boolean values.
For the more advanced widgets in this tutorial, good knowledge of
lists and tuples will be needed.

Although this tutorial describes the most important classes and methods within
GTK+ 3, it is not supposed to serve as an API reference. Please refer to the
`GTK+ 3 Reference Manual <https://docs.gtk.org/gtk3/>`_ for a
detailed description of the API. Also there's a `Python-specific reference
<https://lazka.github.io/pgi-docs/>`_ available.

Contents:

.. toctree::
   :numbered:
   :maxdepth: 2

   install
   introduction
   basics
   unicode
   gallery
   layout
   label
   entry
   button_widgets
   expander
   progressbar
   spinner
   treeview
   cellrenderers
   combobox
   iconview
   textview
   dialogs
   popover
   clipboard
   drag_and_drop
   builder
   objects
   application

.. toctree::
   :caption: Deprecated
   :maxdepth: 1

   menus
   layout-table

Indices and tables
==================

* :ref:`search`