DrawTextFlowColumns

Tekst, Układ

Opis

Przepływa pozostały tekst od lewej do prawej przez kolumny o równej szerokości w jednym obszarze strony

Składnia

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

Parametry

FlowID	Uchwyt zwrócony przez NewTextFlow
Left, Top	Położenie lewego górnego narożnika całego obszaru kolumn
Width, Height	Dostępny rozmiar całego obszaru kolumn
Columns	Liczba kolumn o równej szerokości od 1 do 64
Gutter	Nieujemny odstęp między sąsiednimi kolumnami
Balance	0 wypełnia każdą kolumnę do pełnej wysokości, natomiast 1 równoważy ukończony obszar

Wartości zwracane

Zwraca łączną liczbę narysowanych wierszy albo 0, gdy nic się nie mieści, uchwyt jest nieprawidłowy lub geometria jest nieprawidłowa

Uwagi

Gdy Balance ma wartość 1 i cały pozostały tekst mieści się w całym obszarze, funkcja dzieli dokładną liczbę pozostałych wierszy między żądane kolumny

Gdy pozostaje więcej tekstu, niż może pomieścić obszar, każda kolumna zachowuje pełną żądaną wysokość, aby nie zmniejszać pojemności na stronach pośrednich

Równoważenie mierzy tylko do jednego wiersza poza pojemnością obszaru, unikając pełnego skanowania długiego fragmentu, który musi być kontynuowany na innej stronie

Nieprawidłowa geometria i obszar zbyt niski na jeden wiersz pozostawiają kursor przepływu bez zmian

Przykład

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;

Zobacz również

DrawTextFlow, MeasureTextFlow, SetTextFlowMinLines