texts

Definition

Contains texts definitions.

Classes
class	xtd::drawing::string_format
	Encapsulates text layout information (such as alignment, orientation and tab stops) display manipulations (such as ellipsis insertion and national digit substitution) and OpenType features. This class cannot be inherited. More...
class	xtd::drawing::texts
	Provides a collection of string objects for use by a Windows Forms application. More...

Enumerations
enum class	xtd::drawing::string_alignment {   xtd::drawing::string_alignment::near ,   xtd::drawing::string_alignment::center ,   xtd::drawing::string_alignment::far }
	Specifies the alignment of a text string relative to its layout rectangle. More...
enum class	xtd::drawing::string_format_flags {   xtd::drawing::string_format_flags::direction_right_to_left ,   xtd::drawing::string_format_flags::direction_vertical ,   xtd::drawing::string_format_flags::fit_black_box ,   xtd::drawing::string_format_flags::display_format_control ,   xtd::drawing::string_format_flags::no_font_fallback ,   xtd::drawing::string_format_flags::measure_trailing_spaces ,   xtd::drawing::string_format_flags::no_wrap ,   xtd::drawing::string_format_flags::line_limit ,   xtd::drawing::string_format_flags::no_clip }
	Specifies the display and layout information for text strings. This enumeration allows a bitwise combination of its member values. More...
enum class	xtd::drawing::string_trimming {   xtd::drawing::string_trimming::none ,   xtd::drawing::string_trimming::character ,   xtd::drawing::string_trimming::word ,   xtd::drawing::string_trimming::ellipsis_character ,   xtd::drawing::string_trimming::ellipsis_word ,   xtd::drawing::string_trimming::ellipsis_path }
	Specifies how to trim characters from a string that does not completely fit into a layout shape. More...
enum class	xtd::drawing::text::hotkey_prefix {   xtd::drawing::text::hotkey_prefix::none ,   xtd::drawing::text::hotkey_prefix::show ,   xtd::drawing::text::hotkey_prefix::hide }
	Specifies the type of display for hot-key prefixes that relate to text. More...
enum class	xtd::drawing::text::text_rendering_hint {   xtd::drawing::text::text_rendering_hint::system_default ,   xtd::drawing::text::text_rendering_hint::single_bit_per_pixel_grid_fit ,   xtd::drawing::text::text_rendering_hint::single_bit_per_pixel ,   xtd::drawing::text::text_rendering_hint::anti_alias_grid_fit ,   xtd::drawing::text::text_rendering_hint::anti_alias ,   xtd::drawing::text::text_rendering_hint::clear_type_grid_fit }
	Specifies the quality of text rendering. More...

Enumeration Type Documentation

string_alignment

enum class xtd::drawing::string_alignment

strong

#include <xtd.drawing/include/xtd/drawing/string_alignment.hpp>

Specifies the alignment of a text string relative to its layout rectangle.

Namespace

xtd::drawing

Library

xtd.drawing

Remarks

When used with the line_alignment property, this enumeration sets the vertical alignment for a drawn string. When used with the alignment property, this enumeration sets the horizontal alignment.

Enumerator
near	Specifies the text be aligned near the layout. In a left-to-right layout, the near position is left. In a right-to-left layout, the near position is right.
center	Specifies that text is aligned in the center of the layout rectangle.
far	Specifies that text is aligned far from the origin position of the layout rectangle. In a left-to-right layout, the far position is right. In a right-to-left layout, the far position is left.

string_format_flags

enum class xtd::drawing::string_format_flags

strong

#include <xtd.drawing/include/xtd/drawing/string_format_flags.hpp>

Specifies the display and layout information for text strings. This enumeration allows a bitwise combination of its member values.

Namespace

xtd::drawing

Library

xtd.drawing

