GtkTreeView

Wprowadzenie

GtkTreeView jest kontrolką pozwalającą wyświetlać jak sama nazwa wskazuje drzewa oraz listy.
Najważniejszą koncepcją leżąca u podstaw GtkTreeView jest to, że dane są całkowite oddzielenie od sposobu wyświetlania ich na ekranie. Czyli model / view / Controller-design (MVC). Dane różnego typu (łańcuchy, liczby, obrazy, itp.) są przechowywane w "model", natomiast "View" określa jak dane na wyświeć, tzn.
gdzie i jak wyświetlić.

Rozdział powstał w dużej mierze na podstawie "GTK+ 2.0 Tree View Tutorial" autorstwa Tim-Philipp Müller.

Zanim przejdę do omawiania tworzenia kontrolki GtkTreeView, dodawnaia kolumn, komórek, itd., należy omówić ściśle związany z tą kontrolką GtkTreeModel.

GtkTreeModel interfejs do magazynu danych

GtkTreeModel jest to w zasadzie tylko interfejs do danych (nazwijmy te dane magazynem danych), co oznacza, że jest to standardowy zestaw funkcji, które pozwalają kontrolce GtkTreeView i programiście na odpytywanie o pewne cechy magazynu danych, np. ile wierszy danych znajduje się, a w przypadku drzew, które wiersze mają potomków, itp.
GtkTreeModel dostarcza również funkcji do pobierania danych z magazynu danych oraz informuje widok drzewa (View) jakiego typu dane są przechowywane w modelu.
Interfejs GtkTreeModel nie pozwala dodać, usunąć lub  zmienić wierszy danych w magazynie danych. Odbywa się za pomocą określonych magazynie danych funkcji.
GTK+ jest wyposażony w dwa wbudowane magazyn danych (modele): GtkListStore i GtkTreeStore.
Jak sugerują nazwy GtkListStore służy do przechowywania prostych list elementów, w którym elementy nie mają hierarchii rodzic-dziecko, natomiast GtkTreeStore służy do przechowywania struktur drzewiastych, w których elementy mogą mieć relacje rodzic-dziecko.

Organizacja danych w magazynie danych

Magazyn danych (model) zawiera kolumny i wiersze. Kolumna magazynu danych (modelu) reprezentuje pewne pole danych o stałym typie danych, tzn. np. kiedy w kolumnie przechowywane są dane typu tekstowego, to nie można wstawiać tam danych powiedzmy graficznych.
Musisz wiedzieć jakiego rodzaju dane chcesz zapisać podczas tworzenia magazynu list (GtkListStore), lub magazynu drzewa (GtkTreeStore). Dla przykładu, chcemy wyświetlić listę plików. Przyjmijmy, że magazyn list składa się dwóch pól: pole przechowywujące nazwę pliku (czyli tekst), i pole przechowywujące rozmiar pliku (tj. liczbę całkowitą bez znaku). Nazwa pliku będzie przechowywana w 0-ej kolumnie modelu, a rozmiar pliku będzie zapisany w kolumnie 1-szej modelu.
Do utworzenia magazynu listy używa się:
Zwraca wskaźnik na GtkListStore, pierwszym argumentem jest ilość kolumn danych w liście, trzy kropki oznaczają, że jest funkcją wiele argumentową. Tymi argumentami mogą być różne typy danych, najczęściej używane:

• G_TYPE_STRING typ tekstowy
• G_TYPE_INT typ liczbowy wartości całkowitych ze znakiem
• G_TYPE_UINT typ liczbowy wartości całkowitych bez znaku
• G_TYPE_FLOAT, G_TYPE_DOUBLE typy liczbowe wartości zmiennoprzecinkowych
• G_TYPE_STRING typ do przechowywania tekstów (tworzy kopię oryginalnego łańcucha)
• G_TYPE_BOOLEAN typ logiczny (TRUE/FALSE)
• GDK_TYPE_PIXBUF typ do przechowywania grafiki
• G_TYPE_POINTER przechowuje wartość wskaźnika (nie kopiuje żadnych danych do magazynu danych, tylko przechowuje wartość wskaźnika)

Wracając do przykładu listy plików, magazyn list tworzymy w następujący sposób:
W ten sposób powstaje nowy magazyn listy z dwiema kolumnami. Kolumna 0 magazynu będzie przechowywać tekst, a kolumna 1 liczby całkowite bez znaku. W tym momencie model nie ma jeszcze wierszy.

