DrawTextFlowColumns

Texto, diseño

Descripción

Hace fluir el texto restante de izquierda a derecha por columnas de igual anchura 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

FlowIDIdentificador devuelto por NewTextFlow
Left, TopPosición superior izquierda de toda la región de columnas
Width, HeightTamaño disponible para toda la región de columnas
ColumnsNúmero de columnas de igual anchura de 1 a 64
GutterEspacio no negativo entre columnas adyacentes
Balance0 rellena cada columna hasta la 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 ninguna, 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 puede contener la región, todas las columnas conservan la altura solicitada completa para no reducir la capacidad en las páginas intermedias

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

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

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