measure_string() [7/7]

size_f xtd::drawing::graphics::measure_string	(	const xtd::string &	text,
		const xtd::drawing::font &	font,
		const xtd::drawing::size_f &	layout_area,
		const xtd::drawing::string_format &	format,
		size_t	characters_fitted,
		size_t	lines_filled
	)

Measures the specified string when drawn with the specified xtd::drawing::font and formatted with the specified xtd::drawing::string_format.

Parameters

text	xtd::string to measure.
font	xtd::drawing::font that defines the text format of the string.
layout_area	xtd::drawing::size_f structure that specifies the maximum layout area for the text.
format	xtd::drawing::string_format that represents formatting information, such as line spacing, for the string.
characters_fitted	Number of characters in the string.
lines_filled	Number of text lines in the string.

Remarks

The xtd::drawing::graphics::measure_string method is designed for use with individual strings and includes a small amount of extra space before and after the string to allow for overhanging glyphs. Also, the xtd::drawing::graphics::draw_string method adjusts glyph points to optimize display quality and might display a string narrower than reported byxtd::drawing::graphics::measure_string. To obtain metrics suitable for adjacent strings in layout (for example, when implementing formatted text), use the xtd::drawing::graphics::measure_character_ranges method or one of the xtd::drawing::graphics::measure_string methods that takes a xtd::drawing::string_format, and pass xtd::drawing::string_format::generic_typographic. Also, ensure the xtd::drawing::text::text_rendering_hint for the xtd::drawing::graphics is xtd::drawing::text::text_rendering_hint::anti_alias.