xtd 0.2.0
Loading...
Searching...
No Matches
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.h>

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

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

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.h>

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

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

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

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

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.