HeaderPane
Main
Hide

SftButton/DLL 3.0 - Button Control

Share Link
Print

Click Regions

SftButton supports four click-region modes through iClickStyle on SFTBUTTON_CONTROL. The click region is the area inside the button that generates a BN_CLICKED notification when the user presses the primary mouse button.

StyleClick region
SFTBUTTON_CLICKSTYLE_CONTROL (0)The entire button rectangle. Default. Matches the behavior of a standard Windows push button.
SFTBUTTON_CLICKSTYLE_EXACT (1)Only the area actually occupied by text and images. Clicking on the background padding around the text does not count.
SFTBUTTON_CLICKSTYLE_IMAGESONLY (2)Only pixels covered by an image layer (Picture1 / Picture2 / PictureBG and their per-state variants) generate clicks.
SFTBUTTON_CLICKSTYLE_TEXTONLY (3)Only pixels covered by text generate clicks.

Click regions let you implement buttons whose interactive area differs from their visual area - for example a button that renders a background image across its full rectangle but only activates on the foreground icon. The dropdown arrow (if enabled) has its own fixed click region and is unaffected by iClickStyle.

Hover regions

Hover detection has a parallel setting, iHoverStyle. The hover region can be independent of the click region. See Hover Detection.


Last Updated 04/25/2026 - (email)
© 2026 Softel vdm, Inc.