PDFium Component Docs

TextInRectangle Metoda

Component: TPdf  ·  Unit: PDFium
Wyodrębnia tekst wewnątrz prostokątnej granicy na stronie

Syntax

function TextInRectangle(Left, Top, Right, Bottom: Double): WString;

 

function TextInRectangle(Rectangle: TPdfRectangle): WString;

RectangleTPdfRectangle. Rekord określający prostokąt otaczający we współrzędnych przestrzeni użytkownika PDF (początek w lewym dolnym rogu, Y rośnie w górę)

Return Value

WString (ciąg Unicode) zawierający wszystkie znaki, których prostokąty ograniczające przecinają wskazany prostokąt Zwraca pusty ciąg, jeśli w regionie nie znaleziono tekstu

Description

TextInRectangle wyodrębnia zawartość tekstową Unicode mieszczącą się w danym prostokątnym regionie bieżącej strony. Przydaje się do odczytu tekstu z konkretnego obszaru, takiego jak nagłówek, stopka, komórka tabeli czy etykieta pola, bez przetwarzania całej strony

Dostępne są dwa przeciążenia. Forma czteroparametrowa przyjmuje poszczególne wartości Left, Top, Right i Bottom. Forma jednoparametrowa przyjmuje rekord TPdfRectangle, co jest wygodne, gdy region jest już policzony jako struktura prostokąta

Współrzędne używają przestrzeni użytkownika PDF: początek znajduje się w lewym dolnym rogu strony, a Y rośnie w górę. Zwróć uwagę, że dla normalnie zorientowanego prostokąta Bottom jest zatem wartością mniejszą niż Top. Znaki są uwzględniane w wyniku, jeśli ich prostokąty ograniczające nachodzą na wskazany region

Podobnie jak Text, metoda ta czyta z logicznej warstwy tekstowej strony i działa na załadowanej stronie PDF

Example

// Extract text from the top header area of an A4 page
// A4: 595 x 842 pt; header = top 60 pt band
Pdf1.LoadFromFile('C:\Docs\report.pdf');
Pdf1.PageIndex := 0;
var HeaderText: WString;
begin
  HeaderText := Pdf1.TextInRectangle(0, 782, 595, 842);
  ShowMessage(HeaderText);
end;

// Using TPdfRectangle overload
var
  Rect: TPdfRectangle;
  CellText: WString;
begin
  Rect.Left := 72; Rect.Bottom := 600;
  Rect.Right := 250; Rect.Top := 640;
  CellText := Pdf1.TextInRectangle(Rect);
end;

See Also

Text, CharacterCount, FindFirst