Gerenciar Sobrescrito e Subscrito em Apresentações Usando PHP

Visão geral

Aspose.Slides oferece recursos para integrar texto em sobrescrito e subscrito em suas apresentações PowerPoint (PPT, PPTX) e OpenDocument (ODP). Seja para realçar fórmulas químicas, equações matemáticas ou anotar conteúdo com notas de rodapé, essas opções de formatação especial ajudam a manter clareza e precisão. Neste artigo, você aprenderá como aplicar estilos de sobrescrito e subscrito de forma contínua e garantir resultados profissionais em cada slide.

Gerenciar Texto em Sobrescrito e Subscrito

Você pode adicionar texto em sobrescrito e subscrito em qualquer porção de parágrafo. Para adicionar texto em Sobrescrito ou Subscrito em um quadro de texto do Aspose.Slides, deve‑se usar o método setEscapement da classe PortionFormat.

Essa propriedade devolve ou define o texto em sobrescrito ou subscrito (valor de -100 % (subscrito) a 100 % (sobrescrito). Por exemplo:

  • Crie uma instância da classe Presentation.
  • Obtenha a referência de um slide usando seu Índice.
  • Adicione um AutoShape do tipo Rectangle ao slide.
  • Acesse o TextFrame associado ao AutoShape.
  • Limpe os Parágrafos existentes.
  • Crie um novo objeto de parágrafo para conter texto em sobrescrito e adicione‑o à coleção IParagraphs do TextFrame.
  • Crie um novo objeto de porção.
  • Defina a propriedade Escapement para a porção entre 0 e 100 para adicionar sobrescrito. (0 significa sem sobrescrito)
  • Defina algum texto para a Portion e, em seguida, adicione‑o à coleção de porções do parágrafo.
  • Crie um novo objeto de parágrafo para conter texto em subscrito e adicione‑o à coleção IParagraphs do ITextFrame.
  • Crie um novo objeto de porção.
  • Defina a propriedade Escapement para a porção entre 0 e -100 para adicionar subscrito. (0 significa sem subscrito)
  • Defina algum texto para a Portion e, em seguida, adicione‑o à coleção de porções do parágrafo.
  • Salve a apresentação como um arquivo PPTX.

A implementação das etapas acima é apresentada a seguir.

  # Instanciar uma classe Presentation que representa um PPTX
  $pres = new Presentation();
  try {
    # Obter slide
    $slide = $pres->getSlides()->get_Item(0);
    # Criar caixa de texto
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 200, 100);
    $textFrame = $shape->getTextFrame();
    $textFrame->getParagraphs()->clear();
    # Criar parágrafo para texto em sobrescrito
    $superPar = new Paragraph();
    # Criar porção com texto normal
    $portion1 = new Portion();
    $portion1->setText("SlideTitle");
    $superPar->getPortions()->add($portion1);
    # Criar porção com texto em sobrescrito
    $superPortion = new Portion();
    $superPortion->getPortionFormat()->setEscapement(30);
    $superPortion->setText("TM");
    $superPar->getPortions()->add($superPortion);
    # Criar parágrafo para texto em subscrito
    $paragraph2 = new Paragraph();
    # Criar porção com texto normal
    $portion2 = new Portion();
    $portion2->setText("a");
    $paragraph2->getPortions()->add($portion2);
    # Criar porção com texto em subscrito
    $subPortion = new Portion();
    $subPortion->getPortionFormat()->setEscapement(-25);
    $subPortion->setText("i");
    $paragraph2->getPortions()->add($subPortion);
    # Adicionar parágrafos à caixa de texto
    $textFrame->getParagraphs()->add($superPar);
    $textFrame->getParagraphs()->add($paragraph2);
    $pres->save("formatText.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

O sobrescrito e o subscrito são preservados ao exportar para PDF ou outros formatos?

Sim, o Aspose.Slides retém corretamente a formatação de sobrescrito e subscrito ao exportar apresentações para PDF, PPT/PPTX, imagens e outros formatos suportados. A formatação especializada permanece intacta em todos os arquivos de saída.

É possível combinar sobrescrito e subscrito com outros estilos de formatação, como negrito ou itálico?

Sim, o Aspose.Slides permite misturar vários estilos de texto dentro de uma única porção. Você pode habilitar negrito, itálico, sublinhado e, simultaneamente, aplicar sobrescrito ou subscrito configurando as propriedades correspondentes em PortionFormat.

A formatação de sobrescrito e subscrito funciona para texto dentro de tabelas, gráficos ou SmartArt?

Sim, o Aspose.Slides oferece suporte à formatação na maioria dos objetos, incluindo tabelas e elementos de gráficos. Ao trabalhar com SmartArt, é necessário acessar os elementos apropriados (como SmartArtNode) e seus contêineres de texto, e então configurar as propriedades de PortionFormat de maneira semelhante.