Crate win_msgbox

source ·
Expand description

This crate provides a fully featured, ergonomic interface to Windows’ MessageBox.

All possible options are usable and return values are Rust enums (or structs if only one option is available).

All configuration is done through MessageBox and available buttons are configured via Options.

This crate uses wide strings. To create a wide string use the w! macro re-exported by this crate from windows_sys.

§Examples

Show a minimal message box with an OK button:

use win_msgbox::{w, Okay};
win_msgbox::show::<Okay>(w!("Hello World"));

Show a message box with an error icon, and match on the return value:

use win_msgbox::{w, CancelTryAgainContinue::{self, *}};

let response = win_msgbox::error::<CancelTryAgainContinue>(w!("Couldn't download resource"))
    .title(w!("Download Error"))
    .show()?;

match response {
    Cancel => println!("Cancelling downlaod..."),
    TryAgain => println!("Attempting redownload..."),
    Continue => println!("Skipping resource"),
}

Macros§

  • w
    A literal UTF-16 wide string with a trailing null terminator.

Structs§

  • MessageBox
    A builder for a modal dialog box that contains a system icon, a set of buttons, and a brief application-specific message, such as status or error information.
  • Okay
    The message box contains one push button: OK.

Enums§

  • AbortRetryIgnore
    The message box contains three push buttons: Abort, Retry, and Ignore.
  • CancelTryAgainContinue
    The message box contains three push buttons: Cancel, Try Again, Continue. Use this message box type instead of AbortRetryIgnore.
  • DefaultButton
    Specifies the default button of the dialog box.
  • Icon
    The icon to be displayed in a message box.
  • Modal
    Specifies the modality of the dialog box.
  • OkayCancel
    The message box contains two push buttons: OK and Cancel.
  • RetryCancel
    The message box contains two push buttons: Retry and Cancel.
  • YesNo
    The message box contains two push buttons: Yes and No.
  • YesNoCancel
    The message box contains three push buttons: Yes, No, and Cancel.

Traits§

  • Options
    This trait is implemented for all possible options.

Functions§

Type Aliases§