Inheritance diagram for xtd::forms::progress_box:

Definition

Represents a common dialog box that displays a progress dialog.

Header: #include <xtd/forms/progress_box>

Namespace: xtd::forms

Library: xtd.forms

Appearance

	Windows	macOS	Gnome
Light
Dark

Examples: The following code example demonstrates the use of xtd::forms::progress_box dialog.
#include <xtd/forms/application>

#include <xtd/forms/button>

#include <xtd/forms/form>

#include <xtd/forms/progress_box>

#include <xtd/threading/thread>

using namespace xtd;

using namespace xtd::forms;

class form1 : public form {

public:

form1() {

text("Progress box example");

client_size({ 400, 200 });

download_button.parent(*this)

.text("Download")

.location({ 10, 10 })

.size({ 150, 35 })

.click += [this] {

progress_box::show(*this, "Downloading", "Please wait...", 0, 0, 100, progress_box_options::show_cancel_button | progress_box_options::show_skip_button);

for (auto index = progress_box::minimum(); index <= progress_box::maximum(); ++index) {

threading::thread::sleep(100_ms); // Do some work...

progress_box::update(index, "Downloading", xtd::string::format("{}/{}", index, progress_box::maximum()));

if (progress_box::skipped()) index++;

if (progress_box::cancelled()) break;

}

progress_box::hide();

};

}

private:

button download_button;

};

auto main() -> int {

application::run(form1 {});

}

xtd::forms::application::run
static void run()
Begins running a standard application message loop on the current thread, without a form.

xtd::forms::control::client_size
virtual const drawing::size & client_size() const noexcept
Gets the height and width of the client area of the control.

xtd::forms::form
Represents a window or dialog box that makes up an application's user interface.
Definition form.hpp:54

xtd::forms::progress_box::hide
static void hide()
Hides a progress box in front.

xtd::forms::progress_box::maximum
static int32 maximum()
Gets the maximum value of the range of the progress dialog.

xtd::forms::progress_box::skipped
static bool skipped()
Check if the progress dialog is skipped.

xtd::forms::progress_box::show
static void show(const xtd::string &title)
Displays a progress box.

xtd::forms::progress_box::minimum
static int32 minimum()
Gets the minimum value of the range of the progress dialog.

xtd::forms::progress_box::cancelled
static bool cancelled()
Check if the progress dialog is canceled.

xtd::forms::progress_box::update
static void update(const progress_box_options options)
Updates progress box.

xtd::threading::thread::sleep
static void sleep(int32 milliseconds_timeout)
Suspends the current thread for a specified time.

xtd::forms::style_sheets::button
xtd::forms::style_sheets::control button
The buttton data allows you to specify the box of a button control.
Definition button.hpp:25

xtd::forms::bounds_specified::size
@ size
Specifies that both the width and height property values of the control are defined.
Definition bounds_specified.hpp:36

xtd::forms::status_bar_panel_style::text
@ text
The xtd::forms::status_bar_panel displays text in the standard font.
Definition status_bar_panel_style.hpp:25

xtd::forms::progress_box_options::show_skip_button
@ show_skip_button
Whether skip button is shown.
Definition progress_box_options.hpp:28

xtd::forms::progress_box_options::show_cancel_button
@ show_cancel_button
Whether cancel button is shown.
Definition progress_box_options.hpp:26

xtd::forms
The xtd::forms namespace contains classes for creating Windows-based applications that take full adva...
Definition texts.hpp:217

xtd
The xtd namespace contains all fundamental classes to access Hardware, Os, System,...
Definition abstract_object.hpp:8

Public Static Properties
static bool	cancelled ()
	Check if the progress dialog is canceled.

static bool	skipped ()
	Check if the progress dialog is skipped.

static int32	minimum ()
	Gets the minimum value of the range of the progress dialog.

static int32	maximum ()
	Gets the maximum value of the range of the progress dialog.

Public Static Methods
static void	hide ()
	Hides a progress box in front.

static void	show (const xtd::string &title)
	Displays a progress box.

static void	show (const xtd::string &title, const progress_box_options options)
	Displays a progress box.

static void	show (const xtd::string &title, const xtd::string &message)
	Displays a progress box.

static void	show (const xtd::string &title, const xtd::string &message, const progress_box_options options)
	Displays a progress box.

static void	show (const xtd::string &title, const xtd::string &message, const int32 initial_value)
	Displays a progress box.

static void	show (const xtd::string &title, const xtd::string &message, const int32 initial_value, const progress_box_options options)
	Displays a progress box.

