#include <font_family.h>

Definition

Defines a group of type faces having a similar basic design and certain variations in styles. This class cannot be inherited.

Namespace: xtd::drawing

Library: xtd.drawing

Inherits xtd::object.

Public Member Functions
	font_family (const xtd::ustring &name)
	Initializes a new xtd::drawing::font_family with the specified name.

	font_family (const xtd::ustring &name, const text::font_collection &font_collection)
	Initializes a new xtd::drawing::font_family in the specified font_collection with the specified name.

	font_family (text::generic_font_families generic_font_families)
	Initializes a new xtd::drawing::font_family from the specified generic font family.

int32_t	get_cell_ascent (font_style style) const
	Returns the cell ascent, in design units, of the font_family of the specified style.

int32_t	get_cell_descent (font_style style) const
	Returns the cell descent, in design units, of the font_family of the specified style.

int32_t	get_em_height (font_style style) const
	Gets the height, in font design units, of the em square for the specified style.

int32_t	get_line_spacing (font_style style) const
	Returns the line spacing, in design units, of the font_family of the specified style. The line spacing is the vertical distance between the base lines of two consecutive lines of text.

xtd::ustring	get_name (int32_t language) const
	Returns the name, in the specified language, of this font_family.

bool	is_style_available (font_style style) const
	Indicates whether the specified font_style enumeration is available.

const xtd::ustring &	name () const
	Gets the name of this font_family.

xtd::ustring	to_string () const noexcept override
	Converts this font_family to a human-readable string representation.

Public Member Functions inherited from xtd::object
	object ()=default
	Create a new instance of the ultimate base class object.

virtual bool	equals (const object &obj) const noexcept
	Determines whether the specified object is equal to the current object.

virtual size_t	get_hash_code () const noexcept
	Serves as a hash function for a particular type.

template<typename object_t >
std::unique_ptr< object_t >	memberwise_clone () const
	Gets the type of the current instance.

virtual xtd::ustring	to_string () const noexcept
	Returns a std::string that represents the current object.

Static Public Member Functions
static std::vector< font_family >	families ()
	Returns an array that contains all the font_family objects associated with the current graphics context.

static font_family	generic_monospace ()
	Gets a generic monospace font_family.

static font_family	generic_sans_serif ()
	Gets a generic sans serif font_family.

static font_family	generic_serif ()
	Gets a generic serif font_family.

Static Public Member Functions inherited from xtd::object
static bool	equals (const object &object_a, const object &object_b) noexcept
	Determines whether the specified object instances are considered equal.

static bool	reference_equals (const object &object_a, const object &object_b) noexcept
	Determines whether the specified object instances are the same instance.

Constructor & Destructor Documentation

◆ font_family() [1/3]

xtd::drawing::font_family::font_family ( const xtd::ustring & name )

Initializes a new xtd::drawing::font_family with the specified name.

Parameters

name	The name of the new xtd::drawing::font_family.

Exceptions

std::invalid_argument name is an empty string ("") - or - name specifies a font that is not installed on the computer running the application.

◆ font_family() [2/3]

xtd::drawing::font_family::font_family ( text::generic_font_families generic_font_families )

Initializes a new xtd::drawing::font_family from the specified generic font family.

Parameters

generic_font_families The xtd::drawing::text::generic_font_families from which to create the new font_family.

◆ font_family() [3/3]

xtd::drawing::font_family::font_family	(	const xtd::ustring &	name,
		const text::font_collection &	font_collection
	)

Initializes a new xtd::drawing::font_family in the specified font_collection with the specified name.

Parameters

name	The name of the new xtd::drawing::font_family.
font_collection	The FontCollection that contains this FontFamily.

Exceptions

std::invalid_argument name is an empty string ("") - or - name specifies a font that is not installed on the computer running the application - or - name specifies a font that is not a part of specified font_collection..

Member Function Documentation

◆ families()

static std::vector< font_family > xtd::drawing::font_family::families ( )

static

Returns an array that contains all the font_family objects associated with the current graphics context.

Returns: An array of font_family objects associated with the current graphics context.

◆ generic_monospace()

static font_family xtd::drawing::font_family::generic_monospace ( )

inlinestatic

Gets a generic monospace font_family.

Returns: A font_family that represents a generic monospace font.

◆ generic_sans_serif()

static font_family xtd::drawing::font_family::generic_sans_serif ( )

inlinestatic

Gets a generic sans serif font_family.

Returns: A font_family that represents a generic sans serif font.

◆ generic_serif()

static font_family xtd::drawing::font_family::generic_serif ( )

inlinestatic

Gets a generic serif font_family.

Returns: A font_family that represents a generic serif font.

◆ get_cell_ascent()

int32_t xtd::drawing::font_family::get_cell_ascent ( font_style style ) const

Returns the cell ascent, in design units, of the font_family of the specified style.

Parameters

style A font_style that contains style information for the font.

Returns: The cell ascent for this font_family that uses the specified font_style.

◆ get_cell_descent()

int32_t xtd::drawing::font_family::get_cell_descent ( font_style style ) const

Returns the cell descent, in design units, of the font_family of the specified style.

Parameters

style A font_style that contains style information for the font.

Returns: The cell ascent for this font_family that uses the specified font_style.

◆ get_em_height()

int32_t xtd::drawing::font_family::get_em_height ( font_style style ) const

Gets the height, in font design units, of the em square for the specified style.

Parameters

style A font_style that contains style information for the font.

Returns: The height of the em square.

◆ get_line_spacing()

int32_t xtd::drawing::font_family::get_line_spacing ( font_style style ) const

Returns the line spacing, in design units, of the font_family of the specified style. The line spacing is the vertical distance between the base lines of two consecutive lines of text.

Parameters

style A font_style that contains style information for the font.

Returns: The distance between two consecutive lines of text.

◆ get_name()

xtd::ustring xtd::drawing::font_family::get_name ( int32_t language ) const

Returns the name, in the specified language, of this font_family.

Parameters

language The language in which the name is returned.

Returns: A String that represents the name, in the specified language, of this font_family.

Remarks: To indicate language neutral, you should specify 0 for the language parameter. For a listing of the available languages and sublanguages, see the Winnt.h header file. If you have Visual Studio installed, this header file can typically be found relative to the Visual Studio installation directory at \VC\PlatformSDK\Include.

◆ is_style_available()

bool xtd::drawing::font_family::is_style_available ( font_style style ) const

Indicates whether the specified font_style enumeration is available.

Parameters

style The font_style to test.

Returns: true if the specified font_style is available; otherwise, false.

◆ name()

const xtd::ustring & xtd::drawing::font_family::name ( ) const

inline

Gets the name of this font_family.

Returns: A String that represents the name of this font_family.

◆ to_string()

xtd::ustring xtd::drawing::font_family::to_string ( ) const

inlineoverridevirtualnoexcept

Converts this font_family to a human-readable string representation.

Returns: The string that represents this font_family.

Reimplemented from xtd::object.

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

xtd.drawing/include/xtd/drawing/font_family.h

Definition

Public Member Functions

Static Public Member Functions

Constructor & Destructor Documentation

◆ font_family() [1/3]

◆ font_family() [2/3]

◆ font_family() [3/3]

Member Function Documentation

◆ families()

◆ generic_monospace()

◆ generic_sans_serif()

◆ generic_serif()

◆ get_cell_ascent()

◆ get_cell_descent()

◆ get_em_height()

◆ get_line_spacing()

◆ get_name()

◆ is_style_available()

◆ name()

◆ to_string()