PDFium Delphi Component Docs

TextInRectangle метод

Component: TPdf  ·  Unit: PDFium
Описує метод TPdf.TextInRectangle у PDFium Delphi Component і пояснює, коли використовувати цей член API

Syntax

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

 

function TextInRectangle(Rectangle: TPdfRectangle): WString;

RectangleTPdfRectangle. Запис, що задає обмежувальний прямокутник у координатах користувацького простору PDF (початок у нижньому лівому куті, Y зростає вгору)

Return Value

WString (рядок Unicode), що містить усі символи, обмежувальні рамки яких перетинають заданий прямокутник. Повертає порожній рядок, якщо в межах області не знайдено тексту

Description

TextInRectangle витягує текстовий вміст Unicode, що потрапляє в задану прямокутну область на поточній сторінці. Це корисно для читання тексту з конкретної ділянки, як-от верхній або нижній колонтитул, комірка таблиці чи мітка поля, без обробки всієї сторінки

Надано два перевантаження. Чотирипараметрова форма приймає окремі значення Left, Top, Right і Bottom. Однопараметрова форма приймає запис TPdfRectangle, що зручно, коли область уже обчислено як структуру прямокутника

Координати використовують користувацький простір PDF: початок координат знаходиться в нижньому лівому куті сторінки, а Y зростає вгору. Зверніть увагу, що Bottom для нормально орієнтованого прямокутника тому є меншим значенням, ніж Top. Символи включаються до результату, якщо їх обмежувальні рамки перекривають задану область

Як і Text, цей метод читає з логічного текстового шару сторінки та працює із завантаженою сторінкою 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