InsertPageElementClipPath

Edición de flujos de contenido, trazados de recorte

Descripción

Agrega un trazado de recorte no cero 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

ElementIDManejador opaco de elemento de página devuelto por EnumPageElements o EnumeratePageElements
PathSourceSolo instrucciones de construcción de trazado, comenzando con m o re y excluyendo W, W* y los operadores de pintado de trazado
FillRule0 para la regla de devanado no cero o 1 para la regla par-impar

Valores devueltos

1El trazado de recorte local se insertó y todos los manejadores de elementos de página quedaron invalidados
0El manejador o la fuente del trazado no es válida, el manejador está obsoleto o el estado de texto no puede reconstruirse de forma segura

Observaciones

El método escribe un ámbito equilibrado q/Q alrededor del objetivo para que la nueva intersección no pueda filtrarse al contenido de página siguienteLas 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 predeterminado después de 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 significa contenido obsoleto y 534 significa que el objetivo no puede editarse de forma segura