Metody dostępu do wierszy

Istnieją różne metody dostępu do wierszy magazynu danych: GtkTreeIter, GtkTreePath, GtkTreeRowReference.

GtkTreeIter

Zanim omówiony zostanie GtkTreeIter, poznaj definicję co to jest iterator:

W programowaniu obiektowym iteratorem nazywamy obiekt pozwalający na sekwencyjny dostęp do wszystkich elementów lub części zawartych w innym obiekcie, zwykle kontenerze lub liście. Iterator jest czasem nazywany kursorem, zwłaszcza w zastosowaniach związanych z bazami danych.

Źródło: http://pl.wikipedia.org/wiki/Iterator

Do mnie najbardziej przemawia "Iterator jest czasem nazywany kursorem" i tak sobie go tłumacz :)
Iterator jest w istocie odniesieniem do jednego wiersza w magazynie listy, bądź węzła w drzewie.

Poniżej kilka funkcji do manipulacji na iteratorze. Ważne GtkTreeIter nie jest obiektem tylko strukturą, dlatego należy go deklarować jako strukturę, a nie jako wskaźnik na strukturę !

GtkTreeIter możemy ustawić na pierwszy element(wiersz) poprzez funkcje:

Ustawia iter na pierwszy iterator(element) w drzewie i zwraca wartość TRUE. Kiedy drzewo jest puste zwraca FALSE.
Pierwszy argument to wskaźnik na GtkTreeModel, drugi to wskaźnik na iterator do incializacji.

Można ustawić iterator na następny:

Ustawia iter na następny jeśli istnieje i zwraca wartość TRUE, jeżeli następny węzeł nie istnieje zwraca wartość FALSE.

Można ustawić iterator na poprzedni:

Ustawia iter na poprzedni jeśli istnieje i zwraca wartość TRUE, jeżeli następny węzeł nie istnieje zwraca wartość FALSE.

GtkTreePath

GtkTreePath jest stosunkowo prosta droga do opisu logicznej pozycji rzędu w modelu. Ponieważ kontrolka widoku drzewa GtkTreeView zawsze wyświetla wszystkie wiersze w modelu, GtkTreePath zawsze opisuje ten sam wiersz, zarówno w modelu i widoku drzewa.

Funkcje operując na GtkTreePath:
Tworzy nową ścieżkę zwracając wskaźnik na GtkTreePath.
Tworzy nową ścieżkę zwracając wskaźnik na GtkTreePath. Argumentem jest wskaźnik na tekst, którego pola muszą być odzielone dwukropkiem. W przypadku podania błędnego tekstu funkcja  zwróci NULL.
Zwraca wskaźnik do tekstu, który jest ścieżką do elementu, np. "3:2:0". Argumentem jest wskaźnik do GtkTreePath.

Więcej funkcji operujących ma GtkTreePath znajdziesz w dokumentacji na stronie http://developer.gnome.org/gtk3/stable/GtkTreeModel.html

Przykład użycia

Iterator można łatwo przekształcić na ścieżkę uzywając funkcji gtk_tree_model_get_path, a ścieżkę również łatwo można przekształcić na iterator przy pomocy funkcji gtk_tree_model_get_iter. Oto przykład, który pokazuje jak uzyskać iterator (GtkTreeIter) ze ścieżki (GtkTreePath), która jest przekazywana po skojarzeniu sygnału "row-activated" z kontrolką widoku drzewa (GtkTreeView) do określonej przez programiste funkcji, dodatkowo pobiera dane z magazynu danych i wyświetla zawartość:

"Modulacja" magazynu danych

Dowanie wierszy do magazynu listy GtkListStore

Mając magazyn listy GtkListStore można dodać nowy nie wypełnionymi danymi wiersz na koniec magazynu używająć funkcji:
Pierwszy argument to wskaźnik na listę zwróconą przez gtk_list_store_new, drugi na strukturę GtkTreeIter, która jest podstawową metodą dostępu do GtkTreeModel.
Tworzy nowy pusty wiersz w zadanej pozycji w argumencie position. Argumentem list_store jest wskaźnik na utworzony wcześniej magazyn listy, drugi argument iter jest ustawiany na pozycje nowo utworzonego wiersza.
Dodaje nowy pusty wiersz na początek magazynu listy. Argumentem list_store jest wskaźnik na utworzony wcześniej magazyn listy, drugi argument iter jest ustawiany na pozycje nowo utworzonego wiersza.

