InsertPageElementClipPath
Edição de fluxos de conteúdo, caminhos de recorte
Descrição
Adiciona um traçado de recorte de enrolamento não nulo ou par-ímpar que afeta apenas um elemento exato enumerado de texto, imagem ou traçado
Sintaxe
Delphi
Function TPDFlib.InsertPageElementClipPath(ElementID: Integer; Const PathSource: WideString; FillRule: Integer): Integer;Parâmetros
| ElementID | Handle opaco de elemento de página devolvido por EnumPageElements ou EnumeratePageElements |
|---|---|
| PathSource | Apenas instruções de construção de traçado, começando por m ou re e excluindo os operadores W, W* e de pintura de traçado |
| FillRule | 0 para a regra de enrolamento não nulo ou 1 para a regra par-ímpar |
Valores devolvidos
| 1 | O traçado de recorte local foi inserido e todos os handles de elementos de página foram invalidados |
|---|---|
| 0 | O handle ou a origem do traçado é inválida, o handle está desatualizado ou o estado do texto não pode ser reconstruído com segurança |
Observações
O método escreve um âmbito q/Q equilibrado em torno do alvo, para que a nova interseção não se possa infiltrar no conteúdo seguinte da página
As coordenadas de PathSource utilizam o espaço de utilizador atual no alvo; os segmentos e os limites de recorte enumerados utilizam o espaço de utilizador predefinido após a CTM ativa
Para um alvo dentro de um objeto de texto, o método cria objetos de texto circundantes válidos e repõe o avanço invisível original, de modo a que a extração de texto e o posicionamento posterior permaneçam inalterados
Os modos de renderização de texto que contribuem com contornos de glifos para o recorte são só de leitura, porque isolá-los alteraria a semântica persistente do recorte
Em caso de falha, inspecione LastErrorCode: 532 significa entrada inválida, 533 significa conteúdo desatualizado e 534 significa que o alvo não pode ser editado em segurança