PDFium Delphi Component Docs

SetPageObjectMarkParam Método

Componente: TPdf  ·  Unidade: PDFium

Syntax

procedure SetPageObjectMarkParam(Index, MarkIndex: Integer; const Param: TPdfContentMarkParam);

Description

Adiciona ou substitui uma propriedade em uma entrada de conteúdo marcado existente por meio do handle nativo de marca do PDFium

A operação preserva o nome da marca, a ordem da marca, o handle nativo e todas as propriedades não relacionadas

Index e MarkIndex são de base zero e referem-se à página atual

Parameter values

Defina Param.Key e selecione pmpInt, pmpFloat, pmpString ou pmpBlob em Param.Kind

Apenas o campo de valor correspondente (IntValue, FloatValue, StringValue ou BlobValue) é lido

As chaves são nomes PDF e devem ser strings não vazias compatíveis com bytes, enquanto os valores blob devem conter pelo menos um byte

Uma chave já presente é substituída mesmo quando seu tipo de valor muda

Removing a parameter

procedure RemovePageObjectMarkParam(Index, MarkIndex: Integer; const Key: WString);

Remove apenas a propriedade nomeada e preserva a entrada de conteúdo marcado

Uma chave ausente dispara EPdfError porque nenhuma mutação ocorreu

Adding or removing a mark

AddPageObjectMark cria uma nova marca com um array inicial de propriedades tipadas e retorna seu índice

RemovePageObjectMark remove a entrada de conteúdo marcado completa

Uma validação de parâmetro inicial com falha faz o rollback da marca recém-criada

Persistence and performance

Cada mutação bem-sucedida invalida o cache de página de texto e regenera o conteúdo da página atual uma vez, de modo que os salvamentos subsequentes contenham a lista de propriedades BDC atualizada

PageObjectMarks pode ser lido imediatamente para obter um snapshot atualizado

Valores numéricos PDF não inteiros são retornados como pmpFloat

See Also

APIs de conteúdo de página avançado, GenerateTaggedLayout, StructureElements