Como adicionar um efeito de contorno de texto em C

Por que devo usar o TextOutlineEffect para estilizar o texto?

Para aplicar um efeito de contorno de texto, crie um TextStyle e preencha sua propriedade TextEffect com um TextOutlineEffect. Em seguida, crie um Paragraph, seguido de um Run contendo TextContent. Atribua o TextStyle ao Run (não ao TextContent), depois use AddChild para adicionar o Run ao Paragraph. Isso segue a hierarquia do documento: Documento → Parágrafo → Execução → Conteúdo do Texto.

A classe TextOutlineEffect fornece uma API abrangente para controlar todos os aspectos dos seus contornos de texto. Ao contrário das opções básicas de formatação de texto, oferece controle preciso sobre as propriedades do contorno, como largura da linha, cor, alinhamento da caneta e padrões de traço. Esse nível de controle é essencial na criação de documentos profissionais que precisam atender a diretrizes de marca específicas ou requisitos de acessibilidade.

Para aplicações comerciais, os contornos do texto podem melhorar significativamente a legibilidade do documento ao imprimir em diferentes tipos de papel ou quando o documento for visualizado em diferentes dispositivos. O contorno cria uma zona de segurança ao redor de cada caractere, garantindo que o texto permaneça legível mesmo em fundos complexos ou cenários de baixo contraste.

Qual é o padrão de código básico para adicionar contornos?

:path=/static-assets/word/content-code-examples/how-to/text-effect-text-outline-effect.cs

using IronWord;
using IronWord.Models;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    TextOutlineEffect = TextOutlineEffect.DefaultEffect,
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Hello World"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Export new Word document
doc.SaveAs("textOutlineEffect.docx");

Este padrão básico demonstra a abordagem fundamental para a aplicação de contornos de texto. O código cria um novo documento, define um estilo de texto com o efeito de contorno padrão, aplica-o ao texto e salva o resultado. O DefaultEffect fornece um contorno equilibrado que funciona bem na maioria dos cenários, apresentando uma largura sutil e uma cor complementar que realça, em vez de sobrecarregar, o texto.

Quais propriedades controlam a aparência do contorno?

O efeito de contorno de texto oferece uma variedade de propriedades personalizáveis ​​para atender a qualquer necessidade de design. Compreender essas propriedades permite criar esboços que se adequam perfeitamente aos requisitos visuais do documento e às diretrizes da marca. Abaixo estão as propriedades juntamente com suas descrições:

Cada propriedade tem uma função específica na criação de contornos de texto com aparência profissional. Por exemplo, LineWidth impacta diretamente a proeminência visual – contornos mais finos (0.1-0.3 pontos) criam ênfase sutil, enquanto contornos mais espessos (1.0-2.0 pontos) fazem declarações ousadas. A propriedade Color é crucial para manter a consistência da marca e garantir contraste adequado para acessibilidade.

Como faço para aplicar propriedades de contorno personalizadas?

:path=/static-assets/word/content-code-examples/how-to/text-effect-customized-text-outline-effect.cs

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Create new Word document
WordDocument doc = new WordDocument();

// Create and configure text style
TextStyle textStyle = new TextStyle();
textStyle.TextEffect = new TextEffect()
{
    TextOutlineEffect = new TextOutlineEffect()
    {
        Color = IronWord.Models.Color.Red,
        CompoundLineType = CompoundLineValues.Double,
        LineCapType = LineCapValues.Round,
        LineJoin = StrokeJoinStyleValues.Bevel,
        LineWidth = 0.3,
        PenAlignment = PenAlignmentValues.Center,
        presetLineDash = PresetLineDashValues.Solid
    },
};

// Create paragraph
Paragraph paragraph = new Paragraph();

// Create run with text and style
Run textRun = new Run(new TextContent("Customized text outline"));
textRun.Style = textStyle;

// Add run to paragraph
paragraph.AddChild(textRun);

// Add paragraph to document
doc.AddParagraph(paragraph);

// Export new Word document
doc.SaveAs("customizedTextOutlineEffect.docx");

Este exemplo avançado demonstra todo o poder da configuração de contorno personalizada. O código cria um contorno vermelho distinto com um estilo de linha dupla, demonstrando como várias propriedades trabalham juntas para alcançar efeitos visuais específicos. As extremidades arredondadas e as junções chanfradas criam contornos suaves e com aparência profissional, ideais para cabeçalhos e títulos.

Ao implementar estruturas de tópicos personalizadas em aplicações de produção, considere a criação de modelos de estilo reutilizáveis. Defina configurações de estrutura de tópicos padrão para diferentes elementos do documento (cabeçalhos, subcabeçalhos, texto de ênfase) e armazene-as como constantes ou configurações. Essa abordagem garante consistência em todo o seu fluxo de trabalho de geração de documentos e simplifica a manutenção quando as diretrizes da marca são alteradas.

Para obter os melhores resultados, teste os efeitos de contorno em diferentes formatos de saída e condições de visualização. O que parece bom na tela pode precisar de ajustes para a impressão. Ao selecionar a largura e as cores do contorno, leve em consideração fatores como a resolução da impressora, a cor do papel e a distância de visualização. A flexibilidade da classe TextOutlineEffect do IronWord permite ajustar esses parâmetros programaticamente com base nos requisitos de saída.