[ruby-gnome2-doc-cvs] [Ruby-GNOME2 Project Website] update - tut-gtk2-treev-trees

Back to archive index

ruby-****@sourc***** ruby-****@sourc*****
2012年 9月 23日 (日) 10:29:03 JST


-------------------------
REMOTE_ADDR = 184.145.80.187
REMOTE_HOST = 
        URL = http://ruby-gnome2.sourceforge.jp/hiki.cgi?tut-gtk2-treev-trees
-------------------------
@@ -280,36 +280,15 @@
 
 When we first started to discuss the renderers and their attributes we were not yet able to venture into any meaningful code examples precisely because all these examples utilized "set_cell_data_func". It was also hard to deal with the model/view relationships because we lacked basic understanding of the two, which by now should not be an obstacle anymore. We know how columns in model are related to view, and particularly that there is not a one-to-one mapping between them, hence, it is easier to grasp the meaning of the above code snippet. If you still have troubles understanding it perhaps you should reread the introductory chapter with "((<Dissecting the column creation|tut-gtk2-treev-parts#Dissecting the column creation>))" paragraph in it. In the above code snippet we can see how a tree view column objects are associated with a cell renderer objects, and that the attributes are actually referred to their pertinent cells in model columns, where their values, potentially 
 many for a single column (one-to-many relationship), should reside in their respective columns across different model records (rows), hence each row can store a different value for a particular cell-renderer attribute.  
 
+All that was just said is encapsulated it the second of the two program examples below called "modelNview_demo.rb". But let's not get ahead of ourselves here and concentrate on the simpler version of the two examples that follow, where we do not store the values for renders' attributes in the model, but change a cell-renderers property according to the different data values it renders. Indeed, the data and resides in persistent model. The first of the following two program examples is our "Grocery List" program example we have already seen, with one new feature, namely, we want to highlight only those rows for which the "Buy" column contains TRUE, by turning the background of cell with TRUE value to red.     
 
 
+Not surprisingly all the work to set the renderer's background property is done in the code block associated with the ((*set_cell_data_func*)) method. Note that this method is associated with a particular cell renderer which in turn is mapped to a tree view column via the column, associated with the renderer by Gtk::TreeViewColumn.new, and subsequently by the Gtk::TreeView#append_column(column) statement to the tree view; so all ((*render, column,*)) and the((*tree view*))are all connected (i.e. related.) The block associated with the cell data function is executed for every row for that particular view column. However, what may surprise a novice GTK+ programmer is that there is no((*:background*))attribute present in the hash of attribute name/value pairs in the constructor for the column! 
 
-############################################
-:((<Cell Data Functions|tut-treeview-renderer-celldatafunc>)) (From Matthew Berg's TreeView Tutorial):
-
-    A cell data function is a block of code that is called for a specific cell renderer for each single row before that row is rendered. It gives you maximum control over what exactly is going to be rendered, as you can set the cell renderer's properties just like you want to have them. Remember not only to set a property if you want it to be active, but also to unset a property if it should not be active (and it might have been set in the previous row).
-
-    Cell data functions are often used if you want more fine-grained control over what is to be displayed, or if the standard way to display something is not quite like you want it to be. A case in point are floating point numbers. If you want floating point numbers to be displayed in a certain way, say with only one digit after the colon/comma, then you need to use a cell data function. Use Gtk::TreeViewColumn#set_cell_data_func to set up a cell data function for a particular cell renderer. 
-
-Here is an example:
-
- liststore = Gtk::ListStore.new(String, Float)
-
- renderer = Gtk::CellRendererText.new
-
- col = Gtk::TreeViewColumn.new("Age", renderer)
-
- col.set_cell_data_func(renderer) do |col, renderer, model, iter|
-   # display age with only one digit 
-   renderer.text = sprintf("%.1f", iter[2])
-   # display cell in red if the age is below 18
-   if iter[2] < 18
-     renderer.background = "red"
-   else
-     renderer.background = nil
-   end
- end
 
 
+{{br}}
+{{br}}
 
 
 Following are two example programs demonstrating the use of ((*set_cell_data_func*)) function. Note that this function is associated with a particular cell renderer which is mapped to a tree view column via the column, associated with the renderer by Gtk::TreeViewColumn.new, and subsequently by the Gtk::TreeView#append_column(column) statement; so all ((*render, column,*))(which is associated with the((*set_cell_data_func*))function) and the((*tree view*))are all connected. The block associated with the cell data function is executed for every row for that particular view column.  




ruby-gnome2-cvs メーリングリストの案内
Back to archive index