nsISupports
Last changed in Gecko 1.9 (Firefox 3)Method overview
void adjustSelection(in long index, in long count); |
void clearRange(in long startIndex, in long endIndex); |
void clearSelection(); |
void getRangeAt(in long i, out long min, out long max); |
long getRangeCount(); |
void invalidateSelection(); |
void invertSelection(); |
boolean isSelected(in long index); |
void rangedSelect(in long startIndex, in long endIndex, in boolean augment); |
void select(in long index); |
void selectAll(); |
void timedSelect(in long index, in long delay); |
void toggleSelect(in long index); |
Attributes
Attribute | Type | Description |
count |
long |
The number of rows currently selected in this tree. Read only. |
currentColumn |
|
The current column. |
currentIndex |
long |
The current item (the one with focus). Note: This property indicates only the index of the row with tree cursor around it. This is not a reliable method of determining the selected row, as the selection may include multiple rows, or the focused row may not even be selected. |
selectEventsSuppressed |
boolean |
This attribute is a boolean indicating whether or not the "select" event should fire when the selection is changed using one of our methods. A view can use this to temporarily suppress the selection while manipulating all of the indices, for example, on a sort. Note: Setting this attribute to false will fire a select event. |
shiftSelectPivot |
long |
The selection "pivot". This is the first item the user selected as part of a ranged select. Read only. |
single |
boolean |
This attribute is a boolean indicating single selection. Read only. |
tree |
|
The tree widget for this selection. |
Methods
adjustSelection()
Called when the row count changes to adjust selection indices.
void adjustSelection( in long index, in long count );
Parameters
-
index
- Index of the change.
-
count
- Number of rows changed.
clearRange()
Clears the range.
void clearRange( in long startIndex, in long endIndex );
Parameters
-
startIndex
- Index to clearing at.
-
endIndex
- Index to stop clearing at.
clearSelection()
Clears the selection.
void clearSelection();
Parameters
None.
getRangeAt()
Returns two objects whose value properties represent the minimum and maximum indices of the given selection range. See the Tree Selection tutorial.
void getRangeAt( in long i, out long min, out long max );
Parameters
-
i
-
Index of range to get (0 <= i < getRangeCount())
-
min
-
Index of first object in range.
-
max
-
Index of last object in this range. For single selections
, min == max.
getRangeCount()
Returns a count of selection ranges.
long getRangeCount();
Parameters
None.
Return value
long - number of selection ranges
invalidateSelection()
Can be used to invalidate the selection.
void invalidateSelection();
Parameters
None.
invertSelection()
Inverts the selection.
void invertSelection();
Parameters
None.
isSelected()
Indicates whether or not the row at the specified index is part of the selection.
boolean isSelected( in long index );
Parameters
-
index
- Index of the row to check.
Return value
rangedSelect()
Select the range specified by the indices.
void rangedSelect( in long startIndex, in long endIndex, in boolean augment );
Parameters
-
startIndex
- Index to start selecting at.
-
endIndex
- Index to stop selecting at. This parameter is inclusive; to select one item, set endIndex == startIndex.
-
augment
-
If
true
, the range is added to the selection without clearing out anything else. Iffalse
, everything is cleared except for the specified range.
select()
Deselect all rows and select the row at the specified index.
void select( in long index );
Parameters
-
index
- Index of the row to select.
selectAll()
Selects all rows.
void selectAll();
Parameters
None.
timedSelect()
Perform a timed select.
void timedSelect( in long index, in long delay );
Parameters
-
index
- Index of the row to select.
-
delay
- Time in miliseconds to delay selection.
toggleSelect()
Toggle the selection state of the row at the specified index.
void toggleSelect( in long index );
Parameters
-
index
- Row to toggle.