FontWeight - TPdf - PDFium Delphi Component

Componente: TPdf · Unità: PDFium

Restituisce il peso in stile CSS (grassetto) del font usato da un oggetto pagina nella pagina corrente. I valori tipici sono 400 per regolare e 700 per grassetto

Syntax

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

Description

FontWeight riporta la classe di peso del font referenziato dall'oggetto di pagina all'indice dato, rispecchiando la convenzione CSS / OpenType: da 100 (Thin) fino a 900 (Black), con 400 = Regular e 700 = Bold. Il valore deriva dal font descriptor incorporato oppure, per i font non incorporati, dalla tabella di sostituzione di PDFium

L'indice è l'indice dell'oggetto di pagina a base zero, valido da 0 a ObjectCount - 1. Solo gli oggetti di testo portano un peso significativo; interrogare un oggetto non testuale restituisce 0. Per i pesi legati ai singoli caratteri estratti (anziché al dizionario font dell'oggetto di pagina) usa CharacterFontWeight

Una pagina deve essere attiva (PageNumber già impostato). Il peso viene decodificato dall'handle del font ottenuto via FontHandle; se il font stesso non dichiara un peso, PDFium restituisce 0 e la proprietà fa altrettanto

Parameters

Index

Indice dell'oggetto di pagina a base zero, nell'intervallo 0..ObjectCount - 1. Solo gli oggetti di testo producono un peso diverso da zero

Remarks

Mappatura standard: 100 Thin, 200 ExtraLight, 300 Light, 400 Regular, 500 Medium, 600 SemiBold, 700 Bold, 800 ExtraBold, 900 Black
Restituisce 0 quando l'oggetto di pagina non è testo, quando l'handle del font non è valido o quando non è codificato alcun peso
Il grassetto visivo visto a schermo dipende anche dai flag di bold sintetizzato dentro il dizionario font — il peso da solo non racconta tutta la storia
Molti font subset incorporati codificano un unico peso anche se la famiglia sorgente ne spedisce parecchi — non dare per scontato che il documento includa 100/200/ecc. solo perché è stato riportato un 700
Per il peso associato a uno specifico carattere estratto (indice nella text page), chiama CharacterFontWeight

Example

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;

FontWeight Proprietà