DrawTextFlowColumns

Text, layout

Beskrivning

Flyter den återstående texten från vänster till höger genom likabredda kolumner i en sidregion

Syntax

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

Parametrar

FlowID	Handle returned by NewTextFlow
Left, Top	Den fullständiga kolumnregionens position uppe till vänster
Width, Height	Tillgänglig storlek för hela kolumnregionen
Columns	Antal kolumner med samma bredd, från 1 till 64
Gutter	Icke-negativt mellanrum mellan närliggande kolumner
Balance	0 fyller varje kolumn till full höjd, medan 1 balanserar en fullbordad region

Returvärden

Returnerar det totala antalet ritade rader, eller 0 när inget ryms, handle:t är ogiltigt, eller geometrin är ogiltig

Anmärkningar

När Balance är 1 och all återstående text ryms i den fullständiga regionen delar funktionen det exakta återstående radantalet över de begärda kolumnerna

När mer text återstår än regionen rymmer behåller varje kolumn den fullständiga begärda höjden så att kapaciteten inte minskar på mellanliggande sidor

Balansering mäter bara upp till en rad utöver regionkapaciteten, vilket undviker en fullständig genomsökning av ett långt stycke som måste fortsätta på en annan sida

Balansering mäter bara upp till en rad bortom regionens kapacitet, vilket undviker en fullständig genomsökning av ett långt stycke som måste fortsätta på en annan sidaOgiltig geometri och en region för kort för en rad lämnar flödeskursorn orörd

Exempel

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;

Se även

DrawTextFlow, MeasureTextFlow, SetTextFlowMinLines