gtk/tests/testtreeview-plan.txt

This document is a laundry list of stuff to check if you want to
verify that GtkTreeView and associated objects are working properly.
It isn't a very formal test plan or anything.
 
Launching:
 - Launch testtreeview with --gtk-debug=tree, this will ensure that 
   debugging code in the tree widget gets run.

Automated tests:

 - on startup, testtreeview runs some automated tests; these all have
   to pass. 

TreeModel testing:

 - all the TreeView/TreeModel tests in this document should be run 
   with each of the different models testtreeview supports. The 
   option menu at the top of testtreeview lets you swap in the 
   various models. The option menu includes each of the 
   models that comes with GTK, in various configurations, 
   and also NULL (no model).

 - ensure that swapping in a new model for the tree view when there
   was a preexisting one works OK 

TreeViewColumn testing:
 
 - clicking a column header pops up a property inspector for that 
   column, use this to change column attributes for testing
 
 - should test columns with 0, 1, and N columns in the tree view
 
 - check that setting a column invisible works
 
 - check that setting a column unclickable works

 - check that setting the column width works 

 - check that width of -1 unsets column width

 - check that min/max widths can be set/unset and have the desired
   effect

 - check that setting the column title works

 - check that the column with an image in it looks right, there should 
   be such a column (once we support the custom widget feature)

 - check that justification works

TreeView testing:

 - check that expansion/collapse of tree nodes with the expanders
   works

 - check that turning headers off works

 - check that scrolling works properly

 - check that autosize works (resize columns to a weird size, 
   then click autosize to ensure they snap back to the original 
   size)

 - check move_to

 - check expand_all, collapse_all

Key navigation:
 - FIXME, all the keybindings and what they are supposed to do

TreeSelection testing:

 - check that single and multi mode both work; single should allow zero 
   or 1 rows selected, multi should allow any number.

 - in multi, check that shift-select selects a contiguous region,
   control-select selects a disjunct set of nodes

 - check that retrieving the selection works

 - check that foreach() works

CellRenderer testing:

 - these should be well-exercised by the multi-column test, be
   sure everything looks correctly rendered