TextFormatFlags Výčet
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Určuje informace o zobrazení a rozložení pro textové řetězce.
Tento výčet podporuje bitové kombinace hodnot jeho členů.
public enum class TextFormatFlags
[System.Flags]
public enum TextFormatFlags
[<System.Flags>]
type TextFormatFlags =
Public Enum TextFormatFlags
- Dědičnost
- Atributy
Pole
Bottom | 8 | Zarovná text v dolní části ohraničujícího obdélníku. Použije se jenom v případech, kdy je text jeden řádek. |
Default | 0 | Použije výchozí formátování, které je zarovnané doleva. |
EndEllipsis | 32768 | Odebere konec oříznutých čar a nahradí je třemi tečkami. Při použití k kreslení textu pomocí |
ExpandTabs | 64 | Rozbalí znaky tabulátoru. Výchozí počet znaků na tabulátoru je osm. Hodnoty WordEllipsis, PathEllipsisa EndEllipsis nelze použít s ExpandTabs. |
ExternalLeading | 512 | Zahrne externí inkaso písma ve výšce řádku. Externí úvodní položka obvykle není zahrnuta do výšky řádku textu. |
GlyphOverhangPadding | 0 | Přidá odsazení do ohraničujícího obdélníku, aby bylo možné umístit převislé glyfy. Tato možnost je výchozí. |
HidePrefix | 1048576 | Ignoruje znak předpony ampersandu (&) v textu, takže písmeno, které následuje, nebude podtrženo, ale ostatní mnemonické znaky předpony se stále zpracovávají. |
HorizontalCenter | 1 | Zarovná text vodorovně do ohraničujícího obdélníku. |
Internal | 4096 | K výpočtu metrik textu používá systémové písmo. |
Left | 0 | Zarovná text na levé straně oblasti výřezu. Tato možnost je výchozí. |
LeftAndRightPadding | 536870912 | Přidá odsazení na obě strany ohraničujícího obdélníku. |
ModifyString | 65536 | Nemá žádný vliv na nakreslený text nebo rozměry textu. Při použití k kreslení textu pomocí |
NoClipping | 256 | Umožňuje zobrazit převislé části glyfů a nezabalený text, které se nacházejí mimo formátovací obdélník. |
NoFullWidthCharacterBreak | 524288 | Starší hodnota, která nemá žádný vliv. Zabraňuje zalomení řádku u řetězce znaků s dvojitou šířkou, takže pravidlo pro dělení řádků je ekvivalentní pravidlu pro řetězce znaků s jedním šířkou. |
NoPadding | 268435456 | Nepřidá odsazení do ohraničujícího obdélníku. |
NoPrefix | 2048 | Vypne zpracování znaků předpony. Znak ampersand (&) mnemonické předpony je obvykle interpretován jako direktiva podtržítko znaku, který následuje, a dvojitý ampersand (&&) mnemotechnické předpony jako direktivu pro tisk jednoho ampersandu. Zadáním je NoPrefixtoto zpracování vypnuto. Například vstupní řetězec "A&bc&&d" s použitým NoPrefix výsledkem by byl výstup "A&bc&&d". Porovnat s |
PathEllipsis | 16384 | Odebere střed oříznutých čar a nahradí ho třemi tečkami. Při použití k kreslení textu pomocí |
PrefixOnly | 2097152 | Nakreslí pouze podtržení na pozici znaku za znakem předpony ampersand (&) a nenakreslí žádné další znaky v řetězci. |
PreserveGraphicsClipping | 16777216 | Zachová výřez určený objektem Graphics . Platí pouze pro metody, které přijímají IDeviceContext objekt , který je .Graphics |
PreserveGraphicsTranslateTransform | 33554432 | Zachová transformaci určenou parametrem Graphics. Platí pouze pro metody, které přijímají IDeviceContext objekt , který je .Graphics |
Right | 2 | Zarovná text na pravé straně oblasti oříznutí. |
RightToLeft | 131072 | Zobrazí text zprava doleva. |
SingleLine | 32 | Zobrazí text na jednom řádku. |
TextBoxControl | 8192 | Určuje, že text by měl být naformátovaný pro zobrazení v ovládacím TextBox prvku. |
Top | 0 | Zarovná text v horní části ohraničujícího obdélníku. Tato možnost je výchozí. |
VerticalCenter | 4 | Zacentruje text svisle uvnitř ohraničujícího obdélníku. |
WordBreak | 16 | Zalomí text na konci slova. |
WordEllipsis | 262144 | Ořízne čáru na nejbližší slovo a na konec oříznuté čáry se umístí tři tečky. Porovnat s EndEllipsis a PathEllipsis. |
Příklady
Následující příklad ukazuje, jak použít TextFormatFlags
výčet. Pokud chcete spustit tento příklad, vložte do formuláře Windows Form následující kód. Volání RenderText6
z obslužné rutiny Paint události formuláře a předání e
jako PaintEventArgs.
private void RenderText6(PaintEventArgs e)
{
TextFormatFlags flags = TextFormatFlags.Bottom | TextFormatFlags.EndEllipsis;
TextRenderer.DrawText(e.Graphics, "This is some text that will be clipped at the end.", this.Font,
new Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags);
}
Private Sub RenderText6(ByVal e As PaintEventArgs)
Dim flags As TextFormatFlags = TextFormatFlags.Bottom Or _
TextFormatFlags.EndEllipsis
TextRenderer.DrawText(e.Graphics, _
"This is some text that will be clipped at the end.", _
Me.Font, New Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags)
End Sub
Poznámky
Výčet TextFormatFlags
se používá TextRenderer při kreslení a měření textu. Nástroj TextRenderer nepodporuje přidávání zarážek tabulátoru k nakreslený text, i když existující zarážky tabulátoru můžete rozbalit pomocí příznaku ExpandTabs
.