nsINavHistoryResult Interface

 This is the root of the results. Remember that you need to open all
 containers for their contents to be valid.

readonly attribute nsINavHistoryContainerResultNode root

 The annotation to use in SORT_BY_ANNOTATION_* sorting modes, set this
 before setting the sortingMode attribute.

attribute AUTF8String sortingAnnotation

 The result of a history/bookmark query.

 Use the "root" element to access the children of this query.

 The basic design of the system is a model-view-controller. This result object
 represents the model where the data is stored. External components
 provide the view and controller which define how the data looks and how
 interaction happens.
   [RESULT]----->[viewer]----->[controller]
             |
             +-- nsINavHistoryResultViewer

 The result indicates to the view when something changes through the
 nsINavHistoryResultViewer interface. The viewer is set through
 the nsINavHistoryResult.viewer property.


 Sorts all nodes recursively by the given parameter, one of
 nsINavHistoryQueryOptions.SORT_BY_*  This will update the corresponding
 options for this result, so that re-using the current options/queries will
 always give you the current view.

attribute unsigned short sortingMode

 The viewer for this result (see comment for the class for how these
 objects are related). This may be null, in which case you can still
 manually walk the tree using the root node. When this is non-null, you
 can access the flattened list of items (flatItemCount, nodeForFlatIndex,
 flatIndexForNode).

attribute nsINavHistoryResultViewer viewer