nsITreeSelection 编辑

layout/xul/base/src/tree/public/nsITreeSelection.idlScriptable This interface is used by the tree widget to get information about what is selected. Inherits from: 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	nsITreeColumn	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	nsITreeBoxObject	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. If false, 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.