Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original
Este tópico ainda não foi avaliado como - Avalie este tópico

Classe FormattedText

Fornece controle de nível inferior para desenhar o texto Windows Presentation Foundation (WPF) aplicativos.

System.Object
  System.Windows.Media.FormattedText

Namespace:  System.Windows.Media
Assembly:  PresentationCore (em PresentationCore.dll)
public class FormattedText

O tipo FormattedText expõe os membros a seguir.

  NomeDescrição
Método públicoFormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush)Inicializa uma nova instância da FormattedText classe com o texto especificado, cultura, direção de fluxo, face, tamanho da fonte e Pincel.
Método públicoFormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution)Inicializa uma nova instância da FormattedText classe com o texto especificado, cultura, direção de fluxo, face, tamanho da fonte, Pincel e comportamento de substituição de número.
Método públicoFormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode)Inicializa uma nova instância da FormattedText classe com o texto especificado, cultura, direção de fluxo, face, tamanho da fonte, Pincel, comportamento de substituição de número e o modo de formatação de texto.
Superior
  NomeDescrição
Propriedade públicaBaselineObtém a distância da parte superior da primeira linha na linha de base da primeira linha de um FormattedText objeto.
Propriedade públicaExtentObtém a distância do pixel desenhado na extremidade superior da primeira linha para o pixel desenhado na extremidade inferior da última linha.
Propriedade públicaFlowDirectionObtém ou define o FlowDirection de um FormattedText objeto.
Propriedade públicaHeightObtém a distância da parte superior da primeira linha na parte inferior da última linha da FormattedText objeto.
Propriedade públicaLineHeightObtém a altura de linha, ou o espaçamento entre linhas de texto.
Propriedade públicaMaxLineCountObtém ou define o número máximo de linhas a serem exibidas. Texto que excede o MaxLineCount não será exibida.
Propriedade públicaMaxTextHeightObtém ou define a altura máxima de uma coluna de texto.
Propriedade públicaMaxTextWidthObtém ou define a largura máxima do texto (comprimento) para uma linha de texto.
Propriedade públicaMinWidthObtém a menor largura de texto possíveis totalmente pode conter o conteúdo de texto especificado.
Propriedade públicaOverhangAfterObtém a distância da parte inferior da última linha do texto ao pixel desenhado na extremidade inferior.
Propriedade públicaOverhangLeadingObtém a distância máxima do ponto de alinhamento à esquerda ao pixel desenhado à esquerda de uma linha.
Propriedade públicaOverhangTrailingObtém a distância máxima do pixel colorido à direita até o ponto de alinhamento à direita de uma linha.
Propriedade públicaTextObtém a seqüência de caracteres de texto a ser exibido.
Propriedade públicaTextAlignmentObtém ou define o alinhamento do texto dentro de um FormattedText objeto.
Propriedade públicaTrimmingObtém ou define o meio pelo qual a omissão do texto é indicada.
Propriedade públicaWidthObtém a largura entre os pontos de alinhamento à direita e à esquerda de uma linha, excluindo qualquer à direita os caracteres de espaço em branco.
Propriedade públicaWidthIncludingTrailingWhitespaceObtém a largura entre os pontos de alinhamento à direita e à esquerda de uma linha, incluindo qualquer à direita os caracteres de espaço em branco.
Superior
  NomeDescrição
