DrawHTMLStory
Texto HTML, diseño de página, paginación
Descripción
Distribuye una historia HTML con estilo de izquierda a derecha en columnas de igual ancho de la página seleccionada y luego en páginas recién generadas
Sintaxis
Delphi
Function TPDFlib.DrawHTMLStory(Left, Top, Width, Height: Double; Columns: Integer; Gutter: Double; MaxPages: Integer; Const HTMLText: WideString): WideString;DLL
const wchar_t* DLDrawHTMLStory(int InstanceID, double Left, double Top, double Width, double Height, int Columns, double Gutter, int MaxPages, const wchar_t* HTMLText);ActiveX
Function PDFlib::DrawHTMLStory(Left As Double, Top As Double, Width As Double, Height As Double, Columns As Long, Gutter As Double, MaxPages As Long, HTMLText As String) As StringParámetros
| Left, Top | El origen superior izquierdo de la región completa de columnas en el sistema de coordenadas actual |
|---|---|
| Width, Height | Dimensiones positivas de la región completa en cada página |
| Columns | Cantidad de columnas de 1 a 64 |
| Gutter | Espaciado no negativo entre columnas adyacentes; los canalones combinados deben ser menores que Width |
| MaxPages | Número máximo de páginas que se usarán en esta llamada, de 1 a 10000, incluida la página seleccionada |
| HTMLText | HTML inicial o la cadena de continuación devuelta por una llamada anterior de historia o cuadro de texto |
Valores devueltos
Devuelve una cadena vacía cuando se coloca toda la historia, o una cadena de continuación que contiene todo el contenido no colocado y su estado HTML/CSS activo cuando se alcanza MaxPages
La entrada no válida devuelve HTMLText sin cambios con LastErrorCode 121; un fallo al crear la página o dos marcos consecutivos sin progreso de diseño devuelve el story restante con el error 524
Observaciones
Las columnas se llenan en orden de lectura de izquierda a derecha antes de crear una página nueva
Las páginas generadas copian el ancho y alto efectivos de la página inicial seleccionada, mientras que la unidad de medida actual, el origen, las asignaciones de fuente HTML, los enlaces de imágenes, los estilos en línea, la cascada de hojas de estilo, la pila de estilos anidada, los contenedores Flexbox y Grid, las tablas, los enlaces, los bloques estructurados y la numeración de notas al pie continúan mediante el mismo renderizador
Use <footnote> o <aside style="float:footnote"> después del texto de cuerpo relacionado; las notas aceptadas reciben un marcador en superíndice, reservan un área separada al final del marco actual y reducen la altura del cuerpo antes del salto de línea posterior
Si una nota y su referencia no caben juntas, ambas permanecen en la cadena de continuación para la siguiente columna o página
El método usa planes de medición y repetición en caché para cada marco y no concatena el contenido de las páginas en un único búfer de diseño sin límite
Cuando un límite finito de páginas devuelve contenido restante, cree o seleccione la página de continuación deseada y pase la cadena devuelta a otra llamada
Véase también
DrawHTMLTextBox, DrawTextFlowColumns, Apéndice A: etiquetas HTML compatibles