TKCS 1.0.0

TKCS (Tkinter CSharp) 🚀

A lightweight, object-oriented Windows Forms wrapper library that mirrors classic Python Tkinter layout design and syntax conventions natively in C#.

🌟 Features

• Tkinter Syntax: Use familiar Python-like constructors like button, label, and entry inside the TKCS namespace.
• Strongly-Typed Wrappers: Argument validation via explicit types (new text(), new bgcolor()) prevents type assignment mismatches.
• Auto-Parenting: Child UI controls automatically register and attach to the active parent window context without manual .Add() clutter.
• Inline Callbacks: Wire up button execution logic instantly using standard C# lambda expressions (() => { ... }).
• Optional Geometry Injections: Clean positioning parameters using an integrated layout model (new Geometry(x, y, w, h)).

📦 Installation

To inject the TKCS toolkit architecture into your standard .NET application workspace, run the following command via the .NET CLI:

dotnet add package TKCS

Alternatively, search for TKCS via the Package Manager Console UI inside Visual Studio.

⚠️ Prerequisite requirement: Your project target runtime properties configuration profile must be explicitly set to target Windows desktop platforms (e.g., <TargetFramework>net8.0-windows</TargetFramework> and <UseWindowsForms>true</UseWindowsForms>).

⚡ Quick Start Example

Here is how easy it is to spin up an interactive desktop GUI window with text input modules and custom styled buttons using TKCS:

using System;
using TKCS; // Import the wrapper engine namespace

class Program
{
    [STAThread] // Required execution thread behavior for Windows Forms UI loop engines
    static void Main()
    {
        // Enable OS native visual styling paradigms
        System.Windows.Forms.Application.EnableVisualStyles();

        // 1. Initialize the Root Window Frame (analogous to root = Tk() in Python)
        Tk root = new Tk(new text("TKCS Engine Playground Framework"), width: 500, height: 450);
        root.Show(); // Makes the current frame context active for child widgets

        // 2. Generate a custom descriptive label layout component
        label instructions = new label(
            new text("Enter your script system instructions inside the text field:")
        );

        // 3. Instantiate a custom text input processing module
        entry inputField = new entry(
            new text("Type parameters here..."),
            new Geometry(x: 20, y: 110, width: 250, height: 25)
        );

        // 4. Create an interactive command execution button matching your exact layout syntax
        button actionBtn = new button(
            new bgcolor("#1E1E1E"), 
            new textcolor("#00FF00"), 
            new onclick(() => {
                string currentContent = inputField.Text;
                System.Windows.Forms.MessageBox.Show($"Executing command: {currentContent}", "TKCS Success Callback");
            }), 
            new text("Run Automation Action"),
            new Geometry(x: 20, y: 160, width: 200, height: 45)
        );

        // 5. Fire the main lifecycle event message pump listener loop
        root.mainloop();
    }
}

🗺️ Framework Mapping Overview

🛠️ Formatting Layout Reference

Every component class accepts an optional Geometry configuration block to precisely anchor controls across explicit pixel metrics layouts:

new Geometry(int x, int y, int width, int height);

If omitting the layout parameter on initialization routines entirely, the toolkit defaults to standard cascade offset coordinates internally.

📄 License

This framework configuration is open-source software licensed under the MIT License. Feel free to modify, expand, or fork the framework logic pipeline properties.