<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="treeview_cellrenderertoggle.py" xml:lang="ko">

  <info>

    <title type="text">TreeView와 TreeStore(Python)</title>

    <link type="guide" xref="beginner.py#treeview"/>

    <link type="next" xref="widget_drawing.py"/>

    <revision version="0.1" date="2012-06-30" status="draft"/>

    <credit type="author copyright">

      <name>Marta Maria Casetti</name>

      <email its:translate="no">mmcasetti@gmail.com</email>

      <years>2012</years>

    </credit>

    <desc>TreeStore를 보여주는 TreeView(CellRendererToggle이 들어간 더 복잡한 예제)</desc>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>조성호</mal:name>

      <mal:email>shcho@gnome.org</mal:email>

      <mal:years>2017</mal:years>

    </mal:credit>

  </info>

  <title>좀 더 복잡한 TreeView와 TreeStore</title>

  <media type="image" mime="image/png" src="media/treeview_cellrenderertoggle.png"/>

  
이 TreeView에서는 두 열을 TreeStore로 나타내는데, 두 열 중 하나는 상태 반전 방식으로 보여줍니다.

  <links type="section"/>

  <section id="code">

    <title>예제 결과를 만드는 코드</title>

    from gi.repository import Gtk

from gi.repository import Pango

import sys

books = [["Tolstoy, Leo", ["War and Peace", True], ["Anna Karenina", False]],

         ["Shakespeare, William", ["Hamlet", False],

             ["Macbeth", True], ["Othello", False]],

         ["Tolkien, J.R.R.", ["The Lord of the Rings", False]]]

class MyWindow(Gtk.ApplicationWindow):

    def __init__(self, app):

        Gtk.Window.__init__(self, title="Library", application=app)

        self.set_default_size(250, 100)

        self.set_border_width(10)

        # the data are stored in the model

        # create a treestore with two columns

        self.store = Gtk.TreeStore(str, bool)

        # fill in the model

        for i in range(len(books)):

            # the iter piter is returned when appending the author in the first column

            # and False in the second

            piter = self.store.append(None, [books[i][0], False])

            # append the books and the associated boolean value as children of

            # the author

            j = 1

            while j < len(books[i]):

                self.store.append(piter, books[i][j])

                j += 1

        # the treeview shows the model

        # create a treeview on the model self.store

        view = Gtk.TreeView()

        view.set_model(self.store)

        # the cellrenderer for the first column - text

        renderer_books = Gtk.CellRendererText()

        # the first column is created

        column_books = Gtk.TreeViewColumn("Books", renderer_books, text=0)

        # and it is appended to the treeview

        view.append_column(column_books)

        # the cellrenderer for the second column - boolean rendered as a toggle

        renderer_in_out = Gtk.CellRendererToggle()

        # the second column is created

        column_in_out = Gtk.TreeViewColumn("Out?", renderer_in_out, active=1)

        # and it is appended to the treeview

        view.append_column(column_in_out)

        # connect the cellrenderertoggle with a callback function

        renderer_in_out.connect("toggled", self.on_toggled)

        # add the treeview to the window

        self.add(view)

    # callback function for the signal emitted by the cellrenderertoggle

    def on_toggled(self, widget, path):

        # the boolean value of the selected row

        current_value = self.store[path][1]

        # change the boolean value of the selected row in the model

        self.store[path][1] = not current_value

        # new current value!

        current_value = not current_value

        # if length of the path is 1 (that is, if we are selecting an author)

        if len(path) == 1:

            # get the iter associated with the path

            piter = self.store.get_iter(path)

            # get the iter associated with its first child

            citer = self.store.iter_children(piter)

            # while there are children, change the state of their boolean value

            # to the value of the author

            while citer is not None:

                self.store[citer][1] = current_value

                citer = self.store.iter_next(citer)

        # if the length of the path is not 1 (that is, if we are selecting a

        # book)

        elif len(path) != 1:

            # get the first child of the parent of the book (the first book of

            # the author)

            citer = self.store.get_iter(path)

            piter = self.store.iter_parent(citer)

            citer = self.store.iter_children(piter)

            # check if all the children are selected

            all_selected = True

            while citer is not None:

                if self.store[citer][1] == False:

                    all_selected = False

                    break

                citer = self.store.iter_next(citer)

            # if they do, the author as well is selected; otherwise it is not

            self.store[piter][1] = all_selected

class MyApplication(Gtk.Application):

    def __init__(self):

        Gtk.Application.__init__(self)

    def do_activate(self):

        win = MyWindow(self)

        win.show_all()

    def do_startup(self):

        Gtk.Application.do_startup(self)

app = MyApplication()

exit_status = app.run(sys.argv)

sys.exit(exit_status)

  </section>

  <section id="methods">

    <title>TreeView 위젯에 쓸만한 메서드</title>

    
TreeView 위젯은 Model/View/Controller  방식으로 설계했습니다. Model은 데이터를, View는 바뀐 내용 알림을 받은 후의 모델의 내용을, 마지막으로 Controller는 모델의 상태를 바꾸고 뷰에게 바뀐 모델의 상태를 알리는 코드를 담습니다. 자세한 내용과 TreeModel에 대한 쓸만한 메서드 목록을 보시려면 <link xref="model-view-controller.py"/>를 참고하십시오.

    
48번째 줄에서 "toggled" 시그널은 widget.connect(signal, callback function) 함수로  on_toggled() 콜백 함수에 연결했습니다. 더 자세한 설명은 <link xref="signals-callbacks.py"/>를 참조하십시오.

  </section>

  <section id="references">

    <title>API 참고서</title>

    
이 예제는 다음 참고자료가 필요합니다:

    <list>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkTreeView.html">GtkTreeView</link>
</item>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkTreeModel.html">GtkTreeModel</link>
</item>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkTreeStore.html">GtkTreeStore</link>
</item>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkCellRendererText.html">GtkCellRendererText</link>
</item>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkCellRendererToggle.html">GtkCellRendererToggle</link>
</item>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkTreeViewColumn.html">GtkTreeViewColumn</link>
</item>

    </list>

  </section>

</page>