MeltdownBoxes 1.0.0

MeltdownBoxes

Description

MeltdownBoxes is a WPF library of alert and dialog boxes designed to enhance user interactions. With modern and user-friendly interfaces, it offers customizable alert boxes and dialogs that application developers can easily integrate into their projects.

Installation

To add this package to your project, you can follow the steps below:

Installation via NuGet

1. Open Visual Studio.
2. Open your project.
3. From the Tools menu, select NuGet Package Manager, then click on Manage NuGet Packages for Solution....
4. Go to the Browse tab and type MeltdownBoxes in the search box.
5. Select the package from the list and click the Install button.
6. Accept the license agreement.

Manual Installation

If you prefer not to use NuGet, you can also install the package manually:

1. Download the source code from the GitHub Repository.
2. Right-click on your project references and select Add Reference....
3. Choose the .dll file from the Bin folder of the downloaded package and add it.

Dependencies

To ensure the proper functioning of this package, .NET 8 or a higher version must be present in the project.

Once the installation is complete, you can easily create alert and dialog boxes using the BoxController class.

Usage

Before using the BoxController class, you need to Initialize the alert and dialog boxes separately. You do not need to Initialize the structure you do not wish to use. You can use the following code examples to set up the initial configurations:

BoxController.AlertBoxInitialize(
    AlertSize.Medium,
    AlertPlacement.Center,
);

BoxController.DialogBoxInitialize(
    DialogSize.Large,
    DialogPlacement.Center,
);

After this process, both AlertBox and DialogBox structures will be ready for use. If you proceed without performing these initializations, the methods will throw an error.

// Since dialog boxes are async structures, you must wait with await.

    if(await BoxController.ConfirmedDialog("Do you want to proceed with this action?","Confirmation")){
        MessageBox.Show("User continues.");
    }
    else{
        MessageBox.Show("User does not continue.");
    }

// AlertBoxes do not require a result, so you do not need to wait with await.

    BoxController.Warning($"{DateTime.Now}", "Warning");

All variants you can use are shown below.

AlertBoxes

        // ALL ALERTBOXES

        Random random = new Random();
        int randomNumber = random.Next(1, 6);


        switch (randomNumber)
        {
            case 1:
                BoxController.Warning($"{DateTime.Now}", "Warning");
                break;
            case 2:
                BoxController.Error($"{DateTime.Now}", "Error");
                break;
            case 3:
                BoxController.Success($"{DateTime.Now}", "Success");
                break;
            case 4:
                BoxController.Information($"{DateTime.Now}", "Information");
                break;
            default:
                BoxController.Other($"{DateTime.Now}", "Other");
                break;
        }

DialogBoxes

        // ALL DIALOGBOXES
        var x = await BoxController.ConfirmedDialog("test", "test");
        var x1 = await BoxController.ContinueDialog("test", "test");
        var x2 = await BoxController.RetryDialog("test", "test");
        var x3 = await BoxController.WarningDialog("test", "test");

Contributing

MeltdownBoxes is presented as an open-source project. Therefore, anyone can contribute to the project and help enhance the features of MeltdownBoxes.

How to Contribute?

Developers who want to contribute to the project can visit the GitHub page and click the Fork button to create a copy in their accounts. They can then clone the project copy to their computers to make changes.

After making changes, developers should commit their work and push it back to their GitHub page. Finally, they can submit a Pull Request on the original GitHub page to integrate their changes into the original project.

How to Help?

Developers who want to help with the project can check the Issues section on the GitHub page. This section lists the features and problems that need to be addressed for the project's development. Developers can contribute by solving these issues or developing new features.

Additionally, assistance can be provided in improving the project's documentation or adding new features. This can be done by downloading the project copy or editing the files on the GitHub page.

Contact

For any questions, suggestions, or feedback regarding the project, you can reach me at:

• Email: info@furkanozturklab.com
• X: @nakruf_oz

You can also share your issues or suggestions in the Issues section on the project's GitHub page.

By reaching out to us, you can help improve the project. Your suggestions and feedback are important to us and contribute to making the project better.