Help Center

CButton.SetStatemethod

Sets the highlight state of a button.

WindowsmethodCButton.incdocumented

Syntax

SUB SetState (BYVAL hButton AS HWND, BYVAL bstate AS BOOLEAN)

Parameters

NameDescription
bstateA BOOLEAN that specifies whether the button is highlighted. A value of TRUE highlights the button. A value of FALSE removes any highlighting.

Description

Sets the highlight state of a button. The highlight state indicates whether the button is highlighted as if the user had pushed it.

Remarks

Highlighting affects only the appearance of a button. It has no effect on the check state of a radio button or check box.

A button is automatically highlighted when the user positions the cursor over it and presses and holds the left mouse button. The highlighting is removed when the user releases the mouse button.

Example

CButton.SetState(hButton, TRUE)

Reference

  • Include file CButton.inc
  • Defined in AfxNova/CButton.inc:357
  • Documented in Windows/WIndows Controls/CButton Class.md
  • Topic: CButton Class