tests/testtreeview-plan.txt

   1 This document is a laundry list of stuff to check if you want to
   2 verify that GtkTreeView and associated objects are working properly.
   3 It isn't a very formal test plan or anything.
   4
   5 Launching:
   6  - Launch testtreeview with --gtk-debug=tree, this will ensure that
   7    debugging code in the tree widget gets run.
   8
   9 Automated tests:
  10
  11  - on startup, testtreeview runs some automated tests; these all have
  12    to pass.
  13
  14 TreeModel testing:
  15
  16  - all the TreeView/TreeModel tests in this document should be run
  17    with each of the different models testtreeview supports. The
  18    option menu at the top of testtreeview lets you swap in the
  19    various models. The option menu includes each of the
  20    models that comes with GTK, in various configurations,
  21    and also NULL (no model).
  22
  23  - ensure that swapping in a new model for the tree view when there
  24    was a preexisting one works OK
  25
  26 TreeViewColumn testing:
  27
  28  - clicking a column header pops up a property inspector for that
  29    column, use this to change column attributes for testing
  30
  31  - should test columns with 0, 1, and N columns in the tree view
  32
  33  - check that setting a column invisible works
  34
  35  - check that setting a column unclickable works
  36
  37  - check that setting the column width works
  38
  39  - check that width of -1 unsets column width
  40
  41  - check that min/max widths can be set/unset and have the desired
  42    effect
  43
  44  - check that setting the column title works
  45
  46  - check that the column with an image in it looks right, there should
  47    be such a column (once we support the custom widget feature)
  48
  49  - check that justification works
  50
  51 TreeView testing:
  52
  53  - check that expansion/collapse of tree nodes with the expanders
  54    works
  55
  56  - check that turning headers off works
  57
  58  - check that scrolling works properly
  59
  60  - check that autosize works (resize columns to a weird size,
  61    then click autosize to ensure they snap back to the original
  62    size)
  63
  64  - check move_to
  65
  66  - check expand_all, collapse_all
  67
  68 Key navigation:
  69  - FIXME, all the keybindings and what they are supposed to do
  70
  71 TreeSelection testing:
  72
  73  - check that single and multi mode both work; single should allow zero
  74    or 1 rows selected, multi should allow any number.
  75
  76  - in multi, check that shift-select selects a contiguous region,
  77    control-select selects a disjunct set of nodes
  78
  79  - check that retrieving the selection works
  80
  81  - check that foreach() works
  82
  83 CellRenderer testing:
  84
  85  - these should be well-exercised by the multi-column test, be
  86    sure everything looks correctly rendered
  87