TextFormatFlags Enumeração

Definição

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

Especifica as informações de exibição e layout 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

Nome Valor Description
Default 0

Aplica a formatação padrão, que é alinhada à esquerda.
GlyphOverhangPadding 0

Adiciona preenchimento ao retângulo delimitador para acomodar glifos pendentes. Esse é o padrão.
Left 0

Alinha o texto no lado esquerdo da área de recorte. Esse é o padrão.
Top 0

Alinha o texto na parte superior do retângulo delimitador. Esse é o padrão.
HorizontalCenter 1

Centraliza o texto horizontalmente dentro do retângulo delimitador.
Right 2

Alinha o texto no lado direito da área de recorte.
VerticalCenter 4

Centraliza o texto verticalmente, dentro do retângulo delimitador.
Bottom 8

Alinha o texto na parte inferior do retângulo delimitador. Aplicado somente quando o texto é uma única linha.
WordBreak 16

Quebra o texto no final de uma palavra.
SingleLine 32

Exibe o texto em uma única linha.
ExpandTabs 64

Expande caracteres de guia. O número padrão de caracteres por guia é oito. Os WordEllipsisvalores , PathEllipsise não EndEllipsis podem ser usados com ExpandTabs.
NoClipping 256

Permite que as partes pendentes de glifos e texto desembrulhado cheguem fora do retângulo de formatação para mostrar.
ExternalLeading 512

Inclui a fonte externa à esquerda na altura da linha. Normalmente, a liderança externa não é incluída na altura de uma linha de texto.
NoPrefix 2048

Desativa o processamento de caracteres de prefixo. Normalmente, o caractere mnemônico-prefixo (&) e comercial é interpretado como uma diretiva para sublinhar o caractere a seguir, e os caracteres mnemônicos-prefixos de es&eradores duplos (> como uma diretiva para imprimir um único esporádico). Ao especificar NoPrefix, esse processamento está desativado. Por exemplo, uma cadeia de caracteres de entrada de "A&bc&d" com NoPrefix aplicado resultaria na saída de "A&bc&d". Comparar com PrefixOnly.
Internal 4096

Usa a fonte do sistema para calcular as métricas de texto.
TextBoxControl 8192

Especifica que o texto deve ser formatado para exibição em um TextBox controle.
PathEllipsis 16384

Remove o centro das linhas aparadas e substitui-o por reticências. Quando usado para desenhar texto, TextRenderera cadeia de caracteres não é modificada, a menos que o ModifyString sinalizador seja especificado. Comparar com EndEllipsis e WordEllipsis.
EndEllipsis 32768

Remove o fim das linhas aparadas e as substitui por reticências. Quando usado para desenhar texto, TextRenderera cadeia de caracteres não é modificada, a menos que o ModifyString sinalizador seja especificado. Comparar com PathEllipsis e WordEllipsis.
ModifyString 65536

Não tem efeito sobre as medidas de texto ou texto desenhadas. Quando usado para desenhar texto, TextRenderermodifica 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 seja especificado ou PathEllipsis especificado.
RightToLeft 131072

Exibe o texto da direita para a esquerda.
WordEllipsis 262144

Corta a linha para a palavra mais próxima e uma reticências é colocada no final de uma linha aparada. Comparar com EndEllipsis e PathEllipsis.
NoFullWidthCharacterBreak 524288

Um valor herdado que não tem efeito. Ele impede uma quebra de linha em uma cadeia de caracteres de largura dupla, de modo que a regra de quebra de linha seja equivalente a essa para cadeias de caracteres de largura única.
HidePrefix 1048576

Ignora o caractere de prefixo esporádico no texto, para que a letra a seguir não seja sublinhada, mas outros caracteres de prefixo mnemônico ainda sejam processados.
PrefixOnly 2097152

Desenha apenas um sublinhado na posição do caractere seguindo o caractere de prefixo e (> ) e não desenha nenhum outro caractere na cadeia de caracteres.
PreserveGraphicsClipping 16777216

Preserva o recorte especificado por um Graphics objeto. Aplica-se somente aos métodos que recebem um IDeviceContextGraphics.
PreserveGraphicsTranslateTransform 33554432

Preserva a transformação especificada por um Graphics. Aplica-se somente aos métodos que recebem um IDeviceContextGraphics.
NoPadding 268435456

Não adiciona preenchimento ao retângulo delimitador.
LeftAndRightPadding 536870912

Adiciona preenchimento a ambos os lados do retângulo delimitador.

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 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 desenho e medição de TextRenderer texto. O TextRenderer não dá suporte à adição de paradas de tabulação ao texto desenhado, embora você possa expandir as paradas de tabulação existentes usando o ExpandTabs sinalizador.

Aplica-se a

Confira também