Represents a particular format for text, including font face, size, and style. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument. More...

#include <font.h>

Inherits System::Object.

Public Member Functions
	Font (const SharedPtr< Font > &prototype, FontStyle new_style)
	Constructs a new instance of Font class that represents the specified existing font with the specified font style. More...

	Font (const SharedPtr< FontFamily > &family, float em_size, FontStyle style, GraphicsUnit unit=GraphicsUnit::Point, uint8_t gdi_charset=1, bool gdi_vertical_font=false)
	Constructs a new instance of Font class. More...

	Font (const SharedPtr< FontFamily > &family, float em_size, GraphicsUnit unit=GraphicsUnit::Point)
	Constructs a new instance of Font class. More...

	Font (const String &family_name, float em_size, FontStyle style, GraphicsUnit unit=GraphicsUnit::Point, uint8_t gdi_charset=1, bool gdi_vertical_font=false)
	Constructs a new instance of Font class. More...

	Font (const String &family_name, float em_size, GraphicsUnit unit=GraphicsUnit::Point)
	Constructs a new instance of Font class. More...

float	GetHeight (const SharedPtr< Graphics > &graphics)
	Returns the line spacing of the font represented by the current object, in the current unit of a specified Graphics object. More...

float	GetHeight (float dpi=DEFAULT_FONT_OPERATIONS_DPI)
	Returns the height of the font represented by the current object when drawn to a display device with the specified vertical resolution. More...

String	get_Name ()
	Returns the face name of the font represented by the current object. More...

String	get_OriginalFontName ()
	Returns the originally specified name of the font. More...

SharedPtr< FontFamily >	get_FontFamily ()
	Returns the font family of the font represented by the current object. More...

FontStyle	get_FontStyle ()
	Returns the font style of the font represneted by the current object. More...

float	get_Size ()
	Returns the em size of the font represented by the current object measured in the units specified by the Unit property. More...

bool	get_Bold ()
	Determines if the font represented by the current object has the bold style applied. More...

bool	get_Italic ()
	Determines if the font represented by the current object has the italic style applied. More...

bool	get_Underline ()
	Determines if the font represented by the current object has the underline style applied. More...

bool	get_Strikeout ()
	Determines if the font represented by the current object has the strikeout style applied. More...

int	get_Height ()
	Returns the line spacing of the font represented by the current object in pixels. More...

float	get_SizeInPoints ()
	Returns the em size of the font represented by the current object in points. More...

uint8_t	get_GdiCharSet ()
	Returns a value that indicates the GDI character set used by the font represented by the current object. More...

GraphicsUnit	get_Unit ()
	Returns the measurement unit for the font represented by the current object. More...

FontStyle	get_Style ()
	Returns the font style of the font represented by the current object. More...

SharedPtr< Font >	Clone ()
	Returns a copy of the current font. More...

void	Dispose ()
	Releases all operating system resources acquired by the current object. More...

bool	Equals (System::SharedPtr< System::Object > obj) override
	Determines if the current and the specified objects are identical. More...

Public Member Functions inherited from System::Object
	Object ()
	Creates object. Initializes all internal data structures. More...

virtual	~Object ()
	Destroys object. Frees all internal data structures. More...

	Object (Object const &x)
	Copy constructor. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...

Object &	operator= (Object const &x)
	Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...

Object *	SharedRefAdded ()
	Increments shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...

int	SharedRefRemovedSafe ()
	Decrements and returns shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...

int	RemovedSharedRefs (int count)
	Decreases shared reference count by specified value. More...

Detail::SmartPtrCounter *	WeakRefAdded ()
	Increments weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...

void	WeakRefRemoved ()
	Decrements weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...

Detail::SmartPtrCounter *	GetCounter ()
	Gets reference counter data structure associated with the object. More...

int	SharedCount () const
	Gets current value of shared reference counter. More...

void	Lock ()
	Implements C# lock() statement locking. Call directly or use LockContext sentry object. More...

void	Unlock ()
	Implements C# lock() statement unlocking. Call directly or use LockContext sentry object. More...

virtual bool	Equals (ptr obj)
	Compares objects using C# Object.Equals semantics. More...

virtual int32_t	GetHashCode () const
	Analog of C# Object.GetHashCode() method. Enables hashing of custom objects. More...

virtual String	ToString () const
	Analog of C# Object.ToString() method. Enables converting custom objects to string. More...

