[[TreeView Widget]] Mobile Support Enhancements (#7154)

bwmilby · livecodeali · commit 82387c6c07bf · 2019-11-28T10:16:52.000Z
* Adjust row height to reflect font size changes
* Add charsToTrimFromKey property - this allows custom key sort display by removing a set number of characters from each key when rendering the widget.  The array needs to be configured with characters prepended to each key that will sort in the desired order.
* Add hilitedElementIsFolded property - this can be used to adjust the fold state of the selected element.
* Add scroller support and custom text height - added `formattedHeight` property and `scroll` property (also includes `vScroll`) and `formattedHeightChanged` message
* Add `textHeight` property - this allows for changing the default height of a row to a custom value instead of using what would be calculated.
* Clear hilitedElement bug fix - If no element was selected, setting the hilitedElement to empty would throw an error.  Added an additional test to ensure that the widget did
not attempt to unselect and empty path.
* Add vScrollbar property
* Add showHover property - this allows the hover shading to be disabled. This is useful on mobile where the hover is not something that makes sense in that UI.
* Save `alternate row backgrounds` property which was not being saved/restored.
* Add iconHeight property - allows the setting of the size of the icons displayed in the widget.
* Handle font changes and improve trimming logic
  - When the font size changes, re-evaluate the width of the ellipsis.
  - When the font name changes, re-evaluate the width of the ellipsis.
  - When in readOnly mode, only save space for one icon on the right.
  - If full string displayed, remove ellipsis length from the returned width.
  - `displayWidth` was reporting the incorrect width when a string was being trimmed.  Keep track of the previous width to return a proper value.
  - Prevent the last character (key/value) from being turned into an ellipsis.
  - Remove padding from ellipsis width calculation.  Only add padding in when looking at a key where a value also exists.  No need to save space for an ellipsis and padding otherwise.
* Save `show border` property
* Add `showValues` property
diff --git a/extensions/widgets/treeview/notes/21719.md b/extensions/widgets/treeview/notes/21719.md
@@ -0,0 +1 @@
+# [21719] Allow setting fold state of selected element
diff --git a/extensions/widgets/treeview/notes/22386.md b/extensions/widgets/treeview/notes/22386.md
@@ -0,0 +1 @@
+# [22386] Save `alternate row backgrounds` property
diff --git a/extensions/widgets/treeview/notes/22387.md b/extensions/widgets/treeview/notes/22387.md
@@ -0,0 +1 @@
+# [22387] Save `showBorder` property
diff --git a/extensions/widgets/treeview/notes/feature-mobile_support.md b/extensions/widgets/treeview/notes/feature-mobile_support.md
@@ -0,0 +1,29 @@
+# Properties
+
+Enhance the Tree View Widget to support use on the mobile platform.
+
+* Adjust row height when font name or size changes
+* Trimming improvements
+    * When font name or size changes, re-evaluate ellipsis width to properly trim contents of keys/values
+    * In `readOnly` mode, only save space for a single icon on the right
+    * Prevent last character from being turned into an ellipsis
+    * Width was being reported with extra space for an ellipsis when not needed
+    * Remove padding from ellipsis width, only add padding when needed
+* Save `alternate row backgrounds` property
+* Save `show border` property
+
+New properties:
+
+* `charsToTrimFromKey` - allow a sorting value to be added to the front of the key that is trimmed for display
+* `hilitedElementIsFolded` - adjust the fold state of the selected element
+* `formattedHeight` - content height for scroller support
+* `scroll` and `vScroll` - scroll position
+* `textHeight` - custom row height
+* `vScrollBar` - control visibility of scroll bar
+* `showHover` - allow hover to be disabled, useful on mobile
+* `iconHeight` - allow configuration of icon size
+* `showValues` - allow the values to be hidden
+
+# Signals
+
+* `formattedHeightChanged` - message to report content height change to support scrollers
diff --git a/extensions/widgets/treeview/treeview.lcb b/extensions/widgets/treeview/treeview.lcb

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+# [21719] Allow setting fold state of selected element`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+# [22386] Save `alternate row backgrounds` property