Installation

Step-by-step guide to installing TeeTree in RAD Studio IDE

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:

VCL

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

   
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.

   
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
   

   
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
   

   

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.

   
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

Cannot find TeeChart units

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

Unit scope name errors

Solution: Add VclTee and FMXTee to Unit scope names in Library settings

Platform not supported errors

Solution: Select the correct platform target (Win32/Win64) that matches your RAD Studio edition

Runtime Errors

TTree component not visible at runtime

Solution: Ensure Parent property is set and component has valid bounds:

Tree1.Parent := Self;
Tree1.Align := alClient; // or set specific bounds

Access violations when creating nodes

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.