Wypełnianie, zmiana wartości w wierszach magazynu danych

Wiesz już jak tworzyć nowy pusty wiersz w magazynie danych, więc teraz przedstawię funkcje ustawiające/zmieniające dane.
Ustawia wartościami magazyn danych listy w wierszu, na który wskazuje iterator. Pierwszym argumentem jest wskaźnik magazynu danych listy, drugim wskaźnik na iterator. Kolejnymi wartościami mogą być wartości do wstawienia przy czym  najpierw podaje się numer kolumny, a następnie wartość. Funkcja zaprzestaje przetwarzania arguemntów po napotkaniu -1.
Ustawia wartościami magazyn danych drzewa w węźle, na który wskazuje iterator. Pierwszym argumentem jest wskaźnik magazynu danych drzewa, drugim wskaźnik na iterator. Kolejnymi wartościami mogą być wartości do wstawienia przy czym  najpierw podaje się numer kolumny, a następnie wartość. Funkcja zaprzestaje przetwarzania arguemntów po napotkaniu -1.

Poniżej przykład tworzący magazyn listy o 3 kolumnach, 1-ej przechowuje imiona, czyli tekst, więc skorzystamy z typu G_TYPE_STRING. 2-ga kolumna nazwiska, także skorzystamy z typu G_TYPE_STRING, natomiast 3-cia kolumna rok urodzenia, czyli będzie to liczba. Po głębszym zastanowieniu się rok urodzenia nie może być wartością ujemną, dlatego wykorzystamy typ G_TYPE_UINT:

Wykorzystany w przykładzie został typ wyliczeniowy (enum), który w przypadku dużej ilości pól danych przechowywanych w magazynie znacznie ułatwia programowanie. Nie potrzeba ciągłego pamiętania pozycji pól danych, wystarczy korzystać ze zmiennych wyliczeniowych. Dodatkowym atutem takiego rozwiązania jest możliwość dodawania kolejnych kolumn (pól). Załóżmy, że dochodzisz do wniosku: należy dodać nowe pole przechowywujące w magazynie listy drugie imię. Zmieniony program wygląda tak

Zwróć uwage na , zauważyłeś KOLUMNA_IMIE_DRUGIE, "Piotr" jest na końcu ! Nie ma to znaczenia, w którym miejscu się znajdzie, ponieważ KOLUMNA_IMIE_DRUGIE ma wartość 1, więc zostanie dodane w 2-ie pole magazynu danych, czyli tak jak powinno być. Jednak dla czytelności kodu lepiej pisać w kolejności uporządkowanej.

Ważnym elementem magazynu danych jest to, że nie trzeba martwić się o alokacje i zwalnianie pamięci dla danych w magazynie. Przykładowo wstawiany jest do magazynu danych tekst, to model zadba aby zrobić jego kopie i zapamiętać go w magazynie danych. Jeżeli później w to samo pole wstawiany jest nowy tekst, automatycznie zostanie zwolniona pamięć starego tekstu, a dla nowego zostanie wykonana kopia i zapamiętana w magazynie danych. Działa to dla większości typów, wyjątkiem jest typ G_TYPE_POINTER. W tym przypadku procedury alokacji i zwalniania pamięci spoczywają na barkach programisty.

Pobieranie wierszy danych z magazynu danych

Funkcją pozwalająca na pobieranie danych jest:

Pierwszym argumentem jest wskaźnik na GtkTreeModel, drugim wskaźnik na iter. Ponieważ jest funkcją wieloargumentową wartością informującą o końcu przetwarzaniu argumentów jest -1.
Argumentowo jest funkcją bardzo podoba do funkcji gtk_list_store_set lub gtk_tree_store_set, w przeciwieństwie do nich pobiera dane pod wskazany wskaźnik w podanych kolumnach. Wskaźnik musi być tego samego typu co element przechowywany w kolumnie magazynu danych.
Poniżej przedstawiony jest przykład na bazie poprzedniego rozszerzony o przeglądanie i wypisywanie pobranych wierszy z magazynu danych.

