xtd::forms::font_box Class Reference

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	html dialog_font_dialog_m.png    html dialog_font_dialog_g.png
Dark	html dialog_font_dialog_md.png    html dialog_font_dialog_gd.png

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(ustring::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(ustring::format("Selected font is: {}\ncolor: {}", font, color));
    };
  }
  
private:
  button button_font;
  button button_font_and_color;
};

auto main()->int {
  application::run(form1 {});
}

Methods
static dialog_result	show (xtd::drawing::font &font)
	Displays a font dialog box. More...
static dialog_result	show (xtd::drawing::font &font, const font_box_options options)
	Displays a font dialog box. More...
static dialog_result	show (xtd::drawing::font &font, const iwin32_window &owner)
	Displays a font dialog box in front of a specified window. More...
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. More...
static dialog_result	show (xtd::drawing::font &font, xtd::drawing::color &color)
	Displays a font dialog box. More...
static dialog_result	show (xtd::drawing::font &font, xtd::drawing::color &color, const font_box_options options)
	Displays a font dialog box. More...
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. More...
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. More...

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

font	An 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

font	An output xtd::drawing::font that will store the selected font.
options	A 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

font	An output xtd::drawing::font that will store the selected font.
owner	An 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

font	An output xtd::drawing::font that will store the selected font.
owner	An xtd::forms::iwin32_window that represents the owner window of the font dialog box.
options	A 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

font	An output xtd::drawing::font that will store the selected font.
color	An 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

font	An output xtd::drawing::font that will store the selected font.
color	An output xtd::drawing::color that will store the selected font color.
options	A 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

font	An output xtd::drawing::font that will store the selected font.
color	An output xtd::drawing::color that will store the selected font color.
owner	An 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

font	An output xtd::drawing::font that will store the selected font.
color	An output xtd::drawing::color that will store the selected font color.
owner	An xtd::forms::iwin32_window that represents the owner window of the font dialog box.
options	A 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:

• xtd.forms/include/xtd/forms/font_box.h