Método THotPDF.SetLoadedFreeTextText

Substitui a aparência normal de uma anotação FreeText carregada usando tipos de letra Unicode embebidos, rich text opcional e uma transação atómica do grafo

Declaração

procedure SetLoadedFreeTextText(PageIndex, AnnotationIndex: Integer;
  const AText: UnicodeString; const Options: THPDFLoadedTextAppearanceOptions;
  const RichContent: AnsiString = ''; const DefaultStyle: AnsiString = '');

Opções

Inicialize o registo com THPDFLoadedTextAppearanceOptions.Default antes de alterar campos individuais

CampoComportamento
FontName, FontStyle, FontSizeTipo de letra primária, estilo e tamanho em pontos; as predefinições são Arial, regular e 12 pontos
TextColor, Alignment, PaddingCor do texto simples, alinhamento à esquerda/centro/direita e padding em pontos; as predefinições são preto, esquerda e 2 pontos
Opacity, RotationOpacidade em [0,1] e rotação em múltiplos de 90 graus
OverflowPolicyTHPDFLoadedTextOverflowPolicy: ltopReject rejeita o overflow, ltopClip corta-o, e ltopShrinkToFit repete com tipos de letra menores
MinFontSizeLimite inferior para a redução, predefinição 4 pontos
MaxTextUnitsOrçamento de entrada e de texto simples, predefinição 1 048 576 unidades UTF-16; a entrada rich text fica limitada a quatro vezes este orçamento

Comportamento

AText fornece texto Unicode simples; um RichContent UTF-8 não vazio usa em vez disso o importador HTML e um DefaultStyle CSS opcional, e depois deriva /Contents do texto gerado

A aparência gerada copia tipos de letra embebidos e mapeamentos ToUnicode para o documento carregado, por isso guardar, achatar e extrair texto mantém o texto Unicode da aparência

O método herda as cadeias de fallback de tipos de letra configuradas, ShapingFeatures, os interruptores de auto-shaping árabe, siríaco, N'Ko, Adlam e Hanifi Rohingya e as seleções de script e de idioma GSUB; cada repetição de shrink-to-fit usa as mesmas definições sem alterar a configuração de quem chama

Mantém o fundo suportado, a borda sólida/tracejada, os insets de retângulo e a geometria de callout de dois/três pontos, e sincroniza os metadados de /AP, /Contents, /RC, /DS, /CA, /Q e de rotação

Geometria inválida, glifos de texto simples não resolvidos, bordas cloudy, limites de recursos e overflow rejeitado lançam uma exceção e fazem rollback de toda a atualização; transações externas do grafo existentes permanecem ativas

O rich text segue o subconjunto HTML/CSS suportado; os recursos externos estão desativados e tamanhos de fonte CSS fixos podem impedir o shrink-to-fit de reduzir runs individuais

Cada escritor de aparência aceita no máximo 256 seleções de fontes de shaping distintas e 64 MiB de dados brutos de tipos de letra acumulados; exceder qualquer um destes limites rejeita a atualização e preserva a anotação original

APIs relacionadas