PDFium Delphi Component Docs

TextPage-ominaisuus

Component: TPdf  ·  Unit: PDFium
Natiivi PDFium-tekstisivukahva nykyiselle aktiiviselle sivulle

Syntax

property TextPage: FPDF_TEXTPAGE; // read only

Description

TextPage altistaa raakan PDFiumin FPDF_TEXTPAGE-kahvan, joka liittyy tällä hetkellä ladattuun sivuun. Kahva luodaan laiskasti, kun sivusta tulee aktiivinen, ja sitä pidetään elossa kyseisen sivusidoksen elinkaaren ajan; se antaa suoran pääsyn PDFiumin tekstinerottelu-API:hin (FPDFText_*) kutsujille, jotka tarvitsevat toimintoja, joita TPdf:n korkeamman tason ominaisuudet eivät tarjoa — esimerkiksi glyfitason tekstiajoja, kerning-tietoja, mukautettuja hakusemantiikkaa tai raakoja merkki-indeksin ja rajauslaatikon välisiä kuvauksia

Kahva on kelvollinen vain silloin, kun Active on True ja kelvollinen sivu on valittuna. Sivun vaihtaminen (uuden PageNumber-arvon asettaminen tai ReloadPage-kutsu) tuhoaa edellisen kahvan ja luo uuden, joten älä tallenna kahvaa sivun vaihdosten yli. Komponentti omistaa kahvan ja vapauttaa sen sivun purkamisen yhteydessä — älä kutsu itse FPDFText_ClosePage-funktiota sille

Tämä on edistynyt ominaisuus. Useimpien kutsujien kannattaa suosia korkean tason kääreitä CharacterCount, Character[I], CharacterRectangle[I], Find / FindNext — ne hallitsevat jo sisäisesti FPDF_TEXTPAGE-kahvan elinkaaren. Siirry raakaan kahvaan vain, kun tarvitset PDFium-API:ita, joita PDFium Delphi Component ei ole vielä altistanut

Remarks

Example

var TP: FPDF_TEXTPAGE;
TP := Pdf1.TextPage;
if Assigned(TP) then
  ShowMessage(Format('PDFium reports %d chars',
    [FPDFText_CountChars(TP)]));

See Also

CharacterCount, Character, Page, Find