Enumerator
direction_right_to_left	Text is displayed from right to left. text.
direction_vertical	Text is vertically aligned.
fit_black_box	Parts of characters are allowed to overhang the string's layout rectangle. By default, characters are repositioned to avoid any overhang.
display_format_control	Control characters such as the left-to-right mark are shown in the output with a representative glyph.
no_font_fallback	Fallback to alternate fonts for characters not supported in the requested font is disabled. Any missing characters are displayed with the fonts missing glyph, usually an open square.
measure_trailing_spaces	Includes the trailing space at the end of each line. By default the boundary rectangle returned by the MeasureString method excludes the space at the end of each line. Set this flag to include that space in measurement.
no_wrap	Text wrapping between lines when formatting within a rectangle is disabled. This flag is implied when a point is passed instead of a rectangle, or when the specified rectangle has a zero line length.
line_limit	Only entire lines are laid out in the formatting rectangle. By default layout continues until the end of the text, or until no more lines are visible as a result of clipping, whichever comes first. Note that the default settings allow the last line to be partially obscured by a formatting rectangle that is not a whole multiple of the line height. To ensure that only whole lines are seen, specify this value and be careful to provide a formatting rectangle at least as tall as the height of one line.
no_clip	Overhanging parts of glyphs, and unwrapped text reaching outside the formatting rectangle are allowed to show. By default all text and glyph parts reaching outside the formatting rectangle are clipped.

string_trimming

enum class xtd::drawing::string_trimming

strong

#include <xtd.drawing/include/xtd/drawing/string_trimming.hpp>

Specifies how to trim characters from a string that does not completely fit into a layout shape.

Namespace

xtd::drawing

Library

xtd.drawing

Enumerator
none	Specifies no trimming.
character	Specifies that the text is trimmed to the nearest character.
word	Specifies that text is trimmed to the nearest word.
ellipsis_character	Specifies that the text is trimmed to the nearest character, and an ellipsis is inserted at the end of a trimmed line.
ellipsis_word	Specifies that text is trimmed to the nearest word, and an ellipsis is inserted at the end of a trimmed line.
ellipsis_path	The center is removed from trimmed lines and replaced by an ellipsis. The algorithm keeps as much of the last slash-delimited segment of the line as possible.

hotkey_prefix

enum class xtd::drawing::text::hotkey_prefix

strong

#include <xtd.drawing/include/xtd/drawing/text/hotkey_prefix.hpp>

Specifies the type of display for hot-key prefixes that relate to text.

Namespace

xtd::drawing::text

Library

xtd.drawing

Remarks

A hot-key prefix allows you to use a keyboard combination (usually CTRL+HotKey or ALT+HotKey) to access functionality represented by text displayed on the screen.

Enumerator
none	No hot-key prefix.
show	Display the hot-key prefix.
hide	Do not display the hot-key prefix.

text_rendering_hint

enum class xtd::drawing::text::text_rendering_hint

strong

#include <xtd.drawing/include/xtd/drawing/text/text_rendering_hint.hpp>

Specifies the quality of text rendering.

Namespace

xtd::drawing::text

Library

xtd.drawing

Remarks

The quality ranges from text (fastest performance, but lowest quality) to antialiased text (better quality, but slower performance) to ClearType text (best quality on an LCD display).

Enumerator
system_default	Each character is drawn using its glyph bitmap, with the system default rendering hint. The text will be drawn using whatever font-smoothing settings the user has selected for the system.
single_bit_per_pixel_grid_fit	Each character is drawn using its glyph bitmap. Hinting is used to improve character appearance on stems and curvature.
single_bit_per_pixel	Each character is drawn using its glyph bitmap. Hinting is not used.
anti_alias_grid_fit	Each character is drawn using its antialiased glyph bitmap with hinting. Much better quality due to antialiasing, but at a higher performance cost.
anti_alias	Each character is drawn using its antialiased glyph bitmap without hinting. Better quality due to antialiasing. Stem width differences may be noticeable because hinting is turned off.
clear_type_grid_fit	Each character is drawn using its glyph ClearType bitmap with hinting. The highest quality setting. Used to take advantage of ClearType font features.