SftPicture2 Documentation

SFT_NOCOLOR

Sentinel COLORREF value meaning "no color / use default". Used by SFT_TEXT (the colorFg field) and by the frameColor field of SFT_PICTURE_COLOR_SAMPLE pictures.

#define SFT_NOCOLOR     ((COLORREF)(-1))

A COLORREF field set to SFT_NOCOLOR tells the rendering code to use a sensible default - either inherit from a per-state field on the host control structure (for SFT_TEXT.colorFg) or skip the operation entirely (for SFT_PICTURE_COLOR_SAMPLE.frameColor, where SFT_NOCOLOR means "no border").

Per-product control structures expose their own product-specific NOCOLOR aliases (e.g. SFTBUTTON_NOCOLOR, SFTTREE_NOCOLOR) that all expand to the same (COLORREF)(-1) value. SFT_NOCOLOR and the per-product aliases are interchangeable - the underlying value is identical.

See Also SftPicture2 | SFT_PICTURE | SFT_TEXT