DrawHTMLStory

Texto HTML, diseño de página, paginación

Descripción

Distribuye una historia HTML con estilo de izquierda a derecha por columnas de igual anchura en la página seleccionada y después por páginas nuevas

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 String

Parámetros

Left, Top	Origen superior izquierdo de toda la región de columnas en el sistema de coordenadas actual
Width, Height	Dimensiones positivas de la región completa en todas las páginas
Columns	Número de columnas de 1 a 64
Gutter	Espaciado no negativo entre columnas adyacentes; la suma de los medianiles debe ser menor que `Width`
MaxPages	Número máximo de páginas que se utilizarán en esta llamada, de 1 a 10000, incluida la página seleccionada
HTMLText	HTML inicial o cadena de continuación devuelta por una llamada anterior de historia o cuadro de texto

Valores devueltos

Devuelve una cadena vacía cuando se ha colocado todo el relato, o una cadena de continuación que contiene todo el contenido no colocado y su estado HTML/CSS activo cuando se alcanza MaxPages

Una 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 disposición devuelven el relato restante con el error 524

Observaciones

Las columnas se rellenan en orden de lectura, de izquierda a derecha, antes de crear una nueva página

Las páginas generadas copian tamaño efectivo y el mismo renderizador conserva unidades, origen, fuentes HTML, imágenes, estilos, cascada, pilas, Flexbox, Grid, tablas, enlaces, bloques y notas

Utilice <footnote> o <aside style="float:footnote"> después del texto del cuerpo relacionado; las notas aceptadas reciben un marcador en superíndice, reservan un área separada en la parte inferior del marco actual y reducen la altura del cuerpo antes de los saltos de línea posteriores

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 utiliza planes de medición y repetición almacenados en caché para cada marco y no concatena el contenido de la página en un único búfer de diseño sin límites

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 admitidas