Difference between revisions of "VirtualTreeview"

From Lazarus wiki
(Categorized.)
(11 intermediate revisions by 5 users not shown)
Line 2: Line 2:
  
 
=== About ===
 
=== About ===
VirtualTreeview is a treeview control built from ground up.
+
VirtualTreeview is a [[TTreeView]] control built from ground up.
  
 
Its main characteristics are :
 
Its main characteristics are :
Line 32: Line 32:
 
   
 
   
 
=== Download ===
 
=== Download ===
The new releases can be found at
+
See the project [https://github.com/blikblum/VirtualTreeView-Lazarus/releases releases page]
[http://sourceforge.net/projects/lazarus-ccr/files/VirtualTreeView%20(New%20Port) Lazarus CCR]
 
  
The old releases can be found at [http://sourceforge.net/projects/lazarus-ccr/files/Virtual%20Treeview/ Lazarus CCR].
+
Note that v5.5.3.1 is included in Lazarus v2.0+, there is not need for a separate download.
  
=== SVN ===
+
=== Repository ===
you can checkout the actual source from<br>
+
You can checkout the source code from [https://github.com/blikblum/VirtualTreeView-Lazarus GitHub]
  
https://lazarus-ccr.svn.sourceforge.net/svnroot/lazarus-ccr/components/virtualtreeview-new/
+
It's possible to use both Subversion and Git clients
  
commandline to do this is
+
Subversion:
 +
svn co https://github.com/blikblum/VirtualTreeView-Lazarus/branches/lazarus-v5
  
svn co https://lazarus-ccr.svn.sourceforge.net/svnroot/lazarus-ccr/components/virtualtreeview-new/
+
Replace lazarus_v5 by lazarus_v4 or lazarus_master to get a different version. For more info how to use Subversion, see [https://help.github.com/articles/support-for-subversion-clients/ GitHub help]
 +
 
 +
Git:
 +
git clone https://github.com/blikblum/VirtualTreeView-Lazarus.git
  
 
=== Bug report / Feature request ===
 
=== Bug report / Feature request ===
  
[http://bugs.freepascal.org Bug Tracker] project Lazarus-CCR, category Virtual Treeview
+
[https://github.com/blikblum/VirtualTreeView-Lazarus/issues Here]
 +
 
 +
For patches / pull requests, [https://github.com/blikblum/VirtualTreeView-Lazarus/pulls here]. Newcomers to GitHub may want to read the [https://help.github.com/articles/using-pull-requests/ help]
  
 
=== Change Log ===
 
=== Change Log ===
 +
* 02/06/2016 - [http://forum.lazarus.freepascal.org/index.php?topic=32856.0 4.8.7 R4 and 5.5.3 R1] - First release of 5x branch + moved to GitHub
 
* 20/10/2012 - [http://www.lazarus.freepascal.org/index.php/topic,18640.0.html 4.8.7 LCL R2] - Compatibility with Lazarus 1.0 + 64 bit support
 
* 20/10/2012 - [http://www.lazarus.freepascal.org/index.php/topic,18640.0.html 4.8.7 LCL R2] - Compatibility with Lazarus 1.0 + 64 bit support
 
* 18/02/2011 - [http://www.lazarus.freepascal.org/index.php/topic,12172.msg62067.html 4.8.7 LCL R1] - Sync with 4.8 branch + misc fixes
 
* 18/02/2011 - [http://www.lazarus.freepascal.org/index.php/topic,12172.msg62067.html 4.8.7 LCL R1] - Sync with 4.8 branch + misc fixes
Line 56: Line 62:
  
 
=== Dependencies / System Requirements ===
 
=== Dependencies / System Requirements ===
* FPC 2.6.x
+
Versions 4.x or 5.x
* Lazarus 1.0 or newer
 
* LCL Extensions 0.5 (http://code.google.com/p/luipack/downloads/list)
 
  
Status: Stable
+
*Lazarus 1.6 or newer
Tested on Windows, Linux.
+
*fpc 2.6.4 or newer
Needs testing on MacOS.  
+
*LCL Extensions 0.6 or newer
  
==== Known Issues ====
+
Version 6.x (lazarus_master branch)
* The scroll bar does not work on OSX 10.8.6. See forum post about branch 4.8: http://www.lazarus.freepascal.org/index.php/topic,12172.0.html
+
 
 +
*Lazarus 1.6 or newer
 +
*fpc 3.1 (trunk) or newer
 +
*LCL Extensions 0.6 or newer
  
 
=== Installation ===
 
=== Installation ===
 
* If new to Lazarus, read [[Install Packages]]
 
* If new to Lazarus, read [[Install Packages]]
* Extract the LCL Extensions package to a directory (lazarus\components\lclextensions or other of your preference)
+
* Lazarus v2.0: The lclextensions and virtualtreeview packages are contained in the standard distribution of Lazarus because they are needed by the OnlinePackageManager. Go to "Package" > "Install/uninstall packages", select "virtualtreeview_package 5.5.3.1" in the right list, click "Install selection", then "Save and rebuild IDE".
* Extract the Virtual Treeview package to a directory (lazarus\components\virtualtreeview or other of your preference)
+
* Lazarus v2.2+ (or trunk): Like above, but the package and all units have been renamed to have a "laz." prefix, e.g. "laz.virtualtreeview_package" instead of "virtualtreeview_package" and "laz.virtualtrees" instead of "virtualtrees". The names of the registered components also begin with "Laz", e.g. "TLazVirtualStringTree" instead of "TVirtualStringTree". This was made to avoid a naming conflict when the user wants to install another version of VTV in addition to the built-in one.
* Open lclextensions_package.lpk in LCL Extensions directory and click "Use / Add to project"
+
* Lazarus before v2.0, or VTV version other than v5.5.3.1 (in Laz v2.0 you will have to uninstall the built-in version first):
* Open virtualtreeview_package.lpk in Virtual Treeview and click "Use / Install". Rebuild the IDE
+
** Download the LCL Extensions package and extract it to a directory (lazarus\components\lclextensions or other of your preference).
 +
** Download the Virtual Treeview package and extract it to a directory (lazarus\components\virtualtreeview or other of your preference).
 +
** Open lclextensions_package.lpk in LCL Extensions directory and click "Use / Add to project"
 +
** Open virtualtreeview_package.lpk in Virtual Treeview and click "Use / Install". Rebuild the IDE.
  
 
=== Help ===
 
=== Help ===
 
 
Can be found at [http://www.soft-gems.net/index.php/controls/virtual-treeview VirtualTreeview Main Page] (search for ''help in chm format'').
 
Can be found at [http://www.soft-gems.net/index.php/controls/virtual-treeview VirtualTreeview Main Page] (search for ''help in chm format'').
  
 
Example code can be found here: [[VirtualTreeview Example for Lazarus]]
 
Example code can be found here: [[VirtualTreeview Example for Lazarus]]
 +
 +
== See also ==
 +
* [[TTreeView]]
  
 
[[Category:Components]]
 
[[Category:Components]]
 
[[Category:Lazarus]]
 
[[Category:Lazarus]]
 
[[Category:Lazarus-CCR]]
 
[[Category:Lazarus-CCR]]

Revision as of 02:40, 17 November 2020

Deutsch (de) English (en) español (es) français (fr) polski (pl)

About

VirtualTreeview is a TTreeView control built from ground up.

Its main characteristics are :

  • it is extremely fast. Adding one million nodes takes only ~700 milliseconds
  • very small memory foot print. by only allocating about 60 bytes per node
  • optimized for high speed access. It takes as few as 0.5 seconds to traverse one million nodes
  • Multiselection is supported
  • Drawing the entire tree to a bitmap or the printer is supported
  • fixed background image can be used
  • Hot style for nodes is supported
  • Nodes can have individual heights
  • Sorting via compare callback
  • Support for unicode
  • Multiple columns are supported
  • ... and many more

This component was designed for cross-platform applications.

Anivt.gif

Author

Author: Mike Lischke
Old LCL Port: Joerg Thaler,Christian Ulrich
New LCL Port: Luiz Américo

License

LGPL or Mozilla Public Licence 1.1

Download

See the project releases page

Note that v5.5.3.1 is included in Lazarus v2.0+, there is not need for a separate download.

Repository

You can checkout the source code from GitHub

It's possible to use both Subversion and Git clients

Subversion:

svn co https://github.com/blikblum/VirtualTreeView-Lazarus/branches/lazarus-v5

Replace lazarus_v5 by lazarus_v4 or lazarus_master to get a different version. For more info how to use Subversion, see GitHub help

Git:

git clone https://github.com/blikblum/VirtualTreeView-Lazarus.git

Bug report / Feature request

Here

For patches / pull requests, here. Newcomers to GitHub may want to read the help

Change Log

  • 02/06/2016 - 4.8.7 R4 and 5.5.3 R1 - First release of 5x branch + moved to GitHub
  • 20/10/2012 - 4.8.7 LCL R2 - Compatibility with Lazarus 1.0 + 64 bit support
  • 18/02/2011 - 4.8.7 LCL R1 - Sync with 4.8 branch + misc fixes
  • 11/02/2010 - 4.8.6 - First stable release of the new port

Dependencies / System Requirements

Versions 4.x or 5.x

  • Lazarus 1.6 or newer
  • fpc 2.6.4 or newer
  • LCL Extensions 0.6 or newer

Version 6.x (lazarus_master branch)

  • Lazarus 1.6 or newer
  • fpc 3.1 (trunk) or newer
  • LCL Extensions 0.6 or newer

Installation

  • If new to Lazarus, read Install Packages
  • Lazarus v2.0: The lclextensions and virtualtreeview packages are contained in the standard distribution of Lazarus because they are needed by the OnlinePackageManager. Go to "Package" > "Install/uninstall packages", select "virtualtreeview_package 5.5.3.1" in the right list, click "Install selection", then "Save and rebuild IDE".
  • Lazarus v2.2+ (or trunk): Like above, but the package and all units have been renamed to have a "laz." prefix, e.g. "laz.virtualtreeview_package" instead of "virtualtreeview_package" and "laz.virtualtrees" instead of "virtualtrees". The names of the registered components also begin with "Laz", e.g. "TLazVirtualStringTree" instead of "TVirtualStringTree". This was made to avoid a naming conflict when the user wants to install another version of VTV in addition to the built-in one.
  • Lazarus before v2.0, or VTV version other than v5.5.3.1 (in Laz v2.0 you will have to uninstall the built-in version first):
    • Download the LCL Extensions package and extract it to a directory (lazarus\components\lclextensions or other of your preference).
    • Download the Virtual Treeview package and extract it to a directory (lazarus\components\virtualtreeview or other of your preference).
    • Open lclextensions_package.lpk in LCL Extensions directory and click "Use / Add to project"
    • Open virtualtreeview_package.lpk in Virtual Treeview and click "Use / Install". Rebuild the IDE.

Help

Can be found at VirtualTreeview Main Page (search for help in chm format).

Example code can be found here: VirtualTreeview Example for Lazarus

See also