InsertPageElementClipPath
Edición de flujos de contenido, trazados de recorte
Descripción
Añade una ruta de recorte de curvatura no nula o par-impar que afecta solo a un elemento exacto de texto, imagen o trazado enumerado
Sintaxis
Delphi
Function TPDFlib.InsertPageElementClipPath(ElementID: Integer; Const PathSource: WideString; FillRule: Integer): Integer;Parámetros
| ElementID | Manejador opaco de elemento de página devuelto por EnumPageElements o EnumeratePageElements |
|---|---|
| PathSource | Solo instrucciones de construcción de trazado, que comienzan con m o re y excluyen W, W* y los operadores de pintado de trazado |
| FillRule | 0 para la regla de curvatura no nula o 1 para la regla par-impar |
Valores devueltos
| 1 | La ruta de recorte local se insertó y todos los manejadores de elementos de página quedaron invalidados |
|---|---|
| 0 | El manejador o el origen de la ruta no es válido, el manejador está obsoleto o el estado del texto no puede reconstruirse de forma segura |
Observaciones
El método escribe un ámbito q/Q equilibrado alrededor del objetivo para que la nueva intersección no pueda filtrarse al contenido posterior de la páginaLas coordenadas de
Las coordenadas de PathSource usan el espacio de usuario actual en el objetivo; los segmentos y límites de recorte enumerados usan el espacio de usuario por defecto tras la CTM activa
Para un objetivo dentro de un objeto de texto, el método crea objetos de texto circundantes válidos y reproduce el avance invisible original para que la extracción de texto y el posicionamiento posterior no cambien
Los modos de renderizado de texto que aportan contornos de glifos al recorte son de solo lectura, porque aislarlos cambiaría la semántica persistente del recorte
LastErrorCode: 532 significa entrada no válida, 533 contenido obsoleto y 534 que el objetivo no puede editarse de forma segura