NativeUI C# (How It Works For Developers)

Creating Your First Menu

Creating your first menu with NativeUI is an exciting step. The library's design caters to ease of use, allowing you to add item descriptions, simple buttons, and even custom banners without much hassle. For those starting, it's advisable to begin with a basic script and gradually add more complex features as you become more comfortable with the framework. Here’s a simple example of creating a basic menu with its own textures:

using System;
using System.Windows.Forms;
using NativeUI;

public class YourFirstMenu : Script
{
    private MenuPool _menuPool;
    private UIMenu mainMenu;

    public YourFirstMenu()
    {
        _menuPool = new MenuPool();
        mainMenu = new UIMenu("NativeUI", "SELECT AN OPTION");
        _menuPool.Add(mainMenu);
        AddMenuItems(mainMenu);
        _menuPool.RefreshIndex();

        // Subscribe to event handlers for updating and input control
        Tick += OnTick;
        KeyDown += OnKeyDown;
    }

    private void AddMenuItems(UIMenu menu)
    {
        var item1 = new UIMenuItem("Item 1", "Description for Item 1");
        menu.AddItem(item1);

        // Set up an event for when an item is selected
        menu.OnItemSelect += (sender, item, index) =>
        {
            if (item == item1)
            {
                // Do something when Item 1 is selected
            }
        };
    }

    private void OnTick(object sender, EventArgs e)
    {
        // Process the pool to handle drawing and interactions
        _menuPool.ProcessMenus();
    }

    private void OnKeyDown(object sender, KeyEventArgs e)
    {
        // Toggle the visibility of the menu with F5 key
        if (e.KeyCode == Keys.F5 && !_menuPool.IsAnyMenuOpen())
            mainMenu.Visible = !mainMenu.Visible;
    }
}

using System;
using System.Windows.Forms;
using NativeUI;

public class YourFirstMenu : Script
{
    private MenuPool _menuPool;
    private UIMenu mainMenu;

    public YourFirstMenu()
    {
        _menuPool = new MenuPool();
        mainMenu = new UIMenu("NativeUI", "SELECT AN OPTION");
        _menuPool.Add(mainMenu);
        AddMenuItems(mainMenu);
        _menuPool.RefreshIndex();

        // Subscribe to event handlers for updating and input control
        Tick += OnTick;
        KeyDown += OnKeyDown;
    }

    private void AddMenuItems(UIMenu menu)
    {
        var item1 = new UIMenuItem("Item 1", "Description for Item 1");
        menu.AddItem(item1);

        // Set up an event for when an item is selected
        menu.OnItemSelect += (sender, item, index) =>
        {
            if (item == item1)
            {
                // Do something when Item 1 is selected
            }
        };
    }

    private void OnTick(object sender, EventArgs e)
    {
        // Process the pool to handle drawing and interactions
        _menuPool.ProcessMenus();
    }

    private void OnKeyDown(object sender, KeyEventArgs e)
    {
        // Toggle the visibility of the menu with F5 key
        if (e.KeyCode == Keys.F5 && !_menuPool.IsAnyMenuOpen())
            mainMenu.Visible = !mainMenu.Visible;
    }
}

This script sets up a basic menu with one item and handles its selection. NativeUI utilizes event-based callbacks, which means actions in your menus will trigger specific events, making your UI interactive and responsive.

Customizing Menus

NativeUI allows for a high degree of customization. You can decorate your menus with your own textures and custom banners, giving them a unique look that stands out. Adding these personal touches not only makes your menus more visually appealing but also creates a more immersive experience for users.

private void CustomizeMenu(UIMenu menu)
{
    // Set a custom banner texture for the menu
    menu.SetBannerType("texture.png");

    // Change the color of a specific menu item to red
    menu.ChangeItemColour("Item 1", System.Drawing.Color.FromArgb(255, 0, 0));
}

private void CustomizeMenu(UIMenu menu)
{
    // Set a custom banner texture for the menu
    menu.SetBannerType("texture.png");

    // Change the color of a specific menu item to red
    menu.ChangeItemColour("Item 1", System.Drawing.Color.FromArgb(255, 0, 0));
}

Implementing IronPDF in a NativeUI Application

Integrating IronPDF in a C# project with NativeUI requires adding the IronPDF package to your Visual Studio project. This can be done easily via NuGet Package Manager in Visual Studio. Once set up, you can use IronPDF's features alongside the UI elements created with NativeUI.

Consider an application where you need to generate a report based on user input from a NativeUI interface. Here’s how you can achieve this using IronPDF:

using IronPdf;
using NativeUI;
using System;

public class ReportGenerator : Script
{
    private MenuPool _menuPool;
    private UIMenu mainMenu;

    public ReportGenerator()
    {
        _menuPool = new MenuPool();
        mainMenu = new UIMenu("Report Generator", "SELECT AN OPTION");
        _menuPool.Add(mainMenu);
        AddPdfGenerationOption(mainMenu);
        _menuPool.RefreshIndex();

        // Subscribe to event handlers for updating and input control
        Tick += OnTick;
        KeyDown += OnKeyDown;
    }

    private void AddPdfGenerationOption(UIMenu menu)
    {
        var generateReportItem = new UIMenuItem("Generate Report", "Create a PDF report");
        menu.AddItem(generateReportItem);

        // Set up an event for when an item is selected
        menu.OnItemSelect += (sender, item, index) =>
        {
            if (item == generateReportItem)
            {
                CreatePdfReport();
            }
        };
    }

    private void CreatePdfReport()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Report</h1><p>Report details...</p>");
        pdf.SaveAs("Report.pdf");

        // Notification to the user that the PDF report has been generated
        Console.WriteLine("PDF report generated and saved as Report.pdf");
    }

    private void OnTick(object sender, EventArgs e)
    {
        // Process the pool to handle drawing and interactions
        _menuPool.ProcessMenus();
    }

    private void OnKeyDown(object sender, KeyEventArgs e)
    {
        // Toggle the visibility of the menu with F5 key
        if (e.KeyCode == Keys.F5 && !_menuPool.IsAnyMenuOpen())
            mainMenu.Visible = !mainMenu.Visible;
    }
}

using IronPdf;
using NativeUI;
using System;

public class ReportGenerator : Script
{
    private MenuPool _menuPool;
    private UIMenu mainMenu;

    public ReportGenerator()
    {
        _menuPool = new MenuPool();
        mainMenu = new UIMenu("Report Generator", "SELECT AN OPTION");
        _menuPool.Add(mainMenu);
        AddPdfGenerationOption(mainMenu);
        _menuPool.RefreshIndex();

        // Subscribe to event handlers for updating and input control
        Tick += OnTick;
        KeyDown += OnKeyDown;
    }

    private void AddPdfGenerationOption(UIMenu menu)
    {
        var generateReportItem = new UIMenuItem("Generate Report", "Create a PDF report");
        menu.AddItem(generateReportItem);

        // Set up an event for when an item is selected
        menu.OnItemSelect += (sender, item, index) =>
        {
            if (item == generateReportItem)
            {
                CreatePdfReport();
            }
        };
    }

    private void CreatePdfReport()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Report</h1><p>Report details...</p>");
        pdf.SaveAs("Report.pdf");

        // Notification to the user that the PDF report has been generated
        Console.WriteLine("PDF report generated and saved as Report.pdf");
    }

    private void OnTick(object sender, EventArgs e)
    {
        // Process the pool to handle drawing and interactions
        _menuPool.ProcessMenus();
    }

    private void OnKeyDown(object sender, KeyEventArgs e)
    {
        // Toggle the visibility of the menu with F5 key
        if (e.KeyCode == Keys.F5 && !_menuPool.IsAnyMenuOpen())
            mainMenu.Visible = !mainMenu.Visible;
    }
}