property ThumbnailCacheMaxBytes: Int64; // read and write, default 64 MiB
Chaque vignette conservée est mesurée comme sa largeur de bitmap × hauteur × quatre octets, et StoredBytes dans ThumbnailCacheStatistics en rapporte la somme. Les entrées négatives en cache — l’absence mémorisée d’un /Thumb intégré — comptent zéro octet
La rétention exige que ce plafond et ThumbnailCacheMaxEntries soient tous deux positifs, et une entrée n’est conservée que tant que les deux plafonds le permettent. Un bitmap unique plus grand que ce seul plafond n’est jamais conservé
Réduire la valeur évince immédiatement les entrées les moins récemment utilisées, et chaque entrée abandonnée augmente EvictionCount dans ThumbnailCacheStatistics
Définir le plafond à zéro désactive la rétention tout en laissant l’extraction et le rendu pleinement disponibles ; chaque consultation compte alors comme un échec
Des valeurs négatives lèvent EPdfError
Les entrées conservées réservent aussi leurs octets mesurés dans le régulateur partagé CacheBudgetBytes, de sorte que ce plafond borne spécifiquement le cache de vignettes tandis que le régulateur borne l’instance dans son ensemble
La propriété est protégée par le verrou de rendu utilisé par l’accès natif aux pages PDFium ; la modifier attend donc brièvement les rendus en cours
Pdf.ThumbnailCacheMaxBytes := Int64(96) * 1024 * 1024;
Stats := Pdf.ThumbnailCacheStatistics;
LogThumbnailBytes(Stats.StoredBytes);