ReplacePageElementClipPath
Edição de fluxos de conteúdo, caminhos de recorte
Descrição
Substitui o objeto de caminho de nível superior exato que estabeleceu um componente editável da interseção de recorte efetiva de um elemento enumerado
Sintaxe
Delphi
Function TPDFlib.ReplacePageElementClipPath(ElementID, ClipPathIndex: Integer; Const PathSource: WideString; FillRule: Integer): Integer;Parâmetros
| ElementID | Handle opaco de elemento de página |
|---|---|
| ClipPathIndex | Índice do componente com base 1, cujo sinalizador editável é devolvido pela propriedade 6 de GetPageElementClipPathInfo |
| PathSource | Instruções de construção do caminho de substituição, começando por m ou re |
| FillRule | 0 para W ou 1 para W* |
Valores devolvidos
| 1 | O caminho de origem foi substituído e todos os handles de elementos de página foram invalidados |
|---|---|
| 0 | A entrada é inválida, a origem capturada mudou ou o componente é só de leitura |
Observações
A camada de origem capturada, o intervalo de instruções e a impressão digital normalizada são todos validados antes de escrever
As coordenadas de PathSource utilizam o espaço de utilizador atual na origem de recorte original; a geometria dos componentes enumerados utiliza o espaço de utilizador predefinido após a CTM da origem
Se o operador terminal original tanto pintou como recortou o caminho, a substituição altera também essa geometria pintada, porque o PDF usa o mesmo caminho atual para ambos os efeitos
A edição altera todos os elementos posteriores que consomem o mesmo componente de recorte de estado gráfico, e não apenas o elemento usado para a selecionar
Os limites iniciais da página, os recortes de contornos de texto, os recortes locais de formulário, os objetos de caminho malformados e os caminhos divididos por camadas de conteúdo são só de leitura
Em caso de falha, LastErrorCode é 532 para entrada inválida, 533 para origem desatualizada ou 534 para um componente só de leitura