InsertPageElementClipPath
Edição de fluxos de conteúdo, Caminhos de recorte
Descrição
Adiciona um caminho de recorte non-zero ou even-odd que afeta somente um elemento exato enumerado de texto, imagem ou caminho
Sintaxe
Delphi
Function TPDFlib.InsertPageElementClipPath(ElementID: Integer; Const PathSource: WideString; FillRule: Integer): Integer;Parâmetros
| ElementID | Handle opaco de elemento de página retornado por EnumPageElements ou EnumeratePageElements |
|---|---|
| PathSource | Somente instruções de construção de caminho, começando com m ou re e excluindo W, W* e operadores de pintura de caminho |
| FillRule | 0 para a regra de winding não nulo ou 1 para a regra par-ímpar |
Valores retornados
| 1 | O caminho de recorte local foi inserido e todos os handles de elemento de página foram invalidados |
|---|---|
| 0 | O handle ou a origem do caminho é inválido, o handle está obsoleto ou o estado de texto não pode ser reconstruído com segurança |
Observações
O método grava um escopo equilibrado q/Q em torno do alvo, de modo que a nova interseção não possa vazar para o conteúdo de página seguinteAs coordenadas de
Coordenadas de PathSource usam o espaço de usuário atual no destino; segmentos de recorte enumerados e limites usam o espaço de usuário padrão depois da CTM ativa
Para um destino dentro de um objeto de texto, o método cria objetos de texto circundantes válidos e reproduz o avanço invisível original, de modo que a extração de texto e o posicionamento posterior permaneçam inalterados
Modos de renderização de texto que contribuem com contornos de glifos para o recorte são somente leitura, porque isolá-los mudaria a semântica persistente do recorte
LastErrorCode: 532 significa entrada inválida, 533 significa conteúdo obsoleto e 534 significa que o alvo não pode ser editado com segurança