Sign in Join
FPDoc Onlineexperiment

TStatusBar.UpdateHandleObject procedure

Member of TStatusBarprotectedIn unit ComCtrls

Updates the handle for the status bar when one or all of the panels on the control need to be updated.

Declaration

pascal
procedure UpdateHandleObject(PanelIndex: Integer; 
 PanelParts: TPanelParts); virtual

Arguments

PanelIndex

Ordinal position for the panel updated on the control, or -1 for all panels.

PanelParts

Description

UpdateHandleObject is a method used to update the widgetset handle for the status bar. It calls either the Update or PanelUpdate method in the widget when one or all of the Panels on the status bar need to be redrawn.

PanelIndex contains the ordinal position for the panel(s) updated on the status bar. A value in the range 0..Panels.Count-1 causes the corresponding panel to be redrawn when the status bar is updated. -1 (or any value less than zero actually) causes all of the defined Panels to be redrawn.

No actions are performed in the method when the handle has not been allocated for the widgetset class, or when SimplePanel is enabled and PanelIndex contains a value other than 0 (zero).

UpdateHandleObject is called when the visual appearance for the status bar has been changed. It occurs when the component is loaded from its LCL resource, and when the handle for the widget is allocated. It is also called when a new value is assigned to the SimplePanel or BiDiMode properties.

See also

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