static void	show (const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum)
	Displays a progress box.

static void	show (const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum, const progress_box_options options)
	Displays a progress box.

static void	show (const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum, const int32 maximum)
	Displays a progress box.

static void	show (const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum, const int32 maximum, const progress_box_options options)
	Displays a progress box.

static void	show (const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum, const int32 maximum, const bool marquee, const size_t marquee_animation_speed)
	Displays a progress box.

static void	show (const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum, const int32 maximum, const bool marquee, const size_t marquee_animation_speed, const progress_box_options options)
	Displays a progress box.

static void	show (const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum, const int32 maximum, const bool marquee, const size_t marquee_animation_speed, const xtd::array< xtd::string > &informations)
	Displays a progress box.

static void	show (const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum, const int32 maximum, const bool marquee, const size_t marquee_animation_speed, const xtd::array< xtd::string > &informations, const progress_box_options options)
	Displays a progress box.

static void	show (const iwin32_window &owner, const xtd::string &title)
	Displays a progress dialog box in front of a specified window.

static void	show (const iwin32_window &owner, const xtd::string &title, const progress_box_options options)
	Displays a progress dialog box in front of a specified window.

static void	show (const iwin32_window &owner, const xtd::string &title, const xtd::string &message)
	Displays a progress dialog box in front of a specified window.

static void	show (const iwin32_window &owner, const xtd::string &title, const xtd::string &message, const progress_box_options options)
	Displays a progress dialog box in front of a specified window.

static void	show (const iwin32_window &owner, const xtd::string &title, const xtd::string &message, const int32 initial_value)
	Displays a progress dialog box in front of a specified window.

static void	show (const iwin32_window &owner, const xtd::string &title, const xtd::string &message, const int32 initial_value, const progress_box_options options)
	Displays a progress dialog box in front of a specified window.

static void	show (const iwin32_window &owner, const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum)
	Displays a progress dialog box in front of a specified window.

static void	show (const iwin32_window &owner, const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum, const progress_box_options options)
	Displays a progress dialog box in front of a specified window.

static void	show (const iwin32_window &owner, const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum, const int32 maximum)
	Displays a progress dialog box in front of a specified window.

static void	show (const iwin32_window &owner, const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum, const int32 maximum, const progress_box_options options)
	Displays a progress dialog box in front of a specified window.

static void	show (const iwin32_window &owner, const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum, const int32 maximum, const bool marquee, const size_t marquee_animation_speed)
	Displays a progress dialog box in front of a specified window.

static void	show (const iwin32_window &owner, const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum, const int32 maximum, const bool marquee, const size_t marquee_animation_speed, const progress_box_options options)
	Displays a progress dialog box in front of a specified window.

static void	show (const iwin32_window &owner, const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum, const int32 maximum, const bool marquee, const size_t marquee_animation_speed, const xtd::array< xtd::string > &informations)
	Displays a progress dialog box in front of a specified window.

static void	show (const iwin32_window &owner, const xtd::string &title, const xtd::string &message, const int32 initial_value, const int32 minimum, const int32 maximum, const bool marquee, const size_t marquee_animation_speed, const xtd::array< xtd::string > &informations, const progress_box_options options)
	Displays a progress dialog box in front of a specified window.

static void	update (const progress_box_options options)
	Updates progress box.

static void	update (const int32 value)
	Updates progress box.

static void	update (const int32 value, const xtd::string &title)
	Updates progress box.

static void	update (const int32 value, const xtd::string &title, const xtd::string &message)
	Updates progress box.

static void	update (const int32 value, const xtd::string &title, const xtd::string &message, const int32 minimum)
	Updates progress box.

static void	update (const int32 value, const xtd::string &title, const xtd::string &message, const int32 minimum, const int32 maximum)
	Updates progress box.

static void	update (const int32 value, const xtd::string &title, const xtd::string &message, const int32 minimum, const int32 maximum, const bool marquee)
	Updates progress box.

static void	update (const int32 value, const xtd::string &title, const xtd::string &message, const int32 minimum, const int32 maximum, const bool marquee, const size_t marquee_animation_speed)
	Updates progress box.

static void	update (const int32 value, const xtd::string &title, const xtd::string &message, const int32 minimum, const int32 maximum, const bool marquee, const size_t marquee_animation_speed, const xtd::array< xtd::string > &informations)
	Updates progress box.

Member Function Documentation

◆ cancelled()