virtual ptr	MemberwiseClone () const
	Analog of C# Object.MemberwiseClone() method. Enables cloning custom types. More...

virtual const TypeInfo &	GetType () const
	Gets actual type of object. Analog of C# System.Object.GetType() call. More...

virtual bool	Is (const TypeInfo &targetType) const
	Check if object represents an instance of type described by targetType. Analog of C# 'is' operator. More...

virtual void	SetTemplateWeakPtr (uint32_t argument)
	Set n'th template argument a weak pointer (rather than shared). Allows switching pointers in containers to weak mode. More...

virtual bool	FastCast (const Details::FastRttiBase &helper, void **out_ptr) const
	For internal purposes only. More...

template<>
bool	ReferenceEquals (String const &str, std::nullptr_t)
	Specialization of Object::ReferenceEquals for case of string and nullptr. More...

template<>
bool	ReferenceEquals (String const &str1, String const &str2)
	Specialization of Object::ReferenceEquals for case of strings. More...

Static Public Member Functions
static SharedPtr< Font >	FromLogFont (const SharedPtr< Object > &lf)
	NOT IMPLEMENTED. More...

Static Public Member Functions inherited from System::Object
static bool	ReferenceEquals (ptr const &objA, ptr const &objB)
	Compares objects by reference. More...

template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type	ReferenceEquals (T const &objA, T const &objB)
	Compares objects by reference. More...

template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type	ReferenceEquals (T const &objA, std::nullptr_t)
	Reference-compares value type object with nullptr. More...

template<typename T1 , typename T2 >
static std::enable_if< IsSmartPtr< T1 >::value &&IsSmartPtr< T2 >::value, bool >::type	Equals (T1 const &objA, T2 const &objB)
	Compares reference type objects in C# style. More...

template<typename T1 , typename T2 >
static std::enable_if<!IsSmartPtr< T1 >::value &&!IsSmartPtr< T2 >::value, bool >::type	Equals (T1 const &objA, T2 const &objB)
	Compares value type objects in C# style. More...

static const TypeInfo &	Type ()
	Implements C# typeof(System.Object) construct. More...

template<>
bool	Equals (float const &objA, float const &objB)
	Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...

template<>
bool	Equals (double const &objA, double const &objB)
	Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...

Additional Inherited Members
Public Types inherited from System::Object
typedef SmartPtr< Object >	ptr
	Alias for smart pointer type. More...

Detailed Description

Represents a particular format for text, including font face, size, and style. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument.

Constructor & Destructor Documentation

◆ Font() [1/5]

System::Drawing::Font::Font	(	const SharedPtr< Font > &	prototype,
		FontStyle	new_style
	)

Constructs a new instance of Font class that represents the specified existing font with the specified font style.

Parameters

prototype	The existing font to create the new one from
new_style	A font style to apply to the new font

◆ Font() [2/5]

System::Drawing::Font::Font	(	const SharedPtr< FontFamily > &	family,
		float	em_size,
		FontStyle	style,
		GraphicsUnit	unit = `GraphicsUnit::Point`,
		uint8_t	gdi_charset = `1`,
		bool	gdi_vertical_font = `false`
	)

Constructs a new instance of Font class.

Parameters

family	The font family of the new font
em_size	The em size of the new font in the units specified by `unit` parameter
style	The style of the new font
unit	The measurement units of the new font
gdi_charset	A GDI charset to be used for the new font
gdi_vertical_font	True if the new font is derived from a GDI vertical font

◆ Font() [3/5]

System::Drawing::Font::Font	(	const SharedPtr< FontFamily > &	family,
		float	em_size,
		GraphicsUnit	unit = `GraphicsUnit::Point`
	)

Constructs a new instance of Font class.

Parameters

family	The font family of the new font
em_size	The em size of the new font in the units specified by `unit` parameter
unit	The measurement units of the new font

◆ Font() [4/5]

System::Drawing::Font::Font	(	const String &	family_name,
		float	em_size,
		FontStyle	style,
		GraphicsUnit	unit = `GraphicsUnit::Point`,
		uint8_t	gdi_charset = `1`,
		bool	gdi_vertical_font = `false`
	)

Constructs a new instance of Font class.

Parameters

family_name	The name of the new font's font family
em_size	The em size of the new font in the units specified by `unit` parameter
style	The style of the new font
unit	The measurement units of the new font
gdi_charset	A GDI charset to be used for the new font
gdi_vertical_font	True if the new font is derived from a GDI vertical font

