FTR Controls — Developer Documentation

Modern Windows Forms controls for .NET Framework 4.7.2 and .NET 6+ Windows, with theming, licensing, and full API documentation.

Overview

FTR Controls (FTR.UI.WinForms) helps you build professional desktop UIs without implementing custom-painted controls from scratch. The library includes inputs, buttons, grids, charts, navigation shells, calendar planner, toast notifications, and a global theme system.

Each control has a dedicated markdown guide with properties, events, code examples, and premium feature notes.

Why FTR Controls

Problem	Solution	Result
Default WinForms controls look dated	Modern rounded design, animations, and themes	Polished UIs in less time
Custom controls take weeks to build	Ready-to-use toolbox controls with Designer support	Faster development, fewer bugs
License logic is complex	Built-in trial, activation, and premium guards	Focus on your application

Quick Start

Install-Package FTR.UI.WinForms

using FTRControls;
using FTRThemes.Themes;

ThemeManager.CurrentTheme = ThemeManager.ThemeMode.Dark;

var textBox = new FTRTextBox
{
    Placeholder = "Search...",
    Dock = DockStyle.Top,
    Height = 40
};
Controls.Add(textBox);

Requirements

Windows 10 or later
.NET Framework 4.7.2 or net6.0-windows (or compatible WinForms TFM)
Visual Studio 2019+ recommended for Designer and Toolbox integration

Installation

NuGet (recommended)

Right-click your WinForms project → Manage NuGet Packages
Search for FTR.UI.WinForms
Install the package — controls appear under FTR Controls in the Toolbox

Manual reference

Add a reference to FTR.UI.WinForms.dll
Place FTR.UI.WinForms.xml next to the DLL for IntelliSense
Rebuild and drag controls from the Toolbox or create them in code

Theme System

ThemeManager.CurrentTheme = ThemeManager.ThemeMode.Dark;
// Light | Dark | Color | Duotone

Controls implementing IThemeableControl refresh via ApplyTheme() when the theme changes. Use FTRThemeColors for consistent palette values. See ThemeManager.md.

Control Reference

Click a control name to open its full developer guide (markdown).

FTRTextBox

Rounded text box with placeholder, icon, validation, and themes.

FTRControls

Rich text editor with toolbar, printing, and theme-aware icons.

FTRButton

Material, gradient, ripple, SVG, badge, and checkable styles.

FTRCheckBox

Animated checkbox/toggle with grouping support.

FTRRadioButton

Themed radio button with ripple effect.

FTRDropDown

Searchable dropdown with single or multi-select.

FTRSlider

Single-value slider with custom track and thumb.

FTRRangeSlider

Dual-thumb range slider.

FTRNumericUpDown

Styled numeric up/down input.

FTRRating

Star rating control.

FTRTokenEdit

Tag/token input with removable chips.

FTRBadgeLabel

Pill or rounded status badge label.

FTRProgressBar

Linear progress bar.

FTRCircularProgressBar

Circular progress indicator.

FTRCard

Card panel with header, footer, and actions.

FTRChart

Multi-series charts (line, bar, area, pie).

FTRGridView

Classic data grid with built-in search.

FTRGridViewPro

Advanced grid with editing, filters, and export.

FTRTreeList

Multi-column tree/list view.

FTRTabControl

Tabs with badges, pin, and close buttons.

FTRSidebar

Vertical icon sidebar navigation.

FTRDashboard

Dashboard shell with sidebar pages.

FTRAccordion

Collapsible accordion panels.

FTRRibbon

Office-style ribbon toolbar.

FTRCalendarPlanner

Gregorian/Persian calendar with daily notes.

NoteCardControl

Note card used inside the calendar planner.

FTRMessageBox

Custom styled message box API.

FTRToastNotification

Toast notification form.

ToastNotificationManager

Static helper to show toast notifications.

FTRBaseControl

Base class for themed, licensed controls.

ThemeManager

Global Light/Dark/Color/Duotone themes.

License & Activation

Unlicensed use: Controls remain functional with default settings. Premium properties (category Premium Features) are restricted until you activate with a vendor key.

Activate with LicenseService.Activate(key) or LicenseService.EnsureLicensed() (shows the activation dialog once per session).

Key format: FTR|LicensedTo|MachineId|Signature

Full guide: LICENSE-GUIDE.md

Markdown Documentation

Document	Description
README.md	Package overview and quick links
GETTING-STARTED.md	Installation, namespaces, themes, licensing
DOCUMENTATION.md	Full library overview and FAQ
LICENSE-GUIDE.md	Customer licensing and activation
CHANGELOG.md	Version history

Support

For license keys, activation issues, or technical support, contact your vendor through the website or purchase page.