static bool xtd::forms::progress_box::cancelled ( )

static

Check if the progress dialog is canceled.

Returns: true if the progress dialog is canceled

◆ skipped()

static bool xtd::forms::progress_box::skipped ( )

static

Check if the progress dialog is skipped.

Returns: true if the progress dialog is skipped

◆ minimum()

static int32 xtd::forms::progress_box::minimum ( )

static

Gets the minimum value of the range of the progress dialog.

Returns: The minimum value of the range. The default is 0.

◆ maximum()

static int32 xtd::forms::progress_box::maximum ( )

static

Gets the maximum value of the range of the progress dialog.

Returns: The maximum value of the range. The default is 100.

◆ hide()

static void xtd::forms::progress_box::hide ( )

static

Hides a progress box in front.

◆ show() [1/28]

static void xtd::forms::progress_box::show ( const xtd::string & title )

static

Displays a progress box.

Parameters

title An xtd::string that specifies the title of the progress dialog.

◆ show() [2/28]

static void xtd::forms::progress_box::show	(	const xtd::string &	title,
		const progress_box_options	options )

static

Displays a progress box.

Parameters

title	An xtd::string that specifies the title of the progress dialog.
options	A bitwise combination of enum xtd::forms::progress_box_options to specify additional options to the progress dialog box.

◆ show() [3/28]

static void xtd::forms::progress_box::show	(	const xtd::string &	title,
		const xtd::string &	message )

static

Displays a progress box.

Parameters

title	An xtd::string that specifies the title of the progress dialog.
message	An xtd::string that specifies the message of the progress dialog.

◆ show() [4/28]

static void xtd::forms::progress_box::show	(	const xtd::string &	title,
		const xtd::string &	message,
		const progress_box_options	options )

static

Displays a progress box.

Parameters

title	An xtd::string that specifies the title of the progress dialog.
message	An xtd::string that specifies the message of the progress dialog.
options	A bitwise combination of enum xtd::forms::progress_box_options to specify additional options to the progress dialog box.

◆ show() [5/28]

static void xtd::forms::progress_box::show	(	const xtd::string &	title,
		const xtd::string &	message,
		const int32	initial_value )

static

Displays a progress box.

Parameters

title	An xtd::string that specifies the title of the progress dialog.
message	An xtd::string that specifies the message of the progress dialog.
initial_value	An integer that indicates the initial value of the progress dialog.

◆ show() [6/28]

static void xtd::forms::progress_box::show	(	const xtd::string &	title,
		const xtd::string &	message,
		const int32	initial_value,
		const progress_box_options	options )

static

Displays a progress box.

Parameters

title	An xtd::string that specifies the title of the progress dialog.
message	An xtd::string that specifies the message of the progress dialog.
initial_value	An integer that indicates the initial value of the progress dialog.
options	A bitwise combination of enum xtd::forms::progress_box_options to specify additional options to the progress dialog box.

◆ show() [7/28]

static void xtd::forms::progress_box::show	(	const xtd::string &	title,
		const xtd::string &	message,
		const int32	initial_value,
		const int32	minimum )

static

Displays a progress box.

Parameters

title	An xtd::string that specifies the title of the progress dialog.
message	An xtd::string that specifies the message of the progress dialog.
initial_value	An integer that indicates the initial value of the progress dialog.
minimum	An integer that indicates the minimum value of the progress dialog.

◆ show() [8/28]

static void xtd::forms::progress_box::show	(	const xtd::string &	title,
		const xtd::string &	message,
		const int32	initial_value,
		const int32	minimum,
		const progress_box_options	options )

static

Displays a progress box.

Parameters

title	An xtd::string that specifies the title of the progress dialog.
message	An xtd::string that specifies the message of the progress dialog.
initial_value	An integer that indicates the initial value of the progress dialog.
minimum	An integer that indicates the minimum value of the progress dialog.
options	A bitwise combination of enum xtd::forms::progress_box_options to specify additional options to the progress dialog box.

◆ show() [9/28]

static void xtd::forms::progress_box::show	(	const xtd::string &	title,
		const xtd::string &	message,
		const int32	initial_value,
		const int32	minimum,
		const int32	maximum )

static

Displays a progress box.

Parameters

title	An xtd::string that specifies the title of the progress dialog.
message	An xtd::string that specifies the message of the progress dialog.
initial_value	An integer that indicates the initial value of the progress dialog.
minimum	An integer that indicates the minimum value of the progress dialog.
maximum	An integer that indicates the maximum value of the progress dialog.

◆ show() [10/28]

static void xtd::forms::progress_box::show	(	const xtd::string &	title,
		const xtd::string &	message,
		const int32	initial_value,
		const int32	minimum,
		const int32	maximum,
		const progress_box_options	options )

static

Displays a progress box.

Parameters

title	An xtd::string that specifies the title of the progress dialog.
message	An xtd::string that specifies the message of the progress dialog.
initial_value	An integer that indicates the initial value of the progress dialog.
minimum	An integer that indicates the minimum value of the progress dialog.
maximum	An integer that indicates the maximum value of the progress dialog.
options	A bitwise combination of enum xtd::forms::progress_box_options to specify additional options to the progress dialog box.

◆ show() [11/28]

static void xtd::forms::progress_box::show	(	const xtd::string &	title,
		const xtd::string &	message,
		const int32	initial_value,
		const int32	minimum,
		const int32	maximum,
		const bool	marquee,
		const size_t	marquee_animation_speed )

static

Displays a progress box.

Parameters

title	An xtd::string that specifies the title of the progress dialog.
message	An xtd::string that specifies the message of the progress dialog.
initial_value	An integer that indicates the initial value of the progress dialog.
minimum	An integer that indicates the minimum value of the progress dialog.
maximum	An integer that indicates the maximum value of the progress dialog.
marquee	A boolean that Indicates progress by continuously scrolling a block across a xtd::forms::progress_bar in a marquee fashion.

◆ show() [12/28]

static void xtd::forms::progress_box::show	(	const xtd::string &	title,
		const xtd::string &	message,
		const int32	initial_value,
		const int32	minimum,
		const int32	maximum,
		const bool	marquee,
		const size_t	marquee_animation_speed,
		const progress_box_options	options )

static

Displays a progress box.

Parameters

title	An xtd::string that specifies the title of the progress dialog.
message	An xtd::string that specifies the message of the progress dialog.
initial_value	An integer that indicates the initial value of the progress dialog.
minimum	An integer that indicates the minimum value of the progress dialog.
maximum	An integer that indicates the maximum value of the progress dialog.
marquee	A boolean that Indicates progress by continuously scrolling a block across a xtd::forms::progress_bar in a marquee fashion.
options	A bitwise combination of enum xtd::forms::progress_box_options to specify additional options to the progress dialog box.

◆ show() [13/28]

static void xtd::forms::progress_box::show	(	const xtd::string &	title,
		const xtd::string &	message,
		const int32	initial_value,
		const int32	minimum,
		const int32	maximum,
		const bool	marquee,
		const size_t	marquee_animation_speed,
		const xtd::array< xtd::string > &	informations )

static

Displays a progress box.

Parameters

title	An xtd::string that specifies the title of the progress dialog.
message	An xtd::string that specifies the message of the progress dialog.
initial_value	An integer that indicates the initial value of the progress dialog.
minimum	An integer that indicates the minimum value of the progress dialog.
maximum	An integer that indicates the maximum value of the progress dialog.
marquee	A boolean that Indicates progress by continuously scrolling a block across a xtd::forms::progress_bar in a marquee fashion.
marquee_animation_speed	An integer that indicates the time period, in milliseconds, that it takes the progress block to scroll across the progress bar.
informations	An xtd::array of xtd::string that specifies the information texts of the progress dialog.

◆ show() [14/28]

static void xtd::forms::progress_box::show	(	const xtd::string &	title,
		const xtd::string &	message,
		const int32	initial_value,
		const int32	minimum,
		const int32	maximum,
		const bool	marquee,
		const size_t	marquee_animation_speed,
		const xtd::array< xtd::string > &	informations,
		const progress_box_options	options )

static

Displays a progress box.

Parameters

title	An xtd::string that specifies the title of the progress dialog.
message	An xtd::string that specifies the message of the progress dialog.
initial_value	An integer that indicates the initial value of the progress dialog.
minimum	An integer that indicates the minimum value of the progress dialog.
maximum	An integer that indicates the maximum value of the progress dialog.
marquee	A boolean that Indicates progress by continuously scrolling a block across a xtd::forms::progress_bar in a marquee fashion.
marquee_animation_speed	An integer that indicates the time period, in milliseconds, that it takes the progress block to scroll across the progress bar.
informations	An xtd::array of xtd::string that specifies the information texts of the progress dialog.
options	A bitwise combination of enum xtd::forms::progress_box_options to specify additional options to the progress dialog box.