DrawTextFlowColumns

Testo, layout

Descrizione

Fa scorrere il testo rimanente da sinistra a destra attraverso colonne di uguale larghezza in una regione di pagina

Sintassi

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);

Parametri

FlowID	Handle restituito da NewTextFlow
Left, Top	Posizione in alto a sinistra dell'intera area delle colonne
Width, Height	Dimensione disponibile per l'intera area delle colonne
Columns	Numero di colonne della stessa larghezza, da 1 a 64
Gutter	Spazio non negativo tra colonne adiacenti
Balance	0 riempie ogni colonna fino all'altezza massima, mentre 1 bilancia una regione completata

Valori restituiti

Restituisce le righe disegnate o 0 se nulla rientra, handle invalido o geometria invalida

Note

Quando Balance è 1 e il testo restante entra nell'area completa, la funzione divide il numero esatto di righe tra le colonne richieste

Quando resta più testo di quanto l'area possa contenere, ogni colonna mantiene l'intera altezza richiesta per non ridurre la capacità nelle pagine intermedie

Il bilanciamento misura soltanto una riga oltre la capacità dell'area, evitando la scansione completa di un lungo brano da continuare su un'altra pagina

Una geometria non valida e una regione troppo corta per una riga lasciano invariato il cursore del flusso

Esempio

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;

Vedere anche

DrawTextFlow, MeasureTextFlow, SetTextFlowMinLines