xtd 0.2.0
Loading...
Searching...
No Matches
xtd::forms::font_box Class Referencefinal
Inheritance diagram for xtd::forms::font_box:
xtd::static_object

Definition

Represents a common dialog box that displays a dialog to the user to choose a font from among those installed on the local computer.

Header
#include <xtd/forms/font_box>
Namespace
xtd::forms
Library
xtd.forms
Appearance
Windows macOS Gnome
Light  
 
 
 
 
 
Dark  
 
 
 
 
 
Examples
The following code example demonstrates the use of xtd::forms::font_box dialog.
#include <xtd/forms/application>
#include <xtd/forms/button>
#include <xtd/forms/font_box>
#include <xtd/forms/form>
#include <xtd/forms/message_box>
#include <xtd/forms/label>
using namespace xtd;
using namespace xtd::drawing;
using namespace xtd::forms;
class form1 : public form {
public:
form1() {
text("Font box example");
client_size({220, 160});
controls().push_back_range({button_font, button_font_and_color});
button_font.parent(*this)
.location({10, 10})
.text("Select a font")
.size({200, 45})
.click += [this] {
auto font = system_fonts::default_font();
auto res = font_box::show(font, *this);
if (res == dialog_result::ok)
message_box::show(string::format("Selected font is: {}", font));
};
button_font_and_color.parent(*this)
.location({10, 60})
.text("Select a font and a font color")
.size({200, 45})
.click += [] {
drawing::font font(drawing::font_family::generic_sans_serif(), 16);
drawing::color color = drawing::color::blue;
auto res = font_box::show(font, color, font_box_options::show_color);
if (res == dialog_result::ok)
message_box::show(string::format("Selected font is: {}\ncolor: {}", font, color));
};
}
private:
button button_font;
button button_font_and_color;
};
auto main() -> int {
application::run(form1 {});
}
Represents an ARGB (alpha, red, green, blue) color.
Definition color.hpp:49
Defines a particular format for text, including font face, size, and style attributes....
Definition font.hpp:45
static void run()
Begins running a standard application message loop on the current thread, without a form.
Represents a Windows button control.
Definition button.hpp:49
Represents a window or dialog box that makes up an application's user interface.
Definition form.hpp:54
@ text
The xtd::forms::status_bar_panel displays text in the standard font.
The xtd::drawing namespace provides access to GDI+ basic graphics functionality. More advanced functi...
Definition brush.hpp:18
The xtd::forms namespace contains classes for creating Windows-based applications that take full adva...
Definition xtd_about_box.hpp:12
The xtd namespace contains all fundamental classes to access Hardware, Os, System,...
Definition xtd_about_box.hpp:10

Public Static Methods

static dialog_result show (xtd::drawing::font &font)
 Displays a font dialog box.
 
static dialog_result show (xtd::drawing::font &font, const font_box_options options)
 Displays a font dialog box.
 
static dialog_result show (xtd::drawing::font &font, const iwin32_window &owner)
 Displays a font dialog box in front of a specified window.
 
static dialog_result show (xtd::drawing::font &font, const iwin32_window &owner, const font_box_options options)
 Displays a font dialog box in front of a specified window.
 
static dialog_result show (xtd::drawing::font &font, xtd::drawing::color &color)
 Displays a font dialog box.
 
static dialog_result show (xtd::drawing::font &font, xtd::drawing::color &color, const font_box_options options)
 Displays a font dialog box.
 
static dialog_result show (xtd::drawing::font &font, xtd::drawing::color &color, const iwin32_window &owner)
 Displays a font dialog box in front of a specified window.
 
static dialog_result show (xtd::drawing::font &font, xtd::drawing::color &color, const iwin32_window &owner, const font_box_options options)
 Displays a font dialog box in front of a specified window.
 

Member Function Documentation

◆ show() [1/8]

static dialog_result xtd::forms::font_box::show ( xtd::drawing::font font)
static

Displays a font dialog box.

Parameters
fontAn output xtd::drawing::font that will store the selected font.
Returns
xtd::forms::dialog_result::ok if the user clicks OK in the dialog box; otherwise, xtd::forms::dialog_result::cancel.
Remarks
If xtd::forms::dialog_result is xtd::forms::dialog_result::ok, the output font parameter will contain the selected font, otherwise it will be ignored.

◆ show() [2/8]

static dialog_result xtd::forms::font_box::show ( xtd::drawing::font font,
const font_box_options  options 
)
static

Displays a font dialog box.

