SubTitleFont

Class: TEgColumn

property SubTitleFont: TFont;

Font used to draw SubTitle. Unlike Title.Font (which belongs to the native TColumnTitle), SubTitleFont is a genuinely separate TFont object owned by this column, created with the column and freed when it is destroyed.

SubTitleFont.Size can never exceed Title.Font.Size - enforced both when SubTitleFont itself is changed (a larger value is clamped down immediately) and again at paint time (covering Title.Font shrinking afterward, or an OnBeforeDrawTitle handler pushing either size at paint time). A configured value larger than Title.Font.Size is not silently lost - only capped for as long as Title.Font.Size stays smaller; increasing Title.Font.Size again immediately uncaps it.

Only SubTitleFont.Color, .Size, and .Bold (via .Style) are ever consulted - .Name follows whatever this column’s Title.Font.Name-like default was set to at creation and is not exposed separately for editing in the TestGrid demo dialog, though it remains a fully usable TFont property from code.

SubTitleFont.Color is only the starting point for what is actually drawn: at paint time the color is automatically nudged lighter or darker if it would otherwise be too low-contrast against the cell’s own background, so the on-screen result can differ from the configured value in low-contrast combinations - see OnBeforeDrawTitle for details.

See Also

(C) 2026 Easygate, Lda