The glyph rendering flags indicate GetGlyphsExtentFromUChars and CreateLayout how to lay out the text:
- The writing mode (horizontal or vertical) and the glyph orientation;
- The indentation mode (none, first line or hanging);
- Whether and how to break if the line overflows the max extent;
- Whether and how to ellipsize if the line overflows the max extent;
- The alignment of lines;
- Whether and how to adjust the glyph position for alignment of justify;
- The hanging punctation method;
- Remove or hange the spaces at the start and/or end of the line.
◆ GRF_ALIGN_CENTER
| #define GRF_ALIGN_CENTER 0x00004000 |
Text content is centered within the line box.
Definition at line 12689 of file gdi.h.
◆ GRF_ALIGN_END
| #define GRF_ALIGN_END 0x00001000 |
Text content is aligned to the end edge of the line box.
Definition at line 12675 of file gdi.h.
◆ GRF_ALIGN_JUSTIFY
| #define GRF_ALIGN_JUSTIFY 0x00005000 |
All lines will be justified according to the method specified by GRF_TEXT_JUSTIFY_XXX, in order to exactly fill the line box.
If you specify only a valid justification method (not GRF_TEXT_JUSTIFY_NONE) without GRF_ALIGN_JUSTIFY, the last line will not be justified.
Definition at line 12697 of file gdi.h.
◆ GRF_ALIGN_LEFT
| #define GRF_ALIGN_LEFT 0x00002000 |
Text content is aligned to the line left edge of the line box. In vertical writing modes, this will be the physical top edge.
Definition at line 12680 of file gdi.h.
◆ GRF_ALIGN_RIGHT
| #define GRF_ALIGN_RIGHT 0x00003000 |
Text content is aligned to the line right edge of the line box. In vertical writing modes, this will be the physical bottom edge.
Definition at line 12685 of file gdi.h.
◆ GRF_ALIGN_START
| #define GRF_ALIGN_START 0x00000000 |
Text content is aligned to the start edge of the line box.
Definition at line 12671 of file gdi.h.
◆ GRF_HANGING_PUNC_ALLOW_END
| #define GRF_HANGING_PUNC_ALLOW_END 0x00000020 |
A stop or comma at the end of a line hangs if it does not otherwise fit prior to justification.
Definition at line 12733 of file gdi.h.
◆ GRF_HANGING_PUNC_CLOSE
| #define GRF_HANGING_PUNC_CLOSE 0x00000080 |
An closing bracket or quote at the end of the line hangs.
Definition at line 12741 of file gdi.h.
◆ GRF_HANGING_PUNC_FORCE_END
| #define GRF_HANGING_PUNC_FORCE_END 0x00000010 |
A stop or comma at the end of a line hangs.
Definition at line 12728 of file gdi.h.
◆ GRF_HANGING_PUNC_NONE
| #define GRF_HANGING_PUNC_NONE 0x00000000 |
No character hangs.
Definition at line 12724 of file gdi.h.
◆ GRF_HANGING_PUNC_OPEN
| #define GRF_HANGING_PUNC_OPEN 0x00000040 |
An opening bracket or quote at the start of the line hangs.
Definition at line 12737 of file gdi.h.
◆ GRF_INDENT_FIRST_LINE
| #define GRF_INDENT_FIRST_LINE 0x00100000 |
The first line is indented.
Definition at line 12627 of file gdi.h.
◆ GRF_INDENT_HANGING
| #define GRF_INDENT_HANGING 0x00200000 |
Indent all the lines of a paragraph except the first line.
Definition at line 12631 of file gdi.h.
◆ GRF_INDENT_NONE
| #define GRF_INDENT_NONE 0x00000000 |
No indentation.
Definition at line 12623 of file gdi.h.
◆ GRF_LINE_EXTENT_FIXED
| #define GRF_LINE_EXTENT_FIXED 0x00000000 |
The maximal line extent is fixed. The maximal line extent value you passed to LayoutNextLine will be ignored.
Definition at line 12611 of file gdi.h.
◆ GRF_LINE_EXTENT_VARIABLE
| #define GRF_LINE_EXTENT_VARIABLE 0x00400000 |
The maximal line extent is variable. You should pass the desired maximal line extent value for a new line when calling LayoutNextLine. The intent mode will be ignored as well.
Definition at line 12617 of file gdi.h.
◆ GRF_OVERFLOW_ELLIPSIZE_END
| #define GRF_OVERFLOW_ELLIPSIZE_END 0x00030000 |
Omit characters at the end of the text
Definition at line 12665 of file gdi.h.
◆ GRF_OVERFLOW_ELLIPSIZE_MIDDLE
| #define GRF_OVERFLOW_ELLIPSIZE_MIDDLE 0x00020000 |
Omit characters in the middle of the text
Definition at line 12661 of file gdi.h.
◆ GRF_OVERFLOW_ELLIPSIZE_NONE
| #define GRF_OVERFLOW_ELLIPSIZE_NONE 0x00000000 |
No ellipsization
Definition at line 12653 of file gdi.h.
◆ GRF_OVERFLOW_ELLIPSIZE_START
| #define GRF_OVERFLOW_ELLIPSIZE_START 0x00010000 |
Omit characters at the start of the text
Definition at line 12657 of file gdi.h.
◆ GRF_OVERFLOW_WRAP_ANYWHERE
| #define GRF_OVERFLOW_WRAP_ANYWHERE 0x00080000 |
An otherwise unbreakable sequence of characters may be broken at an arbitrary point if there are no otherwise-acceptable break points in the line.
Definition at line 12647 of file gdi.h.
◆ GRF_OVERFLOW_WRAP_BREAK_WORD
| #define GRF_OVERFLOW_WRAP_BREAK_WORD 0x00040000 |
Lines may break only at word seperators.
Definition at line 12641 of file gdi.h.
◆ GRF_OVERFLOW_WRAP_NORMAL
| #define GRF_OVERFLOW_WRAP_NORMAL 0x00000000 |
Lines may break only at allowed break points.
Definition at line 12637 of file gdi.h.
◆ GRF_SPACES_HANGE_END
| #define GRF_SPACES_HANGE_END 0x00000004 |
A sequence of spaces at the end of a line hangs.
Definition at line 12759 of file gdi.h.
◆ GRF_SPACES_KEEP
| #define GRF_SPACES_KEEP 0x00000000 |
All spaces are kept.
Definition at line 12747 of file gdi.h.
◆ GRF_SPACES_REMOVE_END
| #define GRF_SPACES_REMOVE_END 0x00000002 |
A sequence of spaces at the end of a line is removed.
Definition at line 12755 of file gdi.h.
◆ GRF_SPACES_REMOVE_START
| #define GRF_SPACES_REMOVE_START 0x00000001 |
A sequence of spaces at the start of a line is removed.
Definition at line 12751 of file gdi.h.
◆ GRF_TEXT_JUSTIFY_AUTO
| #define GRF_TEXT_JUSTIFY_AUTO 0x00000100 |
Justification adjusts primarily the spacing at word separators and between CJK typographic letter units along with secondarily between Southeast Asian typographic letter units.
Definition at line 12709 of file gdi.h.
◆ GRF_TEXT_JUSTIFY_INTER_CHAR
| #define GRF_TEXT_JUSTIFY_INTER_CHAR 0x00000300 |
Justification adjusts spacing between each pair of adjacent typographic character units.
Definition at line 12718 of file gdi.h.
◆ GRF_TEXT_JUSTIFY_INTER_WORD
| #define GRF_TEXT_JUSTIFY_INTER_WORD 0x00000200 |
Justification adjusts spacing at word separators only.
Definition at line 12713 of file gdi.h.
◆ GRF_TEXT_JUSTIFY_NONE
| #define GRF_TEXT_JUSTIFY_NONE 0x00000000 |
Do not justify.
Definition at line 12703 of file gdi.h.
◆ GRF_TEXT_ORIENTATION_AUTO
| #define GRF_TEXT_ORIENTATION_AUTO 0x04000000 |
In vertical writing modes, all typographic character units keep in their intrinsic orientation.
Definition at line 12593 of file gdi.h.
◆ GRF_TEXT_ORIENTATION_MIXED
| #define GRF_TEXT_ORIENTATION_MIXED 0x05000000 |
In vertical writing modes, typographic character units from horizontal-only scripts are typeset sideways, i.e. 90° clockwise from their standard orientation in horizontal text. Typographic character units from vertical scripts are typeset with their intrinsic orientation.
Definition at line 12601 of file gdi.h.
◆ GRF_TEXT_ORIENTATION_SIDEWAYS
| #define GRF_TEXT_ORIENTATION_SIDEWAYS 0x01000000 |
The glyphs typeset a run rotated 90° clockwise from their upright orientation.
Definition at line 12578 of file gdi.h.
◆ GRF_TEXT_ORIENTATION_SIDEWAYS_LEFT
| #define GRF_TEXT_ORIENTATION_SIDEWAYS_LEFT 0x03000000 |
The glyphs typeset a run rotated 90° counter-clockwise from their upright orientation.
Definition at line 12588 of file gdi.h.
◆ GRF_TEXT_ORIENTATION_UPRIGHT
| #define GRF_TEXT_ORIENTATION_UPRIGHT 0x00000000 |
The glyphs are individually typeset upright in vertical lines with vertical font metrics.
Definition at line 12573 of file gdi.h.
◆ GRF_TEXT_ORIENTATION_UPSIDE_DOWN
| #define GRF_TEXT_ORIENTATION_UPSIDE_DOWN 0x02000000 |
The glyphs are individually typeset upside down in vertical lines with vertical font metrics.
Definition at line 12583 of file gdi.h.
◆ GRF_WRITING_MODE_HORIZONTAL_BT
| #define GRF_WRITING_MODE_HORIZONTAL_BT 0x10000000 |
Bottom-to-top horizontal direction. Both the writing mode and the typographic mode are horizontal, but lines are generated from bottom to top.
Definition at line 12554 of file gdi.h.
◆ GRF_WRITING_MODE_HORIZONTAL_TB
| #define GRF_WRITING_MODE_HORIZONTAL_TB 0x00000000 |
Top-to-bottom horizontal direction. Both the writing mode and the typographic mode are horizontal.
Definition at line 12548 of file gdi.h.
◆ GRF_WRITING_MODE_VERTICAL_LR
| #define GRF_WRITING_MODE_VERTICAL_LR 0x30000000 |
Left-to-right vertical direction. Both the writing mode and the typographic mode are vertical. but the lines are generated from left to right.
Definition at line 12566 of file gdi.h.
◆ GRF_WRITING_MODE_VERTICAL_RL
| #define GRF_WRITING_MODE_VERTICAL_RL 0x20000000 |
Right-to-left vertical direction. Both the writing mode and the typographic mode are vertical, but the lines are generated from right to left.
Definition at line 12560 of file gdi.h.
