PDFium Component Docs

FontHandle Egenskap

Denna API-post behåller identifierare, signaturer, kodblock och PDF-termer i ursprunglig form.
Komponent: TPdf  ·  Enhet: PDFium
Returns the native FPDF_FONT handtaget för teckensnittet som används av ett sidobjekt. Handtaget ger avancerade anropare direkt åtkomst till PDFium-teckensnitts-API:er som inte är omslutna av komponenten.

Syntax

property FontHandle[Index: Integer]: FPDF_FONT; // read only

Beskrivning

FontHandle returns the raw PDFium font pointer (FPDF_FONT) associerat med textsidobjektet på det angivna indexet. Internt är värdet det som PDFium returnerar från FPDFTextObj_GetFont; most of the other Font* properties on TPdfFontAscent, FontDescent, FontFamilyName, FontBaseName, FontIsEmbedded, FontItalicAngle, FontWeight, FontData — är bekvämlighetswrappers byggda ovanpå den.

The index is a 0-based page-object index in the range 0..ObjectCount - 1. Endast objekt av typen text har ett teckensnitt; för bild-, path- eller shading-objekt returnerar anropet nil. En sida måste vara aktiv innan egenskapen läses.

Det returnerade handtaget ägs av PDFium och förblir giltigt bara medan den aktuella sidan är laddad. Frigör det inte, lagra det inte över sidbyten och anropa inga destruktiva PDFium-API:er mot det — behandla det som en ogenomskinlig skrivskyddad symbol.

Parametrar

Index0-based page-object index. Use ObjectType first to confirm the object is text; non-text objects return nil.

Anmärkningar

Exempel

var
  I: Integer;
  H: FPDF_FONT;
begin
  Pdf1.PageNumber := 1;
  for I := 0 to Pdf1.ObjectCount - 1 do
  begin
    H := Pdf1.FontHandle[I];
    if H <> nil then
      Memo1.Lines.Add(Format('Object %d uses font %s',
        [I, Pdf1.FontFamilyName[I]]));
  end;
end;

Se även

FontFamilyName, FontBaseName, FontIsEmbedded, FontData, ObjectCount, ObjectType