InsertPageElementClipPath
Modifica dei flussi di contenuto, tracciati di ritaglio
Descrizione
Aggiunge un tracciato di ritaglio diverso-da-zero o pari-dispari che influenza solo un elemento esatto di testo, immagine o tracciato enumerato
Sintassi
Delphi
Function TPDFlib.InsertPageElementClipPath(ElementID: Integer; Const PathSource: WideString; FillRule: Integer): Integer;Parametri
| ElementID | Handle opaco dell'elemento di pagina restituito da EnumPageElements o EnumeratePageElements |
|---|---|
| PathSource | Solo istruzioni di costruzione del tracciato, che iniziano con m o re ed escludono W, W* e gli operatori di verniciatura del tracciato |
| FillRule | 0 per la regola dell'avvolgimento diverso da zero oppure 1 per la regola pari-dispari |
Valori restituiti
| 1 | Il tracciato di ritaglio locale è stato inserito e tutti gli handle degli elementi di pagina sono stati invalidati |
|---|---|
| 0 | L'handle o la sorgente del tracciato non è valido, l'handle è obsoleto oppure lo stato del testo non può essere ricostruito in sicurezza |
Osservazioni
Il metodo scrive un ambito bilanciato q/Q attorno alla destinazione così la nuova intersezione non può fuoriuscire nel contenuto successivo della paginaLe coordinate di
Le coordinate di PathSource usano lo spazio utente corrente alla destinazione; i segmenti e i limiti di clip enumerati usano lo spazio utente predefinito dopo la CTM attiva
Per una destinazione dentro un oggetto di testo, il metodo crea oggetti di testo circostanti validi e riproduce l'avanzamento invisibile originale così l'estrazione del testo e il posizionamento successivo restano invariati
Le modalità di rendering del testo che apportano contorni di glifi al clip sono di sola lettura, perché isolarle cambierebbe la semantica persistente del clip
LastErrorCode: 532 significa input non valido, 533 contenuto obsoleto e 534 che la destinazione non può essere modificata in sicurezza