Documentation
🏃♂️ ColinTreeListView
An extension for MIT App Inventor 2.
Specifications
Package: cn.colintree.aix.colintreelistview
Size: 38.55 KB
Minimum API Level: 14
Updated On: 2026-01-28T18:30:00Z
Help URL: Learn more
Built & documented using: FAST v5.4.0
Multi-Components
- ColinTreeListView
- ColinTreeListViewElement
ColinTreeListView
Component for ColinTreeListView
Events:
ColinTreeListView has total 12 events.
1. ElementClick
Event triggered when an element is clicked.
| Parameter |
Type |
| elementIndex |
number |
2. ElementLongClick
Event triggered when an element is long clicked.
| Parameter |
Type |
| elementIndex |
number |
3. ElementTouchDown
Event triggered when an element touch down occurs.
| Parameter |
Type |
| elementIndex |
number |
4. ElementTouchUp
Event triggered when an element touch up occurs.
| Parameter |
Type |
| elementIndex |
number |
5. IconClick
Event triggered when an icon is clicked.
| Parameter |
Type |
| elementIndex |
number |
6. IconLongClick
Event triggered when an icon is long clicked.
| Parameter |
Type |
| elementIndex |
number |
7. IconTouchDown
Event triggered when an icon touch down occurs.
| Parameter |
Type |
| elementIndex |
number |
8. IconTouchUp
Event triggered when an icon touch up occurs.
| Parameter |
Type |
| elementIndex |
number |
9. ExtraButtonClick
Event triggered when the extra button is clicked.
| Parameter |
Type |
| elementIndex |
number |
10. ExtraButtonLongClick
Event triggered when the extra button is long clicked.
| Parameter |
Type |
| elementIndex |
number |
11. ExtraButtonTouchDown
Event triggered when the extra button touch down occurs.
| Parameter |
Type |
| elementIndex |
number |
12. ExtraButtonTouchUp
Event triggered when the extra button touch up occurs.
| Parameter |
Type |
| elementIndex |
number |
Methods:
ColinTreeListView has total 16 methods.
1. Initialize
Initialize the list view with a VerticalArrangement.
| Parameter |
Type |
| verticalArrangement |
component |
2. InitializeScroll
Initialize the list view with a VerticalScrollArrangement.
| Parameter |
Type |
| verticalScrollArrangement |
component |
3. Clear
Clears all elements from the list view.
4. Set
Sets the entire list view content from a list of elements.
5. Get
Returns the current list of elements.
6. AddElement
Adds a new element to the list view.
| Parameter |
Type |
| element |
list |
7. AddEmptyElement
Adds an empty element to the list view.
8. SetElement
Sets the content of an existing element.
| Parameter |
Type |
| elementIndex |
number |
| element |
list |
9. SetElementText
Sets the text of an element.
| Parameter |
Type |
| elementIndex |
number |
| text |
text |
10. SetElementMainText
Sets the main text of an element (for 3-parameter elements).
| Parameter |
Type |
| elementIndex |
number |
| mainText |
text |
11. SetElementSubText
Sets the sub text of an element (for 3-parameter elements).
| Parameter |
Type |
| elementIndex |
number |
| subText |
text |
12. SetElementIcon
Sets the icon of an element.
| Parameter |
Type |
| elementIndex |
number |
| path |
text |
13. GetElement
Gets the content of an element as a list.
| Parameter |
Type |
| elementIndex |
number |
14. RemoveElement
Removes an element from the list view.
| Parameter |
Type |
| elementIndex |
number |
15. ClearAllCache
Clears all cached images from memory.
16. ClearCache
Clears a specific cached image from memory.
Designer:
ColinTreeListView has total 37 designer properties.
1. ElementHeight
- Input type:
non_negative_integer
- Default value:
57
2. TouchDownColor
- Input type:
color
- Default value:
000000
3. WidthBeforeIcon
- Input type:
non_negative_integer
- Default value:
7
4. WidthAfterIcon
- Input type:
non_negative_integer
- Default value:
5
5. IconWidth
- Input type:
non_negative_integer
- Default value:
40
6. IconHeight
- Input type:
non_negative_integer
- Default value:
40
7. IconShape
- Input type:
button_shape
- Default value:
1
8. IconBgColor
- Input type:
color
- Default value:
000000
9. IconTextColor
- Input type:
color
- Default value:
000000
10. IconTextFontSize
- Input type:
non_negative_float
- Default value:
24
11. IconTextFontBold
- Input type:
boolean
- Default value:
True
12. IconMultiParams
- Input type:
boolean
- Default value:
False
13. IconPaddings
- Input type:
non_negative_integer
- Default value:
0
14. TextColor
- Input type:
color
- Default value:
000000
15. TextFontSize
- Input type:
non_negative_float
- Default value:
14
16. TextFontBold
- Input type:
boolean
- Default value:
False
17. TextHeight
- Input type:
non_negative_integer
- Default value:
18
18. SubTextColor
- Input type:
color
- Default value:
CCCCCC
19. SubTextFontSize
- Input type:
non_negative_float
- Default value:
12
20. SubTextFontBold
- Input type:
boolean
- Default value:
False
21. SubTextHeight
- Input type:
non_negative_integer
- Default value:
18
22. WidthBeforeExtraButton
- Input type:
non_negative_integer
- Default value:
2
23. ExtraButtonText
24. ExtraButtonTextFontSize
- Input type:
non_negative_float
- Default value:
12
25. ExtraButtonTextFontBold
- Input type:
boolean
- Default value:
False
26. ExtraButtonWidth
- Input type:
non_negative_integer
- Default value:
20
27. ExtraButtonHeight
- Input type:
non_negative_integer
- Default value:
20
28. ExtraButtonPaddings
- Input type:
non_negative_integer
- Default value:
0
29. ExtraButtonBgColor
- Input type:
color
- Default value:
CCCCCC
30. ExtraButtonShape
- Input type:
button_shape
- Default value:
3
31. ExtraButtonImage
32. UnderlineColor
- Input type:
color
- Default value:
CCCCCC
33. UnderlineWidth
- Input type:
non_negative_integer
- Default value:
1
34. ScrollBottomAfterAdd
- Input type:
boolean
- Default value:
False
35. AsyncImageLoad
- Input type:
boolean
- Default value:
False
36. CacheImage
- Input type:
boolean
- Default value:
False
37. ExtraButtonEnabled
- Input type:
boolean
- Default value:
False
Setters:
ColinTreeListView has total 37 setter properties.
1. ElementHeight
Gets the height of each element in pixels.
2. TouchDownColor
Gets the touch down color of elements.
3. WidthBeforeIcon
Gets the width before the icon.
4. WidthAfterIcon
Gets the width after the icon.
5. IconWidth
Gets the icon width.
6. IconHeight
Gets the icon height.
7. IconShape
Gets the icon shape.
8. IconBgColor
Gets the icon background color.
9. IconTextColor
Gets the icon text color.
10. IconTextFontSize
Gets the icon text font size.
11. IconTextFontBold
Gets whether icon text is bold.
12. IconMultiParams
Gets whether icon uses multiple parameters.
13. IconPaddings
Gets the icon paddings.
14. TextColor
Gets the text color.
15. TextFontSize
Gets the text font size.
16. TextFontBold
Gets whether text is bold.
17. TextHeight
Gets the text height.
18. SubTextColor
Gets the subtext color.
19. SubTextFontSize
Gets the subtext font size.
20. SubTextFontBold
Gets whether subtext is bold.
21. SubTextHeight
Gets the subtext height.
22. WidthBeforeExtraButton
Gets the width before extra button.
23. ExtraButtonText
Gets the extra button text.
24. ExtraButtonTextFontSize
Gets the extra button text font size.
25. ExtraButtonTextFontBold
Gets whether extra button text is bold.
26. ExtraButtonWidth
Gets the extra button width.
27. ExtraButtonHeight
Gets the extra button height.
28. ExtraButtonPaddings
Gets the extra button paddings.
29. ExtraButtonBgColor
Gets the extra button background color.
30. ExtraButtonShape
Gets the extra button shape.
31. ExtraButtonImage
Gets the extra button image.
32. UnderlineColor
Gets the underline color.
33. UnderlineWidth
Gets the underline width.
34. ScrollBottomAfterAdd
Gets whether to scroll to bottom after adding elements.
35. AsyncImageLoad
Gets whether to load images asynchronously.
36. CacheImage
Gets whether to cache images.
37. ExtraButtonEnabled
Gets whether extra button is enabled.
Getters:
ColinTreeListView has total 41 getter properties.
1. LastClickedElement
Returns the index of the last clicked element.
2. LastLongClickedElement
Returns the index of the last long clicked element.
3. LastClickedIcon
Returns the index of the last clicked icon.
4. LastClickedExtraButton
Returns the index of the last clicked extra button.
5. ElementHeight
Gets the height of each element in pixels.
6. TouchDownColor
Gets the touch down color of elements.
7. WidthBeforeIcon
Gets the width before the icon.
8. WidthAfterIcon
Gets the width after the icon.
9. IconWidth
Gets the icon width.
10. IconHeight
Gets the icon height.
11. IconShape
Gets the icon shape.
12. IconBgColor
Gets the icon background color.
13. IconTextColor
Gets the icon text color.
14. IconTextFontSize
Gets the icon text font size.
15. IconTextFontBold
Gets whether icon text is bold.
16. IconMultiParams
Gets whether icon uses multiple parameters.
17. IconPaddings
Gets the icon paddings.
18. TextColor
Gets the text color.
19. TextFontSize
Gets the text font size.
20. TextFontBold
Gets whether text is bold.
21. TextHeight
Gets the text height.
22. SubTextColor
Gets the subtext color.
23. SubTextFontSize
Gets the subtext font size.
24. SubTextFontBold
Gets whether subtext is bold.
25. SubTextHeight
Gets the subtext height.
26. WidthBeforeExtraButton
Gets the width before extra button.
27. ExtraButtonText
Gets the extra button text.
28. ExtraButtonTextFontSize
Gets the extra button text font size.
29. ExtraButtonTextFontBold
Gets whether extra button text is bold.
30. ExtraButtonWidth
Gets the extra button width.
31. ExtraButtonHeight
Gets the extra button height.
32. ExtraButtonPaddings
Gets the extra button paddings.
33. ExtraButtonBgColor
Gets the extra button background color.
34. ExtraButtonShape
Gets the extra button shape.
35. ExtraButtonImage
Gets the extra button image.
36. UnderlineColor
Gets the underline color.
37. UnderlineWidth
Gets the underline width.
38. ScrollBottomAfterAdd
Gets whether to scroll to bottom after adding elements.
39. AsyncImageLoad
Gets whether to load images asynchronously.
40. CacheImage
Gets whether to cache images.
41. ExtraButtonEnabled
Gets whether extra button is enabled.
ColinTreeListViewElement
Component for ColinTreeListViewElement
Methods:
ColinTreeListViewElement has total 72 methods.
1. LinkToElement
Method for LinkToElement
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
2. ElementValue_
Method for ElementValue_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| value |
list |
3. ElementValue
Method for ElementValue
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
4. IconImage_
Method for IconImage_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| value |
text |
5. IconImage
Method for IconImage
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
6. ExtraButtonImage_
Method for ExtraButtonImage_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| value |
text |
7. ExtraButtonImage
Method for ExtraButtonImage
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
8. Text_
Method for Text_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| text |
text |
9. Text
Method for Text
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
10. SubText_
Method for SubText_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| subtext |
text |
11. SubText
Method for SubText
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
12. Size
Method for Size
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
13. UseGlobalProperties_
Method for UseGlobalProperties_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| useGlobal |
boolean |
14. UseGlobalProperties
Method for UseGlobalProperties
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
15. ElementBackgroundColor
Method for ElementBackgroundColor
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
16. ElementBackgroundColor_
Method for ElementBackgroundColor_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| argb |
number |
17. ElementHeight
Method for ElementHeight
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
18. ElementHeight_
Method for ElementHeight_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| height |
number |
19. WidthBeforeIcon
Method for WidthBeforeIcon
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
20. WidthBeforeIcon_
Method for WidthBeforeIcon_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| width |
number |
21. WidthAfterIcon
Method for WidthAfterIcon
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
22. WidthAfterIcon_
Method for WidthAfterIcon_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| width |
number |
23. IconWidth
Method for IconWidth
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
24. IconWidth_
Method for IconWidth_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| width |
number |
25. IconHeight
Method for IconHeight
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
26. IconHeight_
Method for IconHeight_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| height |
number |
27. IconShape
Method for IconShape
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
28. IconShape_
Method for IconShape_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| shape |
number |
29. IconBackgroundColor
Method for IconBackgroundColor
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
30. IconBackgroundColor_
Method for IconBackgroundColor_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| argb |
number |
31. IconTextColor
Method for IconTextColor
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
32. IconTextColor_
Method for IconTextColor_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| argb |
number |
33. IconTextFontSize
Method for IconTextFontSize
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
34. IconTextFontSize_
Method for IconTextFontSize_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| size |
number |
35. IconTextFontBold
Method for IconTextFontBold
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
36. IconTextFontBold_
Method for IconTextFontBold_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| bold |
boolean |
37. TextColor
Method for TextColor
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
38. TextColor_
Method for TextColor_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| argb |
number |
39. TextFontSize
Method for TextFontSize
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
40. TextFontSize_
Method for TextFontSize_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| size |
number |
41. TextFontBold
Method for TextFontBold
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
42. TextFontBold_
Method for TextFontBold_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| bold |
boolean |
43. TextHeight
Method for TextHeight
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
44. TextHeight_
Method for TextHeight_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| height |
number |
45. SubTextColor
Method for SubTextColor
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
46. SubTextColor_
Method for SubTextColor_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| argb |
number |
47. SubTextFontSize
Method for SubTextFontSize
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
48. SubTextFontSize_
Method for SubTextFontSize_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| size |
number |
49. SubTextFontBold
Method for SubTextFontBold
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
50. SubTextFontBold_
Method for SubTextFontBold_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| bold |
boolean |
51. SubTextHeight
Method for SubTextHeight
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
52. SubTextHeight_
Method for SubTextHeight_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| height |
number |
53. WidthBeforeExtraButton
Method for WidthBeforeExtraButton
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
54. WidthBeforeExtraButton_
Method for WidthBeforeExtraButton_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| width |
number |
55. ExtraButtonText
Method for ExtraButtonText
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
56. ExtraButtonText_
Method for ExtraButtonText_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| text |
text |
57. ExtraButtonTextFontSize
Method for ExtraButtonTextFontSize
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
58. ExtraButtonTextFontSize_
Method for ExtraButtonTextFontSize_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| size |
number |
59. ExtraButtonTextFontBold
Method for ExtraButtonTextFontBold
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
60. ExtraButtonTextFontBold_
Method for ExtraButtonTextFontBold_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| bold |
boolean |
61. ExtraButtonWidth
Method for ExtraButtonWidth
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
62. ExtraButtonWidth_
Method for ExtraButtonWidth_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| width |
number |
63. ExtraButtonHeight
Method for ExtraButtonHeight
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
64. ExtraButtonHeight_
Method for ExtraButtonHeight_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| height |
number |
65. ExtraButtonBackgroundColor
Method for ExtraButtonBackgroundColor
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
66. ExtraButtonBackgroundColor_
Method for ExtraButtonBackgroundColor_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| argb |
number |
67. ExtraButtonShape
Method for ExtraButtonShape
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
68. ExtraButtonShape_
Method for ExtraButtonShape_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| shape |
number |
69. UnderlineColor
Method for UnderlineColor
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
70. UnderlineColor_
Method for UnderlineColor_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| argb |
number |
71. UnderlineWidth
Method for UnderlineWidth
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
72. UnderlineWidth_
Method for UnderlineWidth_
| Parameter |
Type |
| listview |
component |
| elementIndex |
number |
| lineWidth |
number |
Setters:
ColinTreeListViewElement has total 35 setter properties.
1. ElementValue
Property for ElementValue
2. IconImage
Property for IconImage
3. ExtraButtonImage
Property for ExtraButtonImage
4. Text
Property for Text
5. SubText
Property for SubText
6. UseGlobalProperties
Property for UseGlobalProperties
7. ElementBackgroundColor
Property for ElementBackgroundColor
8. ElementHeight
Property for ElementHeight
9. WidthBeforeIcon
Property for WidthBeforeIcon
10. WidthAfterIcon
Property for WidthAfterIcon
11. IconWidth
Property for IconWidth
12. IconHeight
Property for IconHeight
13. IconShape
Property for IconShape
14. IconBackgroundColor
Property for IconBackgroundColor
15. IconTextColor
Property for IconTextColor
16. IconTextFontSize
Property for IconTextFontSize
17. IconTextFontBold
Property for IconTextFontBold
18. TextColor
Property for TextColor
19. TextFontSize
Property for TextFontSize
20. TextFontBold
Property for TextFontBold
21. TextHeight
Property for TextHeight
22. SubTextColor
Property for SubTextColor
23. SubTextFontSize
Property for SubTextFontSize
24. SubTextFontBold
Property for SubTextFontBold
25. SubTextHeight
Property for SubTextHeight
26. WidthBeforeExtraButton
Property for WidthBeforeExtraButton
27. ExtraButtonText
Property for ExtraButtonText
28. ExtraButtonTextFontSize
Property for ExtraButtonTextFontSize
29. ExtraButtonTextFontBold
Property for ExtraButtonTextFontBold
30. ExtraButtonWidth
Property for ExtraButtonWidth
31. ExtraButtonHeight
Property for ExtraButtonHeight
32. ExtraButtonBackgroundColor
Property for ExtraButtonBackgroundColor
33. ExtraButtonShape
Property for ExtraButtonShape
34. UnderlineColor
Property for UnderlineColor
35. UnderlineWidth
Property for UnderlineWidth
Getters:
ColinTreeListViewElement has total 36 getter properties.
1. ElementValue
Property for ElementValue
2. IconImage
Property for IconImage
3. ExtraButtonImage
Property for ExtraButtonImage
4. Text
Property for Text
5. SubText
Property for SubText
6. Size
Property for Size
7. UseGlobalProperties
Property for UseGlobalProperties
8. ElementBackgroundColor
Property for ElementBackgroundColor
9. ElementHeight
Property for ElementHeight
10. WidthBeforeIcon
Property for WidthBeforeIcon
11. WidthAfterIcon
Property for WidthAfterIcon
12. IconWidth
Property for IconWidth
13. IconHeight
Property for IconHeight
14. IconShape
Property for IconShape
15. IconBackgroundColor
Property for IconBackgroundColor
16. IconTextColor
Property for IconTextColor
17. IconTextFontSize
Property for IconTextFontSize
18. IconTextFontBold
Property for IconTextFontBold
19. TextColor
Property for TextColor
20. TextFontSize
Property for TextFontSize
21. TextFontBold
Property for TextFontBold
22. TextHeight
Property for TextHeight
23. SubTextColor
Property for SubTextColor
24. SubTextFontSize
Property for SubTextFontSize
25. SubTextFontBold
Property for SubTextFontBold
26. SubTextHeight
Property for SubTextHeight
27. WidthBeforeExtraButton
Property for WidthBeforeExtraButton
28. ExtraButtonText
Property for ExtraButtonText
29. ExtraButtonTextFontSize
Property for ExtraButtonTextFontSize
30. ExtraButtonTextFontBold
Property for ExtraButtonTextFontBold
31. ExtraButtonWidth
Property for ExtraButtonWidth
32. ExtraButtonHeight
Property for ExtraButtonHeight
33. ExtraButtonBackgroundColor
Property for ExtraButtonBackgroundColor
34. ExtraButtonShape
Property for ExtraButtonShape
35. UnderlineColor
Property for UnderlineColor
36. UnderlineWidth
Property for UnderlineWidth