Sign in Join
FPDoc Onlineexperiment

TCustomForm.CMIconChanged procedure

Member of TCustomFormprotectedIn unit Forms

Handles the CM_ICONCHANGED control message for the form.

Declaration

pascal
procedure CMIconChanged(var Message: TLMessage); message

Arguments

Message

Control message for the notification.

Description

CMIconChanged is a method used to perform actions needed when the CM_ICONCHANGED control message is handled for a form. CMIconChanged calls a private method (IconChanged) to free and re-create handle(s) for icons used on the form.

The CM_ICONCHANGED control message occurs when a new value is assigned to the Icon property, and when the BorderStyle property is changed. At run-time, the widgetset class is notified by calling its SetIcon method when BorderStyle contains a value that allows icons. bsDialog and bsNone do not display icons.

Modified in LCL version 4.0 to use assigned handles in SmallIconHandle and BigIconHandle when BorderStyle is changed to a value other than bsNone or bsDialog.

See also

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.