nsIXULSortService

A service used to sort the contents of a XUL widget.
Inherits from: nsISupports Last changed in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

Method overview

void insertContainerNode(in nsIRDFCompositeDataSource db, in nsRDFSortState sortStatePtr, in nsIContent root, in nsIContent trueParent, in nsIContent container, in nsIContent node, in boolean aNotify); Native code only! Obsolete since Gecko 1.9
void sort(in nsIDOMNode aNode, in AString aSortKey, in AString aSortHints);

Constants

Constant Value Description
SORT_COMPARECASE 0x0001
SORT_INTEGER 0x0100

Methods

Native code only!

insertContainerNode

Obsolete since Gecko 1.9 (Firefox 3)
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.

Used internally for insertion sorting.

void insertContainerNode(
  in nsIRDFCompositeDataSource db,
  in nsRDFSortState sortStatePtr,
  in nsIContent root,
  in nsIContent trueParent,
  in nsIContent container,
  in nsIContent node,
  in boolean aNotify
);
Parameters
db
sortStatePtr
root
trueParent
container
node
aNotify

sort()

Sort the contents of the widget containing aNode using aSortKey as the comparison key, and aSortHints as how to sort.

void sort(
  in nsIDOMNode aNode,
  in AString aSortKey,
  in AString aSortHints
);
Parameters
aNode
A node in the XUL widget whose children are to be sorted.
aSortKey
The value to be used as the comparison key.
aSortHints
One or more hints as to how to sort:
  • ascending: sort the contents in ascending order
  • descending: sort the contents in descending order
  • comparecase: perform case sensitive comparisons
  • integer: treat values as integers, non-integers are compared as strings
  • twostate: do not allow the natural (unordered state)

See also