THotPDF.SetLoadedFreeTextPlainText Method

Converte explicitamente uma anotação FreeText carregada compatível em texto sem formatação alinhado à esquerda e reconstrói a aparência normal dela

Declaração

procedure SetLoadedFreeTextPlainText(PageIndex, AnnotationIndex: Integer;
  const AText: AnsiString; FontSize: Single = 12);

Unidade: HPDFDoc · Disponível desde a versão 2.753.0

Parâmetros

• PageIndex: índice da página carregada com base em zero
• AnnotationIndex: índice da anotação nessa página com base em zero
• AText: caracteres ASCII imprimíveis, com CR, LF ou CR/LF para quebras de linha explícitas; tabs, outros caracteres de controle e texto não ASCII são rejeitados
• FontSize: tamanho finito em pontos PDF, maior que zero e de no máximo 10,000, com 12 como padrão

Conversão de aparência

O método usa texto Helvetica preto e uma borda retangular preta, mantém o fundo em cor de dispositivo compatível e a geometria de borda sólida ou tracejada, e recorta o texto para uma margem interna de dois pontos dentro do retângulo da anotação

As linhas avançam 1.2 vezes o tamanho da fonte; não há quebra de linha automática nem redução para caber, então o texto fora da margem interna é recortado

A conversão substitui /AP, atualiza /Contents e /DA, define /Q como zero e remove /RC, /DS e /AS; o rich text antigo, a seleção de fonte, a cor do texto, o alinhamento e os estados de aparência são substituídos de propósito

As alterações de anotação, aparência e página são registradas para salvamento incremental e o cache de renderização da página é invalidado; o salvamento por reescrita também preserva a nova aparência

Entrada compatível e erros

A anotação precisa existir e ter o subtipo FreeText, com um retângulo finito de mais de quatro pontos de largura e de altura

Callouts, diferenças ou margens internas do retângulo, efeitos de borda, uma entrada de rotação, intent diferente de FreeText, anotações não opacas, bordas arredondadas e estilos de borda que não sejam sólido ou tracejado são rejeitados com EArgumentException

Os componentes de fundo DeviceGray, DeviceRGB e DeviceCMYK precisam estar entre zero e um; larguras de borda e dash patterns precisam ser válidos, finitos e não negativos, e um dash pattern não vazio formado só por zeros é rejeitado

A entrada não compatível é validada antes de substituir a anotação ou a aparência dela

Exemplo

Para um documento carregado cuja primeira anotação na página zero é uma anotação FreeText compatível

PDF.SetLoadedFreeTextPlainText(0, 0,
  'Updated review note'#13#10'Second line', 12);

APIs relacionadas

SetLoadedAnnotationContents só muda a string de contents armazenada e preserva a aparência existente

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · Início