|
Packit |
1470ea |
|
|
Packit |
1470ea |
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" xmlns:xi="http://www.w3.org/2001/XInclude" type="guide" style="task" id="combobox_multicolumn.py" xml:lang="ca">
|
|
Packit |
1470ea |
<info>
|
|
Packit |
1470ea |
<title type="text">ComboBox (Python)</title>
|
|
Packit |
1470ea |
<link type="guide" xref="beginner.py#menu-combo-toolbar"/>
|
|
Packit |
1470ea |
<link type="next" xref="treeview_advanced_liststore.py"/>
|
|
Packit |
1470ea |
<revision version="0.1" date="2012-06-03" status="draft"/>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<credit type="author copyright">
|
|
Packit |
1470ea |
<name>Marta Maria Casetti</name>
|
|
Packit |
1470ea |
<email its:translate="no">mmcasetti@gmail.com</email>
|
|
Packit |
1470ea |
<years>2012</years>
|
|
Packit |
1470ea |
</credit>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<desc>A widget used to choose from a list of items</desc>
|
|
Packit |
1470ea |
</info>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<title>ComboBox (two columns)</title>
|
|
Packit |
1470ea |
<media type="image" mime="image/png" src="media/combobox_multicolumn.png"/>
|
|
Packit |
1470ea |
This ComboBox prints to the terminal your selection when you change it.
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<links type="section"/>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<section id="code">
|
|
Packit |
1470ea |
<title>Code used to generate this example</title>
|
|
Packit |
1470ea |
from gi.repository import Gtk
|
|
Packit |
1470ea |
import sys
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
actions = [["Select", None],
|
|
Packit |
1470ea |
["New", Gtk.STOCK_NEW],
|
|
Packit |
1470ea |
["Open", Gtk.STOCK_OPEN],
|
|
Packit |
1470ea |
["Save", Gtk.STOCK_SAVE]]
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
class MyWindow(Gtk.ApplicationWindow):
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
def __init__(self, app):
|
|
Packit |
1470ea |
Gtk.Window.__init__(self, title="Welcome to GNOME", application=app)
|
|
Packit |
1470ea |
self.set_default_size(200, -1)
|
|
Packit |
1470ea |
self.set_border_width(10)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# the data in the model, of type string on two columns
|
|
Packit |
1470ea |
listmodel = Gtk.ListStore(str, str)
|
|
Packit |
1470ea |
# append the data
|
|
Packit |
1470ea |
for i in range(len(actions)):
|
|
Packit |
1470ea |
listmodel.append(actions[i])
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# a combobox to see the data stored in the model
|
|
Packit |
1470ea |
combobox = Gtk.ComboBox(model=listmodel)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# cellrenderers to render the data
|
|
Packit |
1470ea |
renderer_pixbuf = Gtk.CellRendererPixbuf()
|
|
Packit |
1470ea |
renderer_text = Gtk.CellRendererText()
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# we pack the cell into the beginning of the combobox, allocating
|
|
Packit |
1470ea |
# no more space than needed;
|
|
Packit |
1470ea |
# first the image, then the text;
|
|
Packit |
1470ea |
# note that it does not matter in which order they are in the model,
|
|
Packit |
1470ea |
# the visualization is decided by the order of the cellrenderers
|
|
Packit |
1470ea |
combobox.pack_start(renderer_pixbuf, False)
|
|
Packit |
1470ea |
combobox.pack_start(renderer_text, False)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# associate a property of the cellrenderer to a column in the model
|
|
Packit |
1470ea |
# used by the combobox
|
|
Packit |
1470ea |
combobox.add_attribute(renderer_text, "text", 0)
|
|
Packit |
1470ea |
combobox.add_attribute(renderer_pixbuf, "stock_id", 1)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# the first row is the active one at the beginning
|
|
Packit |
1470ea |
combobox.set_active(0)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# connect the signal emitted when a row is selected to the callback
|
|
Packit |
1470ea |
# function
|
|
Packit |
1470ea |
combobox.connect("changed", self.on_changed)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# add the combobox to the window
|
|
Packit |
1470ea |
self.add(combobox)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
def on_changed(self, combo):
|
|
Packit |
1470ea |
# if the row selected is not the first one, write on the terminal
|
|
Packit |
1470ea |
# the value of the first column in the model
|
|
Packit |
1470ea |
if combo.get_active() != 0:
|
|
Packit |
1470ea |
print("You chose " + str(actions[combo.get_active()][0]) + "\n")
|
|
Packit |
1470ea |
return True
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
class MyApplication(Gtk.Application):
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
def __init__(self):
|
|
Packit |
1470ea |
Gtk.Application.__init__(self)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
def do_activate(self):
|
|
Packit |
1470ea |
win = MyWindow(self)
|
|
Packit |
1470ea |
win.show_all()
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
def do_startup(self):
|
|
Packit |
1470ea |
Gtk.Application.do_startup(self)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
app = MyApplication()
|
|
Packit |
1470ea |
exit_status = app.run(sys.argv)
|
|
Packit |
1470ea |
sys.exit(exit_status)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
</section>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<section id="methods">
|
|
Packit |
1470ea |
<title>Useful methods for a ComboBox widget</title>
|
|
Packit |
1470ea |
The ComboBox widget is designed around a Model/View/Controller design: the Model stores the data; the View gets change notifications and displays the content of the model; the Controller, finally, changes the state of the model and notifies the view of these changes. For more information and for a list of useful methods for ComboBox see <link xref="model-view-controller.py"/>.
|
|
Packit |
1470ea |
In line 45 the "changed" signal is connected to the callback function on_changed() using widget.connect(signal, callback function) . See <link xref="signals-callbacks.py"/> for a more detailed explanation.
|
|
Packit |
1470ea |
</section>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<section id="references">
|
|
Packit |
1470ea |
<title>API References</title>
|
|
Packit |
1470ea |
In this sample we used the following:
|
|
Packit |
1470ea |
<list>
|
|
Packit |
1470ea |
<item><link href="http://developer.gnome.org/gtk3/unstable/GtkComboBox.html">GtkComboBox</link> </item>
|
|
Packit |
1470ea |
<item><link href="http://developer.gnome.org/gtk3/unstable/GtkListStore.html">GtkListStore</link> </item>
|
|
Packit |
1470ea |
<item><link href="http://developer.gnome.org/gtk3/unstable/GtkCellRendererText.html">GtkCellRendererText</link> </item>
|
|
Packit |
1470ea |
<item><link href="http://developer.gnome.org/gtk3/unstable/GtkCellRendererPixbuf.html">GtkCellRendererPixbuf</link> </item>
|
|
Packit |
1470ea |
<item><link href="http://developer.gnome.org/gtk3/unstable/gtk3-Stock-Items.html">Stock Items</link> </item>
|
|
Packit |
1470ea |
<item><link href="http://git.gnome.org/browse/pygobject/tree/gi/overrides/Gtk.py">pygobject - Python bindings for GObject Introspection</link> </item>
|
|
Packit |
1470ea |
</list>
|
|
Packit |
1470ea |
</section>
|
|
Packit |
1470ea |
</page>
|