NativeUI C# (Cómo Funciona para Desarrolladores)

Crear su primer menú

Crear tu primer menú con NativeUI es un paso emocionante. El diseño de la biblioteca está orientado a la facilidad de uso, permitiéndote agregar descripciones de elementos, botones simples e incluso pancartas personalizadas sin mucho esfuerzo. Para aquellos que comienzan, es aconsejable comenzar con un script básico y agregar gradualmente características más complejas a medida que te sientas más cómodo con el marco. Aquí tienes un ejemplo simple de creación de un menú básico con sus propias texturas:

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;
    }
}

Este script configura un menú básico con un elemento y maneja su selección. NativeUI utiliza devoluciones de llamada basadas en eventos, lo que significa que las acciones en tus menús activarán eventos específicos, haciendo que tu IU sea interactiva y receptiva.

Personalización de menús

NativeUI permite un alto grado de personalización. Puedes decorar tus menús con tus propias texturas y pancartas personalizadas, dándoles un aspecto único que se destaca. Agregar estos toques personales no solo hace que tus menús sean más atractivos visualmente, sino que también crea una experiencia más inmersiva para los usuarios.

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));
}

Implementación de IronPDF en una aplicación NativeUI

Integrar IronPDF en un proyecto C# con NativeUI requiere agregar el paquete IronPDF a tu proyecto de Visual Studio. Esto se puede hacer fácilmente a través del Administrador de Paquetes NuGet en Visual Studio. Una vez configurado, puedes usar las características de IronPDF junto con los elementos de IU creados con NativeUI.

Considera una aplicación donde necesites generar un informe basado en la entrada del usuario desde una interfaz de NativeUI. Aquí se explica cómo puedes lograr esto usando 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;
    }
}