TextFormatFlags Enumeração
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica as informações de layout e de exibição para cadeias de caracteres de texto.
Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.
public enum class TextFormatFlags
[System.Flags]
public enum TextFormatFlags
[<System.Flags>]
type TextFormatFlags =
Public Enum TextFormatFlags
- Herança
- Atributos
Bottom | 8 | Alinha o texto na parte inferior do retângulo delimitador. Aplicada apenas quando o texto é uma única linha. |
Default | 0 | Aplica a formatação padrão, que é alinhada à esquerda. |
EndEllipsis | 32768 | Remove o final das linhas cortadas e substitui com uma elipse. Quando usada para desenhar texto por |
ExpandTabs | 64 | Amplia os caracteres da guia. O número padrão de caracteres por guia é oito. Os valores WordEllipsis, PathEllipsis e EndEllipsis não podem ser usados com ExpandTabs. |
ExternalLeading | 512 | Inclui os principais de fonte externa na altura da linha. Normalmente, o principal externo não está incluído na altura de uma linha de texto. |
GlyphOverhangPadding | 0 | Adiciona o preenchimento ao retângulo delimitador para acomodar glifos estendidos. Esse é o padrão. |
HidePrefix | 1048576 | Ignora o caractere de prefixo de e comercial (&) no texto, para que a letra a seguir não seja sublinhada, mas outros caracteres de prefixo mnemônico ainda sejam processados. |
HorizontalCenter | 1 | Centraliza o texto horizontalmente dentro do retângulo delimitador. |
Internal | 4096 | Usa a fonte do sistema para calcular métricas de texto. |
Left | 0 | Alinha o texto no lado esquerdo da área de corte. Esse é o padrão. |
LeftAndRightPadding | 536870912 | Adiciona preenchimento em ambos os lados do retângulo delimitador. |
ModifyString | 65536 | Não tem efeito sobre o texto desenhado nem sobre as medidas de texto. Quando usado para desenhar texto por |
NoClipping | 256 | Permite que mostrem as partes suspensas de glifos e o texto sem quebra que estão ultrapassando o retângulo de formatação. |
NoFullWidthCharacterBreak | 524288 | Um valor herdado que não tem nenhum efeito. Ele impede uma quebra de linha em uma cadeia de caracteres largos duplos, de modo que a regra de quebra de linha seja equivalente àquela para cadeias de caracteres largos simples. |
NoPadding | 268435456 | Não adicionar preenchimento ao retângulo delimitador. |
NoPrefix | 2048 | Desativa o processamento de caracteres de prefixo. Normalmente, o caractere de prefixo mnemônico "e" comercial (&) é interpretado como uma diretiva para sublinhar o caractere seguinte e os caracteres de prefixo mnemônico duplo "e" comercial (&), como uma diretiva para imprimir um único “e” comercial. Especificando NoPrefix, esse processamento é desativado. Por exemplo, uma cadeia de entrada "A&bc&&d" com NoPrefix aplicado resultaria em uma saída de "A&bc&&d". Compare com |
PathEllipsis | 16384 | Remove o centro das linhas cortadas e substitui com uma elipse. Quando usada para desenhar texto por |
PrefixOnly | 2097152 | Desenha apenas um sublinhado na posição do caractere após o caractere de prefixo de e comercial (&) e não desenha nenhum outro caractere na cadeia de caracteres. |
PreserveGraphicsClipping | 16777216 | Preserva o corte especificado por um Graphics objeto. Aplica-se apenas aos métodos recebendo um IDeviceContext que é um Graphics. |
PreserveGraphicsTranslateTransform | 33554432 | Preserva a transformação especificada por um Graphics. Aplica-se apenas aos métodos recebendo um IDeviceContext que é um Graphics. |
Right | 2 | Alinha o texto no lado direito da área de corte. |
RightToLeft | 131072 | Exibe o texto da direita para a esquerda. |
SingleLine | 32 | Exibe o texto em uma única linha. |
TextBoxControl | 8192 | Especifica que o texto deve ser formatado para exibição em um TextBox controle. |
Top | 0 | Alinha o texto na parte superior do retângulo delimitador. Esse é o padrão. |
VerticalCenter | 4 | Centraliza o texto verticalmente dentro do retângulo delimitador. |
WordBreak | 16 | Quebra o texto ao final de uma palavra. |
WordEllipsis | 262144 | Corta a linha na palavra mais próxima e uma elipse é colocada no final de uma linha cortada. Compare com EndEllipsis e PathEllipsis. |
O exemplo a seguir demonstra como usar a TextFormatFlags
enumeração . Para executar este exemplo, cole o código a seguir em um Formulário do Windows. Chame RenderText6
do manipulador de eventos do Paint formulário, passando e
como 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
A TextFormatFlags
enumeração é usada pelo TextRenderer ao desenhar e medir texto. O TextRenderer não dá suporte à adição de paradas de tabulação para o texto desenhado, embora você possa expandir as paradas de tabulação existentes usando o ExpandTabs
sinalizador .
Produto | Versões |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: