https://github.com/jo-tools/treeview
Xojo example project: Tree View
https://github.com/jo-tools/treeview
control listbox xojo
Last synced: 7 months ago
JSON representation
Xojo example project: Tree View
- Host: GitHub
- URL: https://github.com/jo-tools/treeview
- Owner: jo-tools
- License: mit
- Created: 2022-03-09T21:47:39.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-15T16:14:41.000Z (10 months ago)
- Last Synced: 2025-03-15T16:34:13.296Z (10 months ago)
- Topics: control, listbox, xojo
- Language: Xojo
- Homepage: https://www.jo-tools.ch
- Size: 2.58 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Tree View
Xojo example project
[](LICENSE)
## Description
Hierarchical Listboxes are a bit tricky with Xojo. This example project shows
a reusable approach:
- A class named ```CTreeListedValues```.
This is basically a simple List with a couple of properties: ```name, hint, key, status, data, sublist```. The ```sublist``` is just another instance of a ```CTreeListedValues``` list, allowing you to build a hierarchical structure.
- A Control subclass ```lstTreeView```.
All the required "magic" in Xojo's Listbox is handled here.
You just need to assign your hierarchical ```CTreeListedValues``` list,
and this Subclass takes care of:
- Populate the Control to show the hierarchical data
- Expanding/collapsing logic *(all rows; just a single branch)* and
contextual menus
- Updates the ```CTreeListedValues``` list according to the current state
*(row expanded/collapsed; user requested to change a status of an entry)*
You can assign icons for all the item statuses you have. And the example shows how to change the status of the items by pressing a key and/or create a contextmenu (or do it in your code: modify the ```CTreeListedValues``` and update the Listbox).
### An example usage in a productive application
We fill a ```CTreeListedValues``` while scanning the differences between a database and a user's offline working-copy (file). The tree is then displayed to the user to show which items are going to get synchronized and in which direction (db -> file, db <- file). The user can interact if needed *(e.g. change the direction of some entries, or ignore a whole branch)*. Finally, the always updated ```CTreeListedValues``` *(such as confirmed and/or modified by the user)* are being used as the 'Task-list' for the main synchronization-task...
### ScreenShots
TreeView: Example app - macOS
TreeView: Example app - Windows
## Xojo
### Requirements
[Xojo](https://www.xojo.com/) is a rapid application development for Desktop, Web, Mobile & Raspberry Pi.
The Desktop application Xojo example project ```TreeView.xojo_project``` is using:
- Xojo 2024r4.2
- API 2
### How to use in your own Xojo project?
1. Copy and paste the folder ```treeview``` *(containing the classes ```CTreeListedValues``` and ```CTreeItem```, as well as the Listbox Subclass ```lstTreeView```)* to your project.
2. Place an instance of the ListBox subclass ```lstTreeView``` on a Window.
3. Have a look at how the example projects is using the provided Methods.
- Build and show a Tree: ```Window1.Tree_Setup```
- Handle Events: ```Window1.lstTree```
## About
Juerg Otter is a long term user of Xojo and working for [CM Informatik AG](https://cmiag.ch/). Their Application [CMI LehrerOffice](https://cmi-bildung.ch/) is a Xojo Design Award Winner 2018. In his leisure time Juerg provides some [bits and pieces for Xojo Developers](https://www.jo-tools.ch/).
### Contact
[](mailto:xojo@jo-tools.ch)
[](https://www.facebook.com/juerg.otter)
[](https://twitter.com/juergotter)
### Donation
Do you like this project? Does it help you? Has it saved you time and money?
You're welcome - it's free... If you want to say thanks I'd appreciate a [message](mailto:xojo@jo-tools.ch) or a small [donation via PayPal](https://paypal.me/jotools).
[](https://paypal.me/jotools)