Skip to main content

Overview

TeeTree can be used in two ways:
  1. Design-time installation - Install packages in the IDE for visual component access
  2. Code-only usage - Use TeeTree components programmatically without IDE installation
Installation is optional. You can use TeeTree entirely by code without installing any packages.

Code-Only Usage

To use TeeTree without installation, simply reference the units in your code:
uses
  TeeTree; // VCL version

var
  Tree1: TTree;
begin
  Tree1 := TTree.Create(Self);
  Tree1.Parent := Self;
  Tree1.Align := alClient;
end;

Design-Time Installation

Prerequisites

1

Determine Your TeeChart Version

TeeTree requires TeeChart. Check which version you have:
  • TeeChart Pro - Use packages in Sources/Packages/Pro
  • TeeChart Lite - Use packages in Sources/Packages/Lite (free version included with RAD Studio)
If you’re unsure, check if you have a licensed copy of TeeChart Pro. Otherwise, use the Lite packages.
2

Locate Package Files

Navigate to the appropriate folder:
Sources/Packages/Lite/TeeTree_Lite.groupproj
or
Sources/Packages/Pro/TeeTree_Pro.groupproj
3

Open Package Group

Open the .groupproj file in RAD Studio. You’ll see multiple packages:
  • Runtime packages (VCL and FMX)
  • DclVCL - VCL design-time package
  • DclFMX - FireMonkey design-time package
4

Install VCL Package

  1. Right-click the DclVCL package in Project Manager
  2. Select Install
  3. Wait for compilation and installation to complete
Install VCL Package
5

Install FMX Package (Optional)

If you’re developing FireMonkey applications:
  1. Right-click the DclFMX package
  2. Select Install
  3. Wait for compilation and installation to complete

Verify Installation

After installation, verify TeeTree is available:
1

Create New VCL Application

File → New → VCL Forms Application
2

Find TTree Component

Open the Component Palette and look for TTree component in the TeeTree tab.TTree in Component Palette
3

Place Component on Form

Double-click TTree or drag it onto your form. The component should appear and be ready to use.

Configure Library Paths

You must configure library paths for compilation to work properly.
Add TeeTree source paths to your project or global library paths:
1

Global Library Configuration (Recommended)

  1. Go to Tools → Options
  2. Navigate to Language → Delphi → Library
  3. Select your platform (Win32, Win64, etc.)
  4. Click the […] button next to Library path
  5. Add the TeeTree sources path:
C:\TeeTree\Sources
Library Path Configuration
2

Add Namespace Prefixes

In the same Library configuration:
  1. Find Unit scope names
  2. Add the following prefixes (if not already present):
VclTee;FMXTee
Namespace Configuration

Per-Project Configuration

Alternatively, configure paths per project:
  1. Project → Options
  2. Building → Delphi Compiler
  3. Add to Search Path:
$(TeeTreePath)\Sources

Optional: TeeChart Lite Update

For RAD Studio 13.0 Florence users, install the free TeeChart Lite update:

Download TeeChart Lite Patch

Optional performance and compatibility update for RAD 13.0 Florence

FireMonkey Verification

For FireMonkey applications:
1

Create FMX Application

File → New → Multi-Device Application
2

Find TTree Component

The TTree component should appear in the Component Palette.FMX TTree Component
3

Test on Multiple Platforms

TeeTree supports:
  • Windows (32-bit and 64-bit)
  • macOS (Intel and Apple Silicon)
  • iOS (Simulator and Device)
  • Android (ARM32 and ARM64)

Troubleshooting

Package Compilation Errors

Solution: Ensure you’re using the correct package group:
  • If you have TeeChart Pro, use Sources/Packages/Pro
  • If you have TeeChart Lite (included with RAD Studio), use Sources/Packages/Lite
Solution: Add VclTee and FMXTee to Unit scope names in Library settings
Solution: Select the correct platform target (Win32/Win64) that matches your RAD Studio edition

Runtime Errors

Solution: Ensure Parent property is set and component has valid bounds:
Tree1.Parent := Self;
Tree1.Align := alClient; // or set specific bounds
Solution: Ensure the Tree component is fully created before adding nodes:
Tree1 := TTree.Create(Self);
Tree1.Parent := Self;
// Now safe to add nodes
Tree1.AddRoot('My Node');

Next Steps

Now that TeeTree is installed, proceed to the Quick Start Guide to create your first tree diagram.

Uninstallation

To uninstall TeeTree from the IDE:
  1. Go to Tools → Options
  2. Navigate to Language → Delphi → Library
  3. Remove TeeTree paths from Library path
  4. In Component → Install Packages
  5. Find TeeTree packages and click Remove
Uninstalling only removes design-time support. Your existing projects will continue to work as long as source files are accessible.

Build docs developers (and LLMs) love