DrawTextFlowColumns

Texto, diseño

Descripción

Distribuye el texto restante de izquierda a derecha a través de columnas de igual ancho en una región de página

Sintaxis

Delphi

Function TPDFlib.DrawTextFlowColumns(FlowID: Integer; Left, Top, Width, Height: Double; Columns: Integer; Gutter: Double; Balance: Integer): Integer;

ActiveX

Function PDFlib::DrawTextFlowColumns(FlowID As Long, Left As Double, Top As Double, Width As Double, Height As Double, Columns As Long, Gutter As Double, Balance As Long) As Long

DLL

int DLDrawTextFlowColumns(int InstanceID, int FlowID, double Left, double Top, double Width, double Height, int Columns, double Gutter, int Balance);

Parámetros

FlowIDHandle devuelto por NewTextFlow
Left, TopPosición superior izquierda de la región de columna completa
Width, HeightTamaño disponible para toda la región de columnas
ColumnsNúmero de columnas de igual ancho de 1 a 64
GutterEspacio no negativo entre columnas adyacentes
Balance0 llena cada columna a altura completa, mientras que 1 equilibra una región terminada

Valores devueltos

Devuelve el número total de líneas dibujadas, o 0 cuando no cabe nada, el identificador no es válido o la geometría no es válida

Observaciones

Cuando Balance es 1 y todo el texto restante cabe en la región completa, la función divide el número exacto de líneas restantes entre las columnas solicitadas

Cuando queda más texto del que cabe en la región, cada columna conserva toda la altura solicitada para que la capacidad no se reduzca en las páginas intermedias

El equilibrado mide solo hasta una línea más allá de la capacidad de la región, evitando un análisis completo de un pasaje largo que debe continuar en otra página

La geometría no válida y una región demasiado corta para una línea dejan el cursor de flujo sin cambios

Ejemplo

while PDF.TextFlowFinished(Flow)= 0 do
begin
  PDF.DrawTextFlowColumns(Flow, 50, 60, 495, 720, 3, 18, 1);
  if PDF.TextFlowFinished(Flow)= 0 then PDF.NewPage;
end;

Véase también

DrawTextFlow, MeasureTextFlow, SetTextFlowMinLines