xtd 0.2.0
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 {});
}
static void run()
Begins running a standard application message loop on the current thread, without a form.
virtual const drawing::size & client_size() const noexcept
Gets the height and width of the client area of the control.
virtual drawing::font font() const noexcept
Gets the font of the text displayed by the control.
virtual control_collection & controls() noexcept
Gets the collection of controls contained within the control.
static dialog_result show(xtd::drawing::font &font)
Displays a font dialog box.
Represents a window or dialog box that makes up an application's user interface.
Definition form.hpp:54
virtual void push_back_range(const arranged_element_collection &collection)
Adds elements to the end.
Definition arranged_element_collection.hpp:393
static dialog_result show()
Displays a message box.
xtd::forms::style_sheets::control button
The buttton data allows you to specify the box of a button control.
Definition button.hpp:25
@ text
The xtd::forms::status_bar_panel displays text in the standard font.
Definition status_bar_panel_style.hpp:25
The xtd::drawing namespace provides access to GDI+ basic graphics functionality. More advanced functi...
Definition actions_system_images.hpp:10
The xtd::forms namespace contains classes for creating Windows-based applications that take full adva...
Definition texts.hpp:217
The xtd namespace contains all fundamental classes to access Hardware, Os, System,...
Definition abstract_object.hpp:8

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: