TextFormatFlags Enumeração

Definição

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.

[System.Flags]
public enum TextFormatFlags
Herança
TextFormatFlags
Atributos

Campos

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 TextRenderer, a cadeia de caracteres não é modificada, a menos que o ModifyString sinalizador seja especificado. Compare com PathEllipsis e WordEllipsis.

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 TextRenderer, modifica o parâmetro de cadeia de caracteres especificado para corresponder ao texto exibido se as reticências forem mostradas. Esse valor não tem efeito, a menos que EndEllipsis ou PathEllipsis seja especificado.

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

PathEllipsis 16384

Remove o centro das linhas cortadas e substitui com uma elipse. Quando usada para desenhar texto por TextRenderer, a cadeia de caracteres não é modificada, a menos que o ModifyString sinalizador seja especificado. Compare com EndEllipsis e WordEllipsis.

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.

Exemplos

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);
}

Comentários

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 .

Aplica-se a

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

Confira também