1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
interface nsITreeBoxObject;
interface nsITreeColumn;
#include "nsISupports.idl"
[scriptable, uuid(ab6fe746-300b-4ab4-abb9-1c0e3977874c)]
interface nsITreeSelection : nsISupports
{
/**
* The tree widget for this selection.
*/
attribute nsITreeBoxObject tree;
/**
* This attribute is a boolean indicating single selection.
*/
readonly attribute boolean single;
/**
* The number of rows currently selected in this tree.
*/
readonly attribute long count;
/**
* Indicates whether or not the row at the specified index is
* part of the selection.
*/
boolean isSelected(in long index);
/**
* Deselect all rows and select the row at the specified index.
*/
void select(in long index);
/**
* Perform a timed select.
*/
void timedSelect(in long index, in long delay);
/**
* Toggle the selection state of the row at the specified index.
*/
void toggleSelect(in long index);
/**
* Select the range specified by the indices. If augment is true,
* then we add the range to the selection without clearing out anything
* else. If augment is false, everything is cleared except for the specified range.
*/
void rangedSelect(in long startIndex, in long endIndex, in boolean augment);
/**
* Clears the range.
*/
void clearRange(in long startIndex, in long endIndex);
/**
* Clears the selection.
*/
void clearSelection();
/**
* Inverts the selection.
*/
void invertSelection();
/**
* Selects all rows.
*/
void selectAll();
/**
* Iterate the selection using these methods.
*/
long getRangeCount();
void getRangeAt(in long i, out long min, out long max);
/**
* Can be used to invalidate the selection.
*/
void invalidateSelection();
/**
* Called when the row count changes to adjust selection indices.
*/
void adjustSelection(in long index, in long count);
/**
* 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, e.g., on
* a sort.
* Note: setting this attribute to false will fire a select event.
*/
attribute boolean selectEventsSuppressed;
/**
* The current item (the one that gets a focus rect in addition to being
* selected).
*/
attribute long currentIndex;
/**
* The current column.
*/
attribute nsITreeColumn currentColumn;
/**
* The selection "pivot". This is the first item the user selected as
* part of a ranged select.
*/
readonly attribute long shiftSelectPivot;
};
/**
* The following interface is not scriptable and MUST NEVER BE MADE scriptable.
* Native treeselections implement it, and we use this to check whether a
* treeselection is native (and therefore suitable for use by untrusted content).
*/
[uuid(1bd59678-5cb3-4316-b246-31a91b19aabe)]
interface nsINativeTreeSelection : nsITreeSelection
{
[noscript] void ensureNative();
};
|