PageColor - TPdfView - PDFium Delphi Component

Component: TPdfView · Unit: PDFium

Kolor tła malowany pod renderowaną stroną PDF, niezależny od Color otaczającej kontrolki Domyślnie ma wartość clWhite, więc strony PDF pozostają papierowo białe nawet wtedy, gdy Color kontrolki hosta jest ciemny

Syntax

property PageColor: TColor;

Description

Przed v1.18.0 wyrenderowana strona PDF używała właściwości Color komponentu TPdfView jako tła. Było to niewygodne dla aplikacji w trybie ciemnym: ustawienie Color := clBlack, aby wtopić przeglądarkę w ciemny interfejs, malowało też strony PDF na czarnym tle, co powodowało nieprawidłowy wygląd każdego dokumentu z regionami przezroczystymi

PageColor rozdziela te dwie powierzchnie:

Color — tło obszaru przewijania, malowane w odstępie między prostokątem strony a krawędzią kontrolki. Zarządzane motywem aplikacji hosta
PageColor — tło strony PDF, malowane wewnątrz prostokąta strony, za wszelką wyrenderowaną zawartością. Domyślnie clWhite

Domyślne clWhite oznacza, że strony PDF renderują się jako papierowo białe niezależnie od motywu aplikacji hosta — zgodnie z wyglądem, jaki dają wszystkie inne czytniki PDF. Aplikacje, które wcześniej ustawiały TPdfView.Color, aby zmienić kolor strony PDF, powinny zamiast tego ustawiać PageColor; nowa wartość domyślna to jednoznaczna poprawa w typowym przypadku

Remarks

Warstwa renderowania strony maluje na wierzchu PageColor — strona z nieprzezroczystą zawartością pokazuje tę zawartość; strona z regionami przezroczystymi pokazuje przez nie PageColor
Połącz PageColor z PageShadowSize / PageShadowColor / PageBorderColor, aby uzyskać klasyczny wygląd „biała strona na ciemnym płótnie z cieniem”
PageColor jest typu TColor — alfa jest dorozumiana ($FF). Do półprzezroczystych nakładek użyj zamiast tego własnej procedury malowania

Example

// Dark-mode viewer pattern: dark scroll area, paper-white PDF page
PdfView1.Color := clBlack;
PdfView1.PageColor := clWhite;

// Sepia-tinted reader background
PdfView1.PageColor := $00C8E3F4; // BGR — soft amber

// Restore pre-v1.18.0 behavior where Color sets the page background
PdfView1.PageColor := PdfView1.Color;

PageColor Właściwość

Component: TPdfView · Unit: PDFium

Syntax

Description

Remarks

Example

See Also