SftButton/DLL 3.0 - Button Control

SFTBUTTON_NOCOLOR

Sentinel COLORREF value meaning "no color / use default". Used throughout SFTBUTTON_CONTROL's color fields and SFT_TEXT.colorFg. SFT_NOCOLOR is the equivalent name from the shared SftPicture2.h header; both names expand to the same value.

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

Any SFTBUTTON_CONTROL color field (colorBg, colorBgStart / colorBgEnd, colorBgHover, colorFg, colorDarkEdge and the rest) set to SFTBUTTON_NOCOLOR tells the control to use a sensible default: COLOR_BTNFACE for backgrounds, COLOR_BTNTEXT for text, COLOR_3DSHADOW / COLOR_3DHIGHLIGHT for borders - or the matching dark-mode / high-contrast palette color when those modes are active.

Setting either gradient endpoint (colorBgStart or colorBgEnd) to SFTBUTTON_NOCOLOR switches the background from gradient to solid fill using the corresponding solid color field (colorBg, colorBgFocus or colorBgHover).

See Also Colors and Gradients | SFTBUTTON_CONTROL