FontWeight - TPdf - PDFiumPas

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.

Component: TPdf · Unit: PDFium

Geeft de CSS-achtige gewichtsklasse, oftewel boldness, van het lettertype terug dat door een paginaobject op de huidige pagina wordt gebruikt. Typische waarden zijn 400 voor regular en 700 voor bold

Syntaxis

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

Beschrijving

FontWeight rapporteert de gewichtsklasse van het lettertype waarnaar het paginaobject op de opgegeven index verwijst, overeenkomstig de CSS / OpenType-conventie: 100 (Thin) tot 900 (Black), met 400 = Regular en 700 = Bold. De waarde wordt afgeleid uit de ingebedde lettertypebeschrijving of, voor niet-ingebedde lettertypen, uit de substitutietabel van PDFium

De index is de 0-based page object-index, geldig van 0 tot ObjectCount - 1. Alleen tekstobjecten hebben een betekenisvolle weight; het opvragen van een niet-tekstobject geeft 0 terug. Gebruik voor weights die aan afzonderlijke uitgehaalde karakters zijn gekoppeld, in plaats van aan de lettertypedictionary van een paginaobject, CharacterFontWeight

De pagina moet actief zijn (PageNumber moet al zijn ingesteld). Het gewicht wordt gedecodeerd uit de font handle die via FontHandle is verkregen; als het lettertype zelf geen gewicht declareert, geeft PDFium 0 terug en doet de property hetzelfde

Parameters

Index

0-based paginaobjectindex, in het bereik 0..ObjectCount - 1. Alleen tekstobjecten leveren een niet-nul weight op

Opmerkingen

Standaard mapping: 100 Thin, 200 ExtraLight, 300 Light, 400 Regular, 500 Medium, 600 SemiBold, 700 Bold, 800 ExtraBold, 900 Black
Geeft 0 terug wanneer het paginaobject geen tekst is, wanneer de font handle ongeldig is of wanneer geen gewicht is gecodeerd
De visuele boldness die uiteindelijk op het scherm te zien is, hangt ook af van gesynthetiseerde bolding-vlaggen in de lettertypedictionary — gewicht alleen vertelt niet altijd het hele verhaal
Veel ingebedde subset-lettertypen coderen één enkel gewicht, ook al levert de bronfamilie er meerdere — neem niet aan dat het document 100/200/etc. bevat alleen omdat 700 is gerapporteerd
Gebruik voor de weight die bij een specifiek uitgehaald karakter hoort (tekstpagina-index) liever CharacterFontWeight

Voorbeeld

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;

Zie ook

CharacterFontWeight, FontFamilyName, FontItalicAngle, FontHandle, ObjectCount

FontWeight Eigenschap