THotPDF.SetLoadedFreeTextPlainText Method

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

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 zero
• AnnotationIndex: índice da anotação nessa página com base zero
• AText: caracteres ASCII imprimíveis, com CR, LF ou CR/LF para quebras de linha explícitas; tabuladores, outros caracteres de controlo 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 por predefinição

Conversão de aparência

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

As linhas avançam 1.2 vezes o tamanho do tipo de letra; não há quebra de linha automática nem redução para caber, por isso o texto fora do recuo é 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 do tipo de letra, a cor do texto, o alinhamento e os estados de aparência são substituídos de forma intencional

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

Entrada compatível e erros

A anotação tem de 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 recuos do retângulo, efeitos de contorno, uma entrada de rotação, intent diferente de FreeText, anotações não opacas, contornos arredondados e estilos de contorno que não sejam sólido ou tracejado são rejeitados com EArgumentException

Os componentes de fundo DeviceGray, DeviceRGB e DeviceCMYK têm de estar entre zero e um; larguras de contorno e dash patterns têm de 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 respetiva aparência

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ó altera a cadeia de contents armazenada e preserva a aparência existente

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · Início