Colour property

Sets the background colour drawn between the page rectangles and around the document edges.

Color fills the area of the viewer client rectangle that lies outside the page artwork — the margin between consecutive pages, the area around the document when it is narrower than the viewport, and any region revealed by aggressive scrolling. Together with PageColor, PageBorderColor and PageShadowColor it determines the overall look of the reader.

The most common dark-mode reader effect is achieved by setting Color := clBlack (or a deep grey such as $303030) and keeping PageColor light so the paper still appears bright. For a printed-page metaphor leave Color at its default and add a non-zero PageShadowSize to give each page a drop shadow against the background.

The colour is also visible during the brief moment a page is still being rasterised by PDFium — before the first bitmap is available the viewer paints LoadingColor on top of Color, then replaces it with the rendered page bitmap once it arrives.

• Persistent property — saved to the form file. Defaults to clBtnFace from the inherited declaration; assign explicitly for a predictable look across themes.
• VCL and LCL both honour the property; under Windows the background is drawn through GDI, under Lazarus through the active widget set's canvas.
• This colour is the viewport background only; the inside of each page rectangle is controlled by PageColor and is replaced by document content once the page renders.
• Pair Color with PageBorderColor for a clear separation between the page area and the surrounding background, especially when the page background is also dark.

PageColor, PageBorderColor, PageShadowColor, LoadingColor