Método públicoBuildGeometryRetorna um Geometry o objeto que representa o texto formatado, incluindo todos os glifos e decorações de texto.
Método públicoBuildHighlightGeometry(Point)Retorna um Geometry o objeto que representa a caixa delimitadora de realce do texto formatado.
Método públicoBuildHighlightGeometry(Point, Int32, Int32)Retorna um Geometry o objeto que representa a caixa delimitadora de realce para uma subseqüência especificada do texto formatado.
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegidoFinalize Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método públicoGetHashCodeServe como uma função hash para um tipo específico. (Herdado de Object.)
Método públicoGetMaxTextWidthsRecupera uma matriz de larguras de texto. Cada elemento da matriz representa a largura de texto máximo de linhas seqüenciais de texto.
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método públicoSetCulture(CultureInfo)Conjuntos de CultureInfo para todo o conjunto de caracteres na FormattedText objeto.
Método públicoSetCulture(CultureInfo, Int32, Int32)Conjuntos de CultureInfo para um subconjunto especificado de caracteres na FormattedText objeto.
Método públicoSetFontFamily(FontFamily)Define a família de fontes para uma FormattedText objeto.
Método públicoSetFontFamily(String)Define a família de fontes para todo o conjunto de caracteres na FormattedText objeto.
Método públicoSetFontFamily(FontFamily, Int32, Int32)Define a família de fontes para um subconjunto especificado de caracteres na FormattedText objeto.
Método públicoSetFontFamily(String, Int32, Int32)Define a família de fontes para um subconjunto especificado de caracteres na FormattedText objeto.
Método públicoSetFontSize(Double)Define o tamanho da fonte para todo o conjunto de caracteres na FormattedText objeto.
Método públicoSetFontSize(Double, Int32, Int32)Define o tamanho de fonte para um subconjunto especificado de caracteres na FormattedText objeto.
Método públicoSetFontStretch(FontStretch)Define o valor de alongamento de fonte para todo o conjunto de caracteres a FormattedText objeto.
Método públicoSetFontStretch(FontStretch, Int32, Int32)Define o valor de alongamento de fonte para um subconjunto especificado de caracteres na FormattedText objeto.
Método públicoSetFontStyle(FontStyle)Define o estilo de fonte para todo o conjunto de caracteres a FormattedText objeto.
Método públicoSetFontStyle(FontStyle, Int32, Int32)Define o estilo de fonte para um subconjunto especificado de caracteres na FormattedText objeto.
Método públicoSetFontTypeface(Typeface)Define o tipo de letra para todo o conjunto de caracteres na fonte de FormattedText objeto.
Método públicoSetFontTypeface(Typeface, Int32, Int32)Define o tipo de letra para um subconjunto especificado de caracteres na fonte de FormattedText objeto.
Método públicoSetFontWeight(FontWeight)Define a espessura da fonte para todo o conjunto de caracteres na FormattedText objeto.
Método públicoSetFontWeight(FontWeight, Int32, Int32)As alterações a FontWeight o texto especificado dentro de um FormattedText objeto.
Método públicoSetForegroundBrush(Brush)Altera o primeiro plano Brush de todo um FormattedText objeto.
Método públicoSetForegroundBrush(Brush, Int32, Int32)Altera o primeiro plano Brush o texto especificado dentro de um FormattedText objeto.
Método públicoSetMaxTextWidthsDefine uma matriz de larguras de texto máxima dentro do FormattedText, em uma base por linha. Cada elemento da matriz representa a largura de texto máximo de linhas seqüenciais de texto.
Método públicoSetNumberSubstitution(NumberSubstitution)Define o comportamento de substituição de número para todo o conjunto de caracteres a FormattedText objeto.
Método públicoSetNumberSubstitution(NumberSubstitution, Int32, Int32)Define o comportamento de substituição de número para o texto especificado dentro de um FormattedText objeto.
Método públicoSetTextDecorations(TextDecorationCollection)Conjuntos de TextDecorationCollection para todo o conjunto de caracteres na FormattedText objeto.
Método públicoSetTextDecorations(TextDecorationCollection, Int32, Int32)Conjuntos de TextDecorationCollection o texto especificado dentro de um FormattedText objeto.
Método públicoToStringRetorna uma string que representa o objeto atual. (Herdado de Object.)
Superior

O objeto FormattedText permite que você desenhe texto de várias linhas, no qual cada caractere no texto pode ser formatado individualmente. O exemplo a seguir mostra texto que possui diversos formatos aplicados a ele.

Exemplo de uma seqüência de caracteres de texto formatado

Text displayed using FormattedText object

Em termos de recursos de texto no WPF, FormattedText é considerado "baixo nível", pois ele processa o texto como elementos gráficos. Outros aspectos do texto em WPF manipular texto no contexto de controles que são dedicadas ao texto (TextBlock, TextBox), implementar o modelo de documento de fluxo (consulte Visão geral do documento de fluxo), ou oferecer suporte a XPS o modelo de documento (consulte Documentos no WPF).

Muitos dos métodos setter na FormattedText tem semelhanças com propriedades anexadas que são suportadas pelo TextElement, mas o TextElement aplicam propriedades anexadas ao texto de nível mais alto suporte para fluxo ou XPS.

O exemplo a seguir cria um FormattedText de objeto e, em seguida, aplica vários estilos de formatação ao texto.


protected override void OnRender(DrawingContext drawingContext)
{
    string testString = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor";

    // Create the initial formatted text string.
    FormattedText formattedText = new FormattedText(
        testString,
        CultureInfo.GetCultureInfo("en-us"),
        FlowDirection.LeftToRight,
        new Typeface("Verdana"),
        32,
        Brushes.Black);

    // Set a maximum width and height. If the text overflows these values, an ellipsis "..." appears.
    formattedText.MaxTextWidth = 300;
    formattedText.MaxTextHeight = 240;

    // Use a larger font size beginning at the first (zero-based) character and continuing for 5 characters.
    // The font size is calculated in terms of points -- not as device-independent pixels.
    formattedText.SetFontSize(36 * (96.0 / 72.0), 0, 5);

    // Use a Bold font weight beginning at the 6th character and continuing for 11 characters.
    formattedText.SetFontWeight(FontWeights.Bold, 6, 11);

    // Use a linear gradient brush beginning at the 6th character and continuing for 11 characters.
    formattedText.SetForegroundBrush(
                            new LinearGradientBrush(
                            Colors.Orange,
                            Colors.Teal,
                            90.0),
                            6, 11);

    // Use an Italic font style beginning at the 28th character and continuing for 28 characters.
    formattedText.SetFontStyle(FontStyles.Italic, 28, 28);

    // Draw the formatted text string to the DrawingContext of the control.
    drawingContext.DrawText(formattedText, new Point(10, 0));
}


.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.
Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.
Isso foi útil para você?
(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
© 2013 Microsoft. Todos os direitos reservados.