TextFormatFlags Enumeração

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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
Object
ValueType
Enum
TextFormatFlags
Atributos
FlagsAttribute

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

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

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

Confira também