Parameters
fontAn output xtd::drawing::font that will store the selected font.
optionsA bitwise combination of enum xtd::forms::font_box_options to specify additional options to the font dialog box.
Returns
xtd::forms::dialog_result::ok if the user clicks OK in the dialog box; otherwise, xtd::forms::dialog_result::cancel.
Remarks
If xtd::forms::dialog_result is xtd::forms::dialog_result::ok, the output font parameter will contain the selected font, otherwise it will be ignored.

◆ show() [3/8]

static dialog_result xtd::forms::font_box::show ( xtd::drawing::font font,
const iwin32_window owner 
)
static

Displays a font dialog box in front of a specified window.

Parameters
fontAn output xtd::drawing::font that will store the selected font.
ownerAn xtd::forms::iwin32_window that represents the owner window of the font dialog box.
Returns
xtd::forms::dialog_result::ok if the user clicks OK in the dialog box; otherwise, xtd::forms::dialog_result::cancel.
Remarks
If xtd::forms::dialog_result is xtd::forms::dialog_result::ok, the output font parameter will contain the selected font, otherwise it will be ignored.

◆ show() [4/8]

static dialog_result xtd::forms::font_box::show ( xtd::drawing::font font,
const iwin32_window owner,
const font_box_options  options 
)
static

Displays a font dialog box in front of a specified window.

Parameters
fontAn output xtd::drawing::font that will store the selected font.
ownerAn xtd::forms::iwin32_window that represents the owner window of the font dialog box.
optionsA bitwise combination of enum xtd::forms::font_box_options to specify additional options to the font dialog box.
Returns
xtd::forms::dialog_result::ok if the user clicks OK in the dialog box; otherwise, xtd::forms::dialog_result::cancel.
Remarks
If xtd::forms::dialog_result is ok, the output font parameter will contain the selected font, otherwise it will be ignored.

◆ show() [5/8]

static dialog_result xtd::forms::font_box::show ( xtd::drawing::font font,
xtd::drawing::color color 
)
static

Displays a font dialog box.

Parameters
fontAn output xtd::drawing::font that will store the selected font.
colorAn output xtd::drawing::color that will store the selected font color.
Returns
xtd::forms::dialog_result::ok if the user clicks OK in the dialog box; otherwise, xtd::forms::dialog_result::cancel.
Remarks
If xtd::forms::dialog_result is xtd::forms::dialog_result::ok, the output parameters font and color will contain the selected font and color, otherwise they will be ignored.

◆ show() [6/8]

static dialog_result xtd::forms::font_box::show ( xtd::drawing::font font,
xtd::drawing::color color,
const font_box_options  options 
)
static

Displays a font dialog box.

Parameters
fontAn output xtd::drawing::font that will store the selected font.
colorAn output xtd::drawing::color that will store the selected font color.
optionsA bitwise combination of enum xtd::forms::font_box_options to specify additional options to the font dialog box.
Returns
xtd::forms::dialog_result::ok if the user clicks OK in the dialog box; otherwise, xtd::forms::dialog_result::cancel.
Remarks
If xtd::forms::dialog_result is xtd::forms::dialog_result::ok, the output parameters font and color will contain the selected font and color, otherwise they will be ignored.

◆ show() [7/8]

static dialog_result xtd::forms::font_box::show ( xtd::drawing::font font,
xtd::drawing::color color,
const iwin32_window owner 
)
static

Displays a font dialog box in front of a specified window.

Parameters
fontAn output xtd::drawing::font that will store the selected font.
colorAn output xtd::drawing::color that will store the selected font color.
ownerAn xtd::forms::iwin32_window that represents the owner window of the font dialog box.
Returns
xtd::forms::dialog_result::ok if the user clicks OK in the dialog box; otherwise, xtd::forms::dialog_result::cancel.
Remarks
If xtd::forms::dialog_result is xtd::forms::dialog_result::ok, the output parameters font and color will contain the selected font and color, otherwise they will be ignored.

◆ show() [8/8]

static dialog_result xtd::forms::font_box::show ( xtd::drawing::font font,
xtd::drawing::color color,
const iwin32_window owner,
const font_box_options  options 
)
static

Displays a font dialog box in front of a specified window.

Parameters
fontAn output xtd::drawing::font that will store the selected font.
colorAn output xtd::drawing::color that will store the selected font color.
ownerAn xtd::forms::iwin32_window that represents the owner window of the font dialog box.
optionsA bitwise combination of enum xtd::forms::font_box_options to specify additional options to the font dialog box.
Returns
xtd::forms::dialog_result::ok if the user clicks OK in the dialog box; otherwise, xtd::forms::dialog_result::cancel.
Remarks
If xtd::forms::dialog_result is xtd::forms::dialog_result::ok, the output parameters font and color will contain the selected font and color, otherwise they will be ignored.

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