xtd::forms::exception_box Class Reference

Inheritance diagram for xtd::forms::exception_box:

Definition

Represents a common dialog box that displays exception box.

Header

#include <xtd/forms/exception_box>

Namespace

xtd::forms

Library

xtd.forms

Appearance

	Windows	macOS	Gnome
Light
Dark

Examples

The following code example demonstrates the use of exception_box dialog.

#include <xtd/forms/application>
#include <xtd/forms/button>
#include <xtd/forms/exception_box>
#include <xtd/forms/form>
#include <xtd/invalid_operation_exception>
 
using namespace xtd;
using namespace xtd::forms;
 
class form1 : public form {
public:
  form1() {
    text("Exception box example");
    controls().push_back(button1);
    
    button1.location({10, 10});
    button1.auto_size(true);
    button1.text("Exception...");
    button1.click += [&] {
      try {
        throw invalid_operation_exception("Throws an invalid operation exception to show an exception dialog.");
      } catch (const xtd::system_exception& e) {
        if (exception_box::show(*this, e) == dialog_result::cancel)
          application::exit();
      }
    };
  }
  
private:
  button button1;
};
 
auto main() -> int {
  application::run(form1 {});
}

Public Static Methods
static dialog_result	show (const iwin32_window &owner)
	Displays a exception box in front of the specified window. The exception box displays an unknown exception.
static dialog_result	show (const iwin32_window &owner, const xtd::string &caption)
	Displays a exception box in front of the specified window. The exception box displays a specified caption and unknown exception.
static dialog_result	show (const iwin32_window &owner, const std::exception &exception)
	Displays a exception box in front of the specified window. The exception box displays a specified exception.
static dialog_result	show (const iwin32_window &owner, const std::exception &exception, const xtd::string &caption)
	Displays a exception box in front of the specified window. The exception box displays a specified exception and caption.
static dialog_result	show ()
	Displays a exception box. The exception box displays an unknown exception.
static dialog_result	show (const xtd::string &caption)
	Displays a exception box. The exception box displays a specified caption and unknown exception.
static dialog_result	show (const std::exception &exception)
	Displays a exception box. The exception box displays a specified exception.
static dialog_result	show (const std::exception &exception, const xtd::string &caption)
	Displays a exception box. The exception box displays a specified exception and caption.

Member Function Documentation

show() [1/8]

static dialog_result xtd::forms::exception_box::show ( const iwin32_window &  owner )

static

Displays a exception box in front of the specified window. The exception box displays an unknown exception.

Parameters

owner

A iwin32_window that represents the owner window of the busy box.

show() [2/8]

static dialog_result xtd::forms::exception_box::show ( const iwin32_window &  owner, const xtd::string &  caption  )

static

Displays a exception box in front of the specified window. The exception box displays a specified caption and unknown exception.

Parameters

owner	A iwin32_window that represents the owner window of the busy box.
caption	A string that specifies the title bar caption to display.

show() [3/8]

static dialog_result xtd::forms::exception_box::show ( const iwin32_window &  owner, const std::exception &  exception  )

static

Displays a exception box in front of the specified window. The exception box displays a specified exception.

Parameters

owner	A iwin32_window that represents the owner window of the busy box.
exception	An exception to display.

show() [4/8]

static dialog_result xtd::forms::exception_box::show ( const iwin32_window &  owner, const std::exception &  exception, const xtd::string &  caption  )

static

Displays a exception box in front of the specified window. The exception box displays a specified exception and caption.

Parameters

owner	A iwin32_window that represents the owner window of the busy box.
exception	An exception to display.
caption	A string that specifies the title bar caption to display.

show() [5/8]

static dialog_result xtd::forms::exception_box::show ( )

static

Displays a exception box. The exception box displays an unknown exception.

show() [6/8]

static dialog_result xtd::forms::exception_box::show ( const xtd::string &  caption )

static

Displays a exception box. The exception box displays a specified caption and unknown exception.

Parameters

caption

A string that specifies the title bar caption to display.

show() [7/8]

static dialog_result xtd::forms::exception_box::show ( const std::exception &  exception )

static

Displays a exception box. The exception box displays a specified exception.

Parameters

exception

An exception to display.

show() [8/8]

static dialog_result xtd::forms::exception_box::show ( const std::exception &  exception, const xtd::string &  caption  )

static

Displays a exception box. The exception box displays a specified exception and caption.

Parameters

exception	An exception to display.
caption	A string that specifies the title bar caption to display.

---

The documentation for this class was generated from the following file:

• xtd.forms/include/xtd/forms/exception_box.h