TextFormatFlags Enumeração

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 .

Confira também

• Usando fontes e texto