[Overview][Constants][Types][Classes][Procedures and functions][Index] | Reference for unit 'ComCtrls' (#lcl)

# TStatusBar.UpdateHandleObject

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

## Declaration

Source position: comctrls.pp line 146

`protected procedure TStatusBar.UpdateHandleObject(`
`PanelIndex: Integer;`
`PanelParts: TPanelParts`
`); virtual;`

## Arguments

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

## 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

TStatusBar.Panels |  | Collection with the TStatusPanel instances defined for the control.
TStatusBar.SimplePanel |  | Indicates if a single panel is displayed in the status bar with the text in SimpleText.
TStatusBar.BiDiMode |  | Indicates whether text controls use in bi-directional reading.
TStatusBar.Loaded |  | Loaded calls inherited method and fixes handles if needed.
TStatusBar.OnDrawPanel |  | Event handler signalled to draw a panel in the status bar.