FontWeight - TPdf - PDFiumPas

Cette entrée API conserve identifiants, signatures, blocs de code et termes PDF dans leur forme d’origine.

Composant: TPdf · Unité: PDFium

Renvoie le poids de style CSS (graisse) de la police utilisée par un objet de page sur la page courante. Les valeurs typiques sont 400 pour normal et 700 pour gras

Syntaxe

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

Description

FontWeight indique la classe de poids de la police référencée par l'objet de page à l'index donné, en suivant la convention CSS / OpenType : 100 (Thin) jusqu'à 900 (Black), avec 400 = Regular et 700 = Bold. Elle est dérivée du descripteur de police incorporé ou, pour les polices non incorporées, de la table de substitution de PDFium

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.

Une page doit être active (PageNumber déjà défini). Le poids est décodé à partir du handle de police obtenu via FontHandle ; si la police elle-même ne déclare aucun poids, PDFium renvoie 0 et la propriété fait de même

Paramètres

Index

Indice 0-based d'objet de page, dans la plage 0..ObjectCount - 1. Seuls les objets de texte produisent un poids non nul

Remarques

Correspondance standard : 100 Thin, 200 ExtraLight, 300 Light, 400 Regular, 500 Medium, 600 SemiBold, 700 Bold, 800 ExtraBold, 900 Black
Renvoie 0 lorsque l'objet de page n'est pas du texte, lorsque le handle de police est invalide ou lorsqu'aucun poids n'est encodé
La graisse visuelle finalement affichée à l'écran dépend aussi des indicateurs de gras synthétisé dans le dictionnaire de police — le poids seul ne raconte pas toujours toute l'histoire
Beaucoup de polices sous-ensemble incorporées n'encodent qu'un seul poids alors que la famille source en propose plusieurs — n'assumez pas que le document contient 100/200/etc. simplement parce qu'un 700 a été signalé
Pour le poids associé à un caractère extrait spécifique (index de page de texte), appelez plutôt CharacterFontWeight

Exemple

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;

Voir aussi

CharacterFontWeight, FontFamilyName, FontItalicAngle, FontHandle, ObjectCount

FontWeight Propriété