FontWeight - TPdf - PDFiumPas

Denna API-post behåller identifierare, signaturer, kodblock och PDF-termer i ursprunglig form.

Komponent: TPdf · Enhet: PDFium

Returns the CSS-style weight (boldness) för teckensnittet som används av ett sidobjekt på den aktuella sidan. Typical values are 400 for regular and 700 for bold.

Syntax

property FontWeight[Index: Integer]: Integer; // read only

Beskrivning

FontWeight rapporterar viktklassen för teckensnittet som sidobjektet vid det angivna indexet refererar till, i linje med CSS- / OpenType-konventionen: 100 (Thin) upp till 900 (Black), med 400 = Regular och 700 = Bold. Den härleds från den inbäddade teckensnittsbeskrivaren eller, för icke-inbäddade teckensnitt, från PDFiums ersättningstabell.

The index is the 0-based page object index, valid from 0 to ObjectCount - 1. Only text objects carry a meaningful weight; querying a non-text object returns 0. For weights tied to individual extracted characters (rather than to a page object's font dictionary) use CharacterFontWeight.

A page must be active (PageNumber already set). The weight is decoded from the font handle obtained via FontHandle; om teckensnittet självt inte anger någon vikt returnerar PDFium 0 och egenskapen gör detsamma.

Parametrar

Index

0-based page-object index, in the range 0..ObjectCount - 1. Only text objects produce a non-zero weight.

Anmärkningar

Standard mapping: 100 Thin, 200 ExtraLight, 300 Light, 400 Regular, 500 Medium, 600 SemiBold, 700 Bold, 800 ExtraBold, 900 Black.
Returnerar 0 när sidobjektet inte är text, när teckensnittshandtaget är ogiltigt eller när ingen vikt är kodad.
The visual boldness ultimately seen on screen also depends on synthesized bolding flags inside the font dictionary — weight alone is not always the full story.
Many embedded subset fonts encode a single weight even though the source family ships several — do not assume the document includes 100/200/etc. just because a 700 was reported.
For the weight associated with a specific extracted character (text-page index), call CharacterFontWeight instead.

Exempel

var
  I, BoldCount: Integer;
begin
  Pdf1.PageNumber := 1;
  BoldCount := 0;
  for I := 0 to Pdf1.ObjectCount - 1 do
    if Pdf1.FontWeight[I] >= 600 then
      Inc(BoldCount);
  ShowMessage(IntToStr(BoldCount) + ' bold text objects on page 1');
end;

Se även

CharacterFontWeight, FontFamilyName, FontItalicAngle, FontHandle, ObjectCount

FontWeight Egenskap