1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
|
<?xml version='1.0' encoding='UTF-8'?>
<page xmlns="http://projectmallard.org/1.0/"
xmlns:its="http://www.w3.org/2005/11/its"
xmlns:e="http://projectmallard.org/experimental/"
type="guide" style="task"
id="tutorial.py">
<info>
<title type="text">Tutorial for beginners (Python)</title>
<link type="guide" xref="py#tutorial"/>
<revision pkgversion="3.8" date="2013-02-25" status="draft"/>
<desc>A tutorial for beginners who want to learn how to program GUIs using GTK+ in Python.</desc>
<credit type="author copyright">
<name>Tiffany Antopolski</name>
<email its:translate="no">tiffany.antopolski@gmail.com</email>
<years>2012</years>
</credit>
<credit type="author copyright">
<name>Marta Maria Casetti</name>
<email its:translate="no">mmcasetti@gmail.com</email>
<years>2012 2013</years>
</credit>
<credit type="editor author">
<name>Jim Campbell</name>
<email its:translate="no">jwcampbell@gmail.com</email>
<years>2013</years>
</credit>
</info>
<title>Tutorial for beginners</title>
<synopsis>
<p>By following these tutorials you will learn the basics of GUI programming using GTK+ in Python.</p>
<p>If you have never programmed before, or are not familiar with the concepts of object oriented programming, you may need to learn a few basics first. The book <link href="http://learnpythonthehardway.org/book/">Learn Python the Hard Way</link> or <link href="http://docs.python.org/tutorial/index.html">The Python Tutorial</link> may be a better place for you to start. You may also be interested in <link href="http://python-gtk-3-tutorial.readthedocs.org/en/latest/index.html">The Python GTK+ 3 Tutorial</link>. Once you master the basics, be sure to come back and check out these tutorials.</p>
</synopsis>
<links type="section" />
<section id="to-run">
<title>To run the code samples</title>
<p>To run the code samples in the tutorial:</p>
<steps>
<item><p>Type or copy and paste the code into a file, and save the file with a name like <var>filename</var>.py</p></item>
<item><p>To execute the code, type in the terminal:</p>
<screen>python <var>filename</var>.py</screen>
</item>
</steps>
<p>After executing the code, you will either see the widget on your screen, or (if you have mistyped some of the code) you will see an error message that will help you identify the problem.</p>
</section>
<section id="widgets">
<title>A path through the widgets (with some theory)</title>
<p>The tutorial will walk you through increasingly complex examples and programming theory, but you can also feel free to just go directly to the tutorial that is most helpful to you.</p>
<steps>
<title>Tutorial</title>
<item><steps>
<title>Basic windows</title>
<item><p><link xref="window.py" /></p></item>
<item><p><link xref="GtkApplicationWindow.py" /></p></item>
</steps></item>
<item><steps>
<title>Images and labels</title>
<item><p><link xref="image.py" /></p></item>
<item><p><link xref="strings.py" /></p></item>
<item><p><link xref="label.py" /></p></item>
</steps></item>
<item><steps>
<title>Introduction to properties</title>
<item><p><link xref="properties.py" /></p></item>
</steps></item>
<item><steps>
<title>Grid, separator and scrolling</title>
<item><p><link xref="grid.py" /></p></item>
<item><p><link xref="separator.py" /></p></item>
<item><p><link xref="scrolledwindow.py" /></p></item>
<item><p><link xref="paned.py" /></p></item>
</steps></item>
<item><steps>
<title>Signals, callbacks and buttons</title>
<item><p><link xref="signals-callbacks.py" /></p></item>
<item><p><link xref="button.py" /></p></item>
<item><p><link xref="linkbutton.py" /></p></item>
<item><p><link xref="checkbutton.py" /></p></item>
<item><p><link xref="togglebutton.py" /></p></item>
<item><p><link xref="switch.py" /></p></item>
<item><p><link xref="radiobutton.py" /></p></item>
</steps></item>
<item><steps>
<title>ButtonBox</title>
<item><p><link xref="buttonbox.py" /></p></item>
</steps></item>
<item><steps>
<title>Other display widgets</title>
<item><p><link xref="statusbar.py" /></p></item>
<item><p><link xref="spinner.py" /></p></item>
<item><p><link xref="progressbar.py" /></p></item>
</steps></item>
<item><steps>
<title>Entry widgets</title>
<item><p><link xref="spinbutton.py" /></p></item>
<item><p><link xref="entry.py" /></p></item>
<item><p><link xref="scale.py" /></p></item>
</steps></item>
<item><steps>
<title>A widget to write and display text</title>
<item><p><link xref="textview.py" /></p></item>
</steps></item>
<item><steps>
<title>Dialogs</title>
<item><p><link xref="dialog.py" /></p></item>
<item><p><link xref="aboutdialog.py" /></p></item>
<item><p><link xref="messagedialog.py" /></p></item>
</steps></item>
<item><steps>
<title>Menus, Toolbars and Tooltips (also: using Glade and GtkBuilder)</title>
<item><p><link xref="gmenu.py" /></p></item>
<item><p><link xref="menubutton.py" /></p></item>
<item><p><link xref="toolbar.py" /></p></item>
<item><p><link xref="tooltip.py" /></p></item>
<item><p><link xref="toolbar_builder.py" /></p></item>
<item><p><link xref="menubar.py" /></p></item>
</steps></item>
<item><steps>
<title>Selectors</title>
<item><p><link xref="colorbutton.py" /></p></item>
<item><p><link xref="fontchooserwidget.py" /></p></item>
<item><p><link xref="filechooserdialog.py" /></p></item>
</steps></item>
<item><steps>
<title>TreeViews and ComboBoxes (using the M/V/C design)</title>
<item><p><link xref="combobox.py" /></p></item>
<item><p><link xref="treeview_simple_liststore.py" /></p></item>
<item><p><link xref="treeview_treestore.py" /></p></item>
<item><p><link xref="model-view-controller.py" /></p></item>
<item><p><link xref="combobox_multicolumn.py" /></p></item>
<item><p><link xref="treeview_advanced_liststore.py" /></p></item>
<item><p><link xref="treeview_cellrenderertoggle.py" /></p></item>
</steps></item>
<item><steps>
<title>Custom widget</title>
<item><p><link xref="widget_drawing.py" /></p></item>
</steps></item>
</steps>
</section>
</page>
|
