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
|
package com.explodingpixels.macwidgets;
/**
* An interface for listening for expansion events.
* It handles expansion events for both {@link SourceListItem} and {@link SourceListCategory}.
*/
public interface SourceListExpansionListener {
/**
* Called before expanding a {@link SourceListItem} in a {@link SourceList}.
* Determines whether an item is allowed to be expanded or not
* @param item the item that requests to be expanded.
* @return true if the item is expandable, false otherwise
*/
boolean shouldExpandSourceListItem(SourceListItem item);
/**
* Called when a {@link SourceListItem} is expanded in a {@link SourceList}.
* The method will only be called if {@link SourceListExpansionListener#shouldExpandSourceListItem(SourceListItem)}
* returns true.
* @param item the item that was expanded.
*/
void sourceListItemExpanded(SourceListItem item);
/**
* Called before collapsing a {@link SourceListItem} in a {@link SourceList}.
* Determines whether an item is allowed to be collapsed or not
* @param item the item that requests to be collapsed.
* @return true if the item is collapsable, false otherwise
*/
boolean shouldCollapseSourceListItem(SourceListItem item);
/**
* Called when a {@link SourceListItem} is collapsed in a {@link SourceList}.
* The method will only be called if {@link SourceListExpansionListener#shouldCollapseSourceListItem(SourceListItem)}
* returns true.
* @param item the item that was collapsed.
*/
void sourceListItemCollapsed(SourceListItem item);
/**
* Called before expanding a {@link SourceListCategory} in a {@link SourceList}.
* Determines whether a category is allowed to be expanded or not
* @param category the category that requests to be expanded.
* @return true if the item is expandable, false otherwise
*/
boolean shouldExpandSourceListCategory(SourceListCategory category);
/**
* Called when a {@link SourceListCategory} is expanded in a {@link SourceList}.
* The method will only be called if {@link SourceListExpansionListener#shouldExpandSourceListCategory(SourceListCategory)}
* returns true.
* @param category the category that was expanded.
*/
void sourceListCategoryExpanded(SourceListCategory category);
/**
* Called before collapsing a {@link SourceListCategory} in a {@link SourceList}.
* Determines whether a category is allowed to be collapsed or not
* @param category the category that requests to be collapsed.
* @return true if the item is collapsable, false otherwise
*/
boolean shouldToCollapseSourceListCategory(SourceListCategory category);
/**
* Called when a {@link SourceListCategory} is collapsed in a {@link SourceList}.
* The method will only be called if {@link SourceListExpansionListener#shouldToCollapseSourceListCategory(SourceListCategory)}
* returns true.
* @param category the category that was collapsed.
*/
void sourceListCategoryCollapsed(SourceListCategory category);
}
|