◆ Font() [5/5]

System::Drawing::Font::Font	(	const String &	family_name,
		float	em_size,
		GraphicsUnit	unit = `GraphicsUnit::Point`
	)

Constructs a new instance of Font class.

Parameters

family_name	The name of the new font's font family
em_size	The em size of the new font in the units specified by `unit` parameter
unit	The measurement units of the new font

Member Function Documentation

◆ Clone()

SharedPtr< Font > System::Drawing::Font::Clone ( )

Returns a copy of the current font.

◆ Dispose()

void System::Drawing::Font::Dispose ( )

inline

Releases all operating system resources acquired by the current object.

◆ Equals()

bool System::Drawing::Font::Equals ( System::SharedPtr< System::Object > obj )

override

Determines if the current and the specified objects are identical.

Parameters

obj	An object to compare the current object with

Returns: True if the current and the specified objects are identical, otherwise - false

◆ FromLogFont()

static SharedPtr< Font > System::Drawing::Font::FromLogFont ( const SharedPtr< Object > & lf )

static

NOT IMPLEMENTED.

Exceptions

NotImplementedException Always

◆ get_Bold()

bool System::Drawing::Font::get_Bold ( )

Determines if the font represented by the current object has the bold style applied.

◆ get_FontFamily()

SharedPtr< FontFamily > System::Drawing::Font::get_FontFamily ( )

Returns the font family of the font represented by the current object.

◆ get_FontStyle()

FontStyle System::Drawing::Font::get_FontStyle ( )

Returns the font style of the font represneted by the current object.

◆ get_GdiCharSet()

uint8_t System::Drawing::Font::get_GdiCharSet ( )

Returns a value that indicates the GDI character set used by the font represented by the current object.

◆ get_Height()

int System::Drawing::Font::get_Height ( )

Returns the line spacing of the font represented by the current object in pixels.

◆ get_Italic()

bool System::Drawing::Font::get_Italic ( )

Determines if the font represented by the current object has the italic style applied.

◆ get_Name()

String System::Drawing::Font::get_Name ( )

Returns the face name of the font represented by the current object.

◆ get_OriginalFontName()

String System::Drawing::Font::get_OriginalFontName ( )

Returns the originally specified name of the font.

◆ get_Size()

float System::Drawing::Font::get_Size ( )

Returns the em size of the font represented by the current object measured in the units specified by the Unit property.

◆ get_SizeInPoints()

float System::Drawing::Font::get_SizeInPoints ( )

Returns the em size of the font represented by the current object in points.

◆ get_Strikeout()

bool System::Drawing::Font::get_Strikeout ( )

Determines if the font represented by the current object has the strikeout style applied.

◆ get_Style()

FontStyle System::Drawing::Font::get_Style ( )

inline

Returns the font style of the font represented by the current object.

◆ get_Underline()

bool System::Drawing::Font::get_Underline ( )

Determines if the font represented by the current object has the underline style applied.

◆ get_Unit()

GraphicsUnit System::Drawing::Font::get_Unit ( )

Returns the measurement unit for the font represented by the current object.

◆ GetHeight() [1/2]

float System::Drawing::Font::GetHeight ( const SharedPtr< Graphics > & graphics )

Returns the line spacing of the font represented by the current object, in the current unit of a specified Graphics object.

Parameters

graphics A Graphics object that specifies the measurement units

◆ GetHeight() [2/2]

float System::Drawing::Font::GetHeight ( float dpi = DEFAULT_FONT_OPERATIONS_DPI )

Returns the height of the font represented by the current object when drawn to a display device with the specified vertical resolution.

Parameters

dpi	The vertical resolution of the display device

Returns: The hegiht of the font in pixels

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Font() [1/5]

◆ Font() [2/5]

◆ Font() [3/5]

◆ Font() [4/5]

◆ Font() [5/5]

Member Function Documentation

◆ Clone()

◆ Dispose()

◆ Equals()

◆ FromLogFont()

◆ get_Bold()

◆ get_FontFamily()

◆ get_FontStyle()

◆ get_GdiCharSet()

◆ get_Height()

◆ get_Italic()

◆ get_Name()

◆ get_OriginalFontName()

◆ get_Size()

◆ get_SizeInPoints()

◆ get_Strikeout()

◆ get_Style()

◆ get_Underline()

◆ get_Unit()

◆ GetHeight() [1/2]

◆ GetHeight() [2/2]