Zauważ, że gdy nowy wiersz jest tworzony, wszystkie pola z rzędu są ustawione na domyślne wartości zerowe odpowiednie dla typu danych. Pole typu G_TYPE_UINT  będzie automatycznie zawierać wartości 0, a pole typu G_TYPE_STRING będzie zawierać NULL.

Usuwanie wierszy danych z magazynu danych

Wiersze usuwa się za pomocą funkcji gtk_list_store_remove i gtk_tree_store_remove. Usunięty wiersz z magazynu danych zostaje automatycznie usunięty z widoku drzewa, jak również wszystkie dane przechowywane w nim będą automatycznie zwalniały zarezerwowaną pamięć. Oczywiście jak już wcześniej wspomniałem wyjątkiem od tej reguły są kolumny z danymi typu G_TYPE_POINTER.
Usuwanie pojedynczego wiersza jest proste: należy uzyskać iterator (GtkTreeIter), który identyfikuje wiersz do usunięcia, a następnie skorzystać z jednej z podanych funkcji:
Zwraca wartość TRUE wtedy, gdy iterator istnaił oraz wiersz z magazynu danych listy został usunięty, a w przeciwnym razie FALSE. Pierwszym argumentem jest wskażnik na magazyn danych listy, drugim wskaźnik na iterator.
Zwraca wartość TRUE wtedy, gdy iterator istniał oraz węzeł został usunięty, a w przeciwnym razie FALSE. Pierwszym argumentem jest wskaźnik na magazyn danych drzewa, drugim wskaźnik na iterator.

Tworzenie kontrolki GtkTreeView

Do stworzenia kontrolki widoku drzewa służy funkcja:
Funkcja zwraca wskaźnik na utworzoną kontrolkę widoku drzewa.
Samo utworzenie kontroli to za mało, na ekranie nic by się nie pojawiło. Należy dołączyć model do kontrolki funkcją:
Pierwszym argumentem jest wskaźnik na kontrolkę widoku drzewa, drugim wskaźnik na model. Jeżeli kontrolka GtkTreeView miała wcześniej dołączony model zostanie on usunięty przed dołączeniem nowego. W przypadku kiedy wskaźnik model będzie zawierał wartość NULL aktualny model zostanie odłączony.

Wyżej napisałem, że model istniejący zostanie usunięty przed dołączeniem nowego modelu do kontrolki widoku drzewa. Będzie to prawda gdy po dołączeniu skorzystasz z funkcji g_object_unref:
Spowoduje to zmniejszenie licznika referencji na model, a tym samym kiedy kontrolka GtkTreeView zostanie zniszczona zostanie zwolniona pamięć zajmowana przez model.

Mapowanie danych na ekranie: GtkTreeViewColumn i GtkCellRenderer

Widok drzewa składa się z kolumn, które należy dołączyć do kontrolki (GtKTreeView), aby wyświetlić cokolwiek w widoku drzewa. Kolumny widoku drzewa (GtkTreeViewColumn) same z siebie nic nie wyświetlają. Do wyświetlania używa się wyspecjalizowanych obiektów GtkCellRenderer (komórek). Komórki GtkCellRenderer są pakowane do kolumn (GtkTreeViewColumn) podobnie jak inne kontrolki są pakowane do GtkHBoxes.
Dla ścisłości proszę przeanalizować rysunek poniżej.

Kolumny "Lp", "Kraj", "Reprezentant", "VIP" są kolumnami widoku drzewa, gdzie również "Lp", "Kraj", "Reprezentant", "VIP" są etykietami nagłówków kolumn. Równie dobrze mogą istnieć kolumny bez etykiet. Zauważ, że kolumna "Kraj" składa się z dwóch komórek, pierwsza wyświetlająca tekst, druga grafikę obrazującą flage danego kraju. Pozostałe z jednej komórki.

Tworzenie kolumn GtkTreeViewColumn i dodawanie ich do kontrolki GtkTreeView

Funkcja tworząca kolumny wygląda następująco:
Funkcja zwraca wskaźnik na utworzoną kolumnę.

Dodatkowo kolumna może mieć nazwę, która będzie widoczna w kontrolce poprzez:
Pobiera wskaźnik do kolumny i tekst, który ma być wyświetlony.

Kolumne do kontrolki GtkTreeView dodajemy używając funkcji:
Zawraca numer kolumny po dodaniu do kontrolki. Argumentami są wskaźniki na kontrolkę GtkTreeView oraz kolumnę zwróconą od gtk_tree_view_column_new

Komórki GtkCellRender

Aktualnie istnieją komórki wyświetlające:

• GtkCellRendererText wyświetlają tekst, liczby, wartości logiczne jako tekst ("Tomasz", "-82.46", "true")
• GtkCellRendererSpin wyświetlają liczby w postaci tekstu, jednak dodatkowo pozwalają na ustawianie liczb tak jak GtkSpinButton
• GtkCellRendererPixbuf wyświetlają grafikę wczytaną przez programistę oraz ikony (stock_icon) dostarczone przez bibliotekę GTK+
• GtkCellRendererToggle wyświetlają wartości logiczne poprzez check box lub wartości zawarte radio button
• GtkCellRendererProgress wyświetlają wartości numeryczne w postaci paska
• GtkCellRendererSpinner wyświetlają animacje bardzo podobny jaką wyświetla kontrolka GtkSpinner

GtkCellRender to obiekty, które są odpowiedzialne za faktyczne wyświetlanie danych w kolumnie (GtkTreeViewColumn). Posiadają one określone atrybuty (będę używał także naprzemiennie właściwości) , określające  w jaki sposób komórka jest rysowana. Dla lepszego zrozumienia proszę przeanalizować poniższy rysunek:

Tworzenie komórki tekstowej:
Funkcja zwraca wskaźnik na utworzoną komórkę tekstową, którą użyjemy w kolumnie.

Mając komórkę utworzoną powyższą funkcją musimy dodać atrybuty, które poinformują kod odpowiedzialny za wyświetlanie w jak sposób interpretować dane zawarte w modelu (GtkTreeModel) i z którą kolumną modelu je powiązać:
Dodaje atrybut mapowania do kolumny. Pierwszym argumentem jest wskaźnik na kolumnę widoku drzewa, drugim wskaźnik na komórkę, trzecim wskaźnik na tekst określający atrybut/właściwość, natomiast czwartym numer kolumny modelu, z któregą będą pobierane dane do wyświetlenia. Tak na przykład jeśli kolumna 2 modelu zawiera łańcuchy tekstowe, można dodać atrybut "text", wtedy komórka GtkCellRendererText  będzie pobierać wartości do wyświetlenia z kolumny 2:

Uwaga! kolumny (column) są numerowane od 0, zatem w tym przypadku faktyczna kolumna modelu to 3.

Kolejna funkcja ustawiająca atrybuty:
Ustawia atrybuty mapowania w wykazie właściwości tree_column. Wszystkie istniejące atrybuty zostaną usunięte i zastąpione nowymi atrybutami. Pierwszym argumentem jest wskaźnik na kolumnę widoku drzewa, drugim wskaźnik na komórkę, kolejne takie jak w gtk_tree_view_column_add_attribute. Ostatnim argumentem jest zawsze wartość NULL:
Objekt komórka będzie wyświetlany na podsawie następujących właściwości: łańcuchy tesktowe przeznaczone do wyświetlenia będą pobierane z kolumny 0 modelu, kolor jaki ma być użyty do wyświetlania będzie pobierany z kolumny 1 modelu, a wartość określająca, czy tekst ma być przekreślony lub nie z kolumny 2 modelu.

Dołączenie komórki do konkretnej kolumny poprzez funkcję:
Argumenty funkcji to wskaźnik na kolumnę stworzoną gtk_tree_view_column_new, wskaźnik na komórkę zwrócony w naszym przypadku przez gtk_cell_renderer_text_new, expand może przyjąć wartość FALSE wtedy komórka nie zajmie więcej miejsca niż jest jej potrzebne do wyświetlenia zawartości. W przypadku TRUE  może zając więcej miejsca.

Podsumowanie. Kroki tworzenia GtkTreeView wraz z jej wypełnieniem

1. Utwórz magazyn danych GtkListStore lub GtkTreeStore funkcjami gtk_list_store_new lub gtk_tree_store_new.
2. Utwórz wiersz funkcją gtk_list_store_append lub węzeł za pomocą gtk_tree_store_append.
3. Ustaw zawartość wiersza gtk_list_store_set lub węzeł za pomocą gtk_tree_store_set.
4. Utwórz kontrolkę widoku GtkTreeView funkcją gtk_tree_view_new.
5. Dołącz model do kontrolki widoku GtkTreeView funkcją gtk_tree_view_set_model. Nie zapomnij o g_object_unref.
6. Uwórz komórki np. gtk_cell_renderer_text_new.
7. Uwórz kolumny gtk_tree_view_column_new , oraz dodaj/ustaw atrybuty gtk_tree_view_column_add_attribute, ewentualnie ustaw tytuł, który będzie widoczny w nagłówku kolumny gtk_tree_view_column_set_title.
8. Upakuj komórki do odpowienich kolumn gtk_tree_view_column_pack_start.
9. Dodaj kolumny do kontrolki widoku drzewa gtk_tree_view_append_column.

Poniżej przykład "TreeView1":
Po skompilowaniu i uruchomieniu programu powinieneś zobaczyć coś takiego:

Zaznaczanie, podwójne kliknięcia

Obsługa zaznaczania w widoku drzewa

Jednym z najbardziej podstawowych cech widoku listy lub widoku drzewa jest to, że wiersze mogą być wybrane lub odznaczone. Zaznaczenie jest obsługiwane przez obiekt GtkTreeSelection. Każdy widok drzewa automatycznie ma związany z nim obiekt GtkTreeSelection, programista może go pobrać za pomocą:
Funkcja zwraca wskaźnik na objekt GtkTreeSelection, argumentem jest wskaźnik na kontrolkę widoku drzewa.

Tryby zazanaczania:

• GTK_SELECTION_NONE nic nie może być zaznaczone
• GTK_SELECTION_SINGLE nie więcej niż jeden wiersz może być zaznaczony
• GTK_SELECTION_BROWSE zawsze tylko jeden wiersz jest zaznaczony
• GTK_SELECTION_MULTIPLE nic lub wiele wierszy jest zazanczonych

Tryb zaznaczania ustwaia się funkcją:

Pierwszym argumentem jest wskaźnik na obiekt GtkTreeSelection, natomiast drugim jeden z podanych wyżej trybów.

Możesz zaznaczać lub odnaczać wiersze z poziomu programu używając funkcji: gtk_tree_selection_select_iter, gtk_tree_selection_select_path, gtk_tree_selection_unselect_iter, gtk_tree_selection_unselect_path, gtk_tree_selection_select_all, oraz gtk_tree_selection_unselect_all. Po więcej informacji odnośnie tych funkcji zajrzyj do dokumentacji Gtk+.

Pobieranie aktualnie zaznaczonych wierszy

Możesz uzyskać dostęp do aktualnie zazanczonych wierszy przechodząc przez wszystkie zaznaczone wiersze za pomocą funkcji gtk_tree_selection_selected_foreach lub uzyskać wskaźnik na strukturę listy GList ścieżek zaznaczonych wierszy za pomocą funkcji gtk_tree_selection_get_selected_rows. Jeśli wybrany jest tryb zaznaczania GTK_SELECTION_SINGLE lub GTK_SELECTION_BROWSE, najwygodniejszy sposób, aby pobrać zaznaczony wiersz jest funkcja gtk_tree_selection_get_selected, która zwróci TRUE jeżeli wiersz jest zaznaczony oraz wypełni iterator odpowiednią wartością. Używa się jej tak jak pokazano poniżej:

Oto jak używać funkcji gtk_tree_selection_selected_foreach:

Obsługa zaznaczenie po dwukrotnym kliknięciu na wierszu

Obsługa polega tylko na skojarzeniu sygnału "row-activated" kontrolki GtkTreeView z odpowiednio napisaną funkcją:

Edytowalne komórki

Niektóre rodzaje komórek pozwalają nie tylko na wyświetlanie danych, lecz także na ich edycje.

Edytowalna komórka GtkCellRendererText

Jak już wspomniałem komórka możne nie tylko wyświetlać tekst, ale także pozwolić użytkownikowi na edycje jej zawartości poprzez dwukrotne kliknięcie na niej.
Aby komórka stała się edytowalna należy ustawić właśC++ciwość "editable" na wartość TRUE. Kiedy komórka stanie się edytowalna można skojarzyć sygnał "edited" z odpowiednią funcją, która ją obsłuży:

Prototyp funckcji obsługującej edycję:
Pierwszy wskaźnik to komórka, której dotyczy edycja, drugi to ścieżka w postaci łańcuch tekstowego, trzeci to nowe zedytowane dane także w postaci tekstu, czwarty to przekazany przez użytkownika z funkcji g_signal_connect.

Przykład w pseudo kodzie:

Edytowalna komórka GtkCellGtkCellRendererSpin

Ponieważ objekt GtkCellGtkCellRendererSpin wywodzi się z GtkCellRendererText obsługuję się tak samo jak GtkCellRendererText. Jedynie w funkcji obsługującej edycje nie można się spodziewać, że otrzymamy liczbę. Ponieważ kojarzymy komorkę także z sygnałem "edited" prototyp funkcji jest idetyczny jak dla obsługi GtkCellRendererText, więc otrzymamy liczbę w postaci łańcucha tekstowego w zmiennej new_text. Dlatego należy użyć, którejś z funkcji konwertującej tekst na liczbę.  

Przykłady i opisy

Przykład "TreeView2"

Poniższy przykład pozwala na dodawanie, usuwanie i zmienianie wierszy w magazynie danych. Na początku aktywny jest tylko przycisk "Dodaj", dopiero kiedy w kolumnie są dane i dodatkowo zostanie zaznaczony wiersz danych aktywne stają się przyciski "Usuń" i "Zmień". Warto zwrócić uwagę w jaki sposób obsługuje się zaznaczanie wierszy:


W powyższym przykładzie użyto funkcji gtk_tree_view_column_new_with_attributes. Jest to funkcja pomagająca przyspieszyć pisanie, ponieważ za jednym użyciem tworzy kolumnę, ustawia jej tytuł oraz ustawia atrybuty. Czyli jest równoważna użyciu funkcji gtk_tree_view_column_set_title, gtk_tree_view_column_pack_start, i gtk_tree_view_column_add_attribute.

Zwraca wskaźnik na utworzoną kolumnę. Pierwszym argumentem jest tekst z nazwą kolumny, drugim wskaźnik na utworzoną wcześniej komórkę, kolejnym/kolejnymi mogą być atrybuty. Argumentem informującym funkcje o końcu przetwarzania argumentów jest NULL.

Przykład z własną obsługą wyświetlanej komórki

Bardzo ciekawy przykład przedstawiający w jaki sposób wpływa się na przetwarzanie, a co z tym się wiąże wyświetlanie danych w komórce. Staraj się, żeby funkcja obsługująca przetwarzanaie w przykładzie poniżej age_cell_data_func była jak najkrótsza i optymalnie napisana, ponieważ jej czas wykonania ma wpływ na czas renderowania komórki:
Efekt działania programu:

Przykład pobiernia danych i wyświetlania ich w oknie dialogowym "TreeView4"

W tym przykładzie przedstawiona jest obsługa sygnału "row-activated", oraz w jaki sposób można wyświetlić wartości pobrane z magazynu danych (modelu). Dodatkowo pokazano jak obsługiwać komórki GtkCellRendererToggle, a w tym przypadku podobne do GtkCheckButton, skojarzone z sygnałem "toggled":
Ujrzysz to:

Dodatkowo po kliknięciu na wiersz widoku drzewa pojaw sie okno dialogo z informacjami:

Przykład pokazujący możliwość wyświetlania wielu komórek w kolumnie, w tym użycie grafiki. GtkCellRendererToggle - toggle button obsługa

Poniżej bardziej skomplikowany przykład, m.in. kolumna Kraj z dwoma komórkami,  w tym użycie grafiki, wyświetlanie na podstawie właściwości zawartych w modelu oraz modyfikowalna kolumna VIP z opcjami wyboru, których wybranie ma wpływ na sposób wyświetlania.
Ponieważ użyłem grafiki, która symbolizuje flagi państw kod został podzielony na dwie części flahi.h - definicje flag oraz właściwy program. Definicję flag zostały ztworzone programem gdk-pixbuf-csource, który jest na wyposażeniu biblioteki Gtk+. Przykładowe użycie z konwesją grafiki "obraz.png" na plik "obrazinline.h". Dane definiujące grafikę bedą dostępne pod nazwą zmiennej "mojobraz_inline":

Zawartość flagi.h:

Właściwy program:
Oto efekty:

Kolumna VIP pozwal na wybór:

Została wybrana opcja "NIEZNANY", efektem jest przekreślenie w kolumnie "Reprezentant" tekstu "Klos Hans":