TextFormatFlags Enumeração

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Especifica a informação de visualização e layout para cadeias de texto.

Esta enumeração suporta uma combinação bit-a-bit dos respetivos valores 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

Name Valor Description
Default 0

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

Adiciona acolchoamento ao retângulo delimitado para acomodar glifos salientes. Este é o padrão.
Left 0

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

Alinha o texto no topo do retângulo delimitador. Este é o padrão.
HorizontalCenter 1

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

Alinha o texto do 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. Aplica-se apenas quando o texto tem uma única linha.
WordBreak 16

Quebra o texto no final de uma palavra.
SingleLine 32

Mostra o texto numa única linha.
ExpandTabs 64

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

Permite que as partes salientes dos glifos e do texto não embrulhado que se estendem para fora do retângulo de formatação sejam visíveis.
ExternalLeading 512

Inclui a fonte externa na altura da linha. Normalmente, o início externo não é incluído na altura de uma linha de texto.
NoPrefix 2048

Desliga o processamento dos caracteres prefixo. Normalmente, o carácter de prefixo mnemónico e esperado (&) é interpretado como uma diretiva para sublinhar o carácter que se segue, e os caracteres com prefixo mnemónico de e anda (&) duplo como uma diretiva para imprimir um único e e mais. Ao especificar NoPrefix, este processamento é desligado. Por exemplo, uma cadeia de entrada "A&bc&&d" com NoPrefix aplicado resultaria na saída de "A&bc&&d". Compare com PrefixOnly.
Internal 4096

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

Especifica que o texto deve ser formatado para exibição num TextBox controlo.
PathEllipsis 16384

Remove o centro das linhas aparadas e substitui-lo por uma elipse. Quando usada para desenhar texto por TextRenderer, a cadeia não é modificada a menos que a ModifyString flag seja especificada. Compare com EndEllipsis e WordEllipsis.
EndEllipsis 32768

Remove a extremidade das linhas aparadas e substitui-las por uma elipse. Quando usada para desenhar texto por TextRenderer, a cadeia não é modificada a menos que a ModifyString flag seja especificada. Compare com PathEllipsis e WordEllipsis.
ModifyString 65536

Não tem efeito no texto desenhado ou nas medidas do texto. Quando usado para desenhar texto por TextRenderer, modifica o parâmetro de cadeia especificado para corresponder ao texto apresentado se forem apresentadas reticências. Este valor não tem efeito a menos que EndEllipsis seja especificado ou PathEllipsis especificado.
RightToLeft 131072

Mostra o texto da direita para a esquerda.
WordEllipsis 262144

Corta a linha até à palavra mais próxima e coloca-se uma reticência no final de uma linha cortada. Compare com EndEllipsis e PathEllipsis.
NoFullWidthCharacterBreak 524288

Um valor legado que não tem efeito. Evita uma quebra de linha numa sequência de caracteres de dupla largura, de modo que a regra de quebra de linha é equivalente à das sequências de caracteres de largura única.
HidePrefix 1048576

Ignora o carácter de prefixo e e e e de ampersand no texto, de modo que a letra que se segue não fica sublinhada, mas outros caracteres com prefixo mnemónico continuam a ser processados.
PrefixOnly 2097152

Desenha apenas um sublinhado na posição do carácter após o prefixo ampersand (&) e não desenha outros caracteres na cadeia.
PreserveGraphicsClipping 16777216

Preserva o recorte especificado por um Graphics objeto. Aplica-se apenas a métodos que recebem um IDeviceContext que é um Graphics.
PreserveGraphicsTranslateTransform 33554432

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

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

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

Exemplos

O exemplo seguinte demonstra como usar a TextFormatFlags enumeração. Para executar este exemplo, cole o código seguinte num Windows Form. Chamada RenderText6 do gestor de eventos do Paint formulário, passando e por 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

Observações

A TextFormatFlags enumeração é usada pelo TextRenderer ao desenhar e medir texto. A opção TextRenderer não suporta adicionar tabulações de tabulação ao texto desenhado, embora possas expandir as tabulações existentes usando a ExpandTabs bandeira.

Aplica-se a

Ver também