Boxer 🥊
Introduction
Boxer is a simple library that allows for easy cross-platform creation of message boxes / alerts / what have you.
Example
macOS:
Windows:
Linux:
Language
Boxer is written in C++, though it has a C branch available as well.
Compiling Boxer
Boxer is set up to be built with CMake.
To generate a static library, execute CMake with the root of the repo as the source directory. Additionally, the example program can be built by enabling the BOXER_BUILD_EXAMPLES option.
On Linux, Boxer requires the gtk+-3.0 package.
Including Boxer
Wherever you want to use Boxer, just include the header:
#include <boxer/boxer.h>
Linking Against Boxer
Static
If Boxer was built statically, just link against the generated static library.
CMake
To compile Boxer along with another application using CMake, first add the Boxer subdirectory:
add_subdirectory("path/to/Boxer")
Then link against the Boxer library:
target_link_libraries(<target> <INTERFACE|PUBLIC|PRIVATE> Boxer)
Using Boxer
To create a message box using Boxer, call the 'show' method in the 'boxer' namespace and provide a message and title:
boxer::show("Simple message boxes are very easy to create.", "Simple Example");
A style / set of buttons may also be specified, and the user's selection can be determined from the function's return value:
boxer::Selection sel = boxer::show("Make a choice:", "Decision", boxer::Style::Warning, boxer::Buttons::YesNo);
Calls to 'show' are blocking - execution of your program will not continue until the user dismisses the message box.
Encoding
Boxer accepts strings encoded in UTF-8:
boxer::show(u8"Boxer accepts UTF-8 strings. 💯", u8"Unicode 👍");
On Windows, UNICODE
needs to be defined when compiling Boxer to enable UTF-8 support:
if (WIN32)
target_compile_definitions(Boxer PRIVATE UNICODE)
endif (WIN32)