xtd - Reference Guide  0.1.0
Modern c++17/20 framework to create console, GUI and unit test applications on Windows, macOS, Linux, iOS and android.
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Modules Pages
Static Public Member Functions | List of all members
xtd::forms::exception_box Class Referencefinal

#include <exception_box.h>

Definition

Represents a common dialog box that displays exception box.

Namespace
xtd::forms
Library
xtd.forms
Examples
The following code example demonstrate the use of exception_box dialog.
#include <xtd/xtd>
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.", current_stack_frame_);
} catch(const xtd::system_exception& e) {
if (exception_box::show(*this, e) == dialog_result::cancel)
application::exit();
}
};
}
private:
};
int main() {
application::run(form1());
}
static void run()
Begins running a standard application message loop on the current thread, without a form.
Represents a Windows button control.
Definition: button.h:54
Represents a window or dialog box that makes up an application's user interface.
Definition: form.h:40
The exception that is thrown when a method call is invalid for the object's current state.
Definition: invalid_operation_exception.h:18
Defines the base class for predefined exceptions in the xtd namespace.
Definition: system_exception.h:24
#define current_stack_frame_
Provides information about the current stack frame.
Definition: stack_frame.h:201
@ button1
The first button on the message box is the default button.
The xtd::forms namespace contains classes for creating Windows-based applications that take full adva...
Definition: about_box.h:13
The xtd namespace contains all fundamental classes to access Hardware, Os, System,...
Definition: system_report.h:17

Inherits xtd::static_object.

Static Public Member Functions

static dialog_result show ()
 Displays a exception box. The exception box displays an unknown exception.
 
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 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::ustring &caption)
 Displays a exception box in front of the specified window. The exception box displays a specified exception and caption.
 
static dialog_result show (const iwin32_window &owner, const xtd::ustring &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 std::exception &exception)
 Displays a exception box. The exception box displays a specified exception.
 
static dialog_result show (const std::exception &exception, const xtd::ustring &caption)
 Displays a exception box. The exception box displays a specified exception and caption.
 
static dialog_result show (const xtd::ustring &caption)
 Displays a exception box. The exception box displays a specified caption and unknown exception.
 

Member Function Documentation

◆ show() [1/8]

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

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

◆ show() [2/8]

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

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

Parameters
ownerA iwin32_window that represents the owner window of the busy box.

◆ show() [3/8]

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

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

Parameters
ownerA iwin32_window that represents the owner window of the busy box.
exceptionAn exception to display.

◆ show() [4/8]

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

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

Parameters
ownerA iwin32_window that represents the owner window of the busy box.
exceptionAn exception to display.
captionA string that specifies the title bar caption to display.

◆ show() [5/8]

static dialog_result xtd::forms::exception_box::show ( const iwin32_window owner,
const xtd::ustring caption 
)
inlinestatic

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

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

◆ show() [6/8]

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

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

Parameters
exceptionAn exception to display.

◆ show() [7/8]

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

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

Parameters
exceptionAn exception to display.
captionA string that specifies the title bar caption to display.

◆ show() [8/8]

static dialog_result xtd::forms::exception_box::show ( const xtd::ustring caption)
inlinestatic

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

Parameters
captionA string that specifies the title bar caption to display.

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