Back to Devexpress

TdxUIAdornerManager.BeginUpdate Method

vcl-dxuiadorners-dot-tdxuiadornermanager-85151180.md

latest1.5 KB
Original Source

TdxUIAdornerManager.BeginUpdate Method

Disables repainting of the badge and/or guide UI adorner layers until the EndUpdate procedure call.

Declaration

delphi
procedure BeginUpdate;

Remarks

The UI adorner manager repaints the enabled adorner layers separately from the underlying form. Each change made to a guide or badge within the corresponding collection results in repainting the UI adorner layers on top of the parent form to reflect the changes. Therefore, performing multiple changes to adorners results in a sequence of multiple adorner layer repaint operations which can result in flickering and low application performance. To optimize the code performing multiple adorner appearance changes, enclose it within the BeginUpdate /EndUpdate procedure blocks.

The BeginUpdate procedure postpones the effect of changes made to adorners. Call the EndUpdate procedure to apply all the pending changes. Ensure that every BeginUpdate call is followed by an EndUpdate call, even if an exception occurs.

See Also

TdxUIAdornerManager Class

TdxUIAdornerManager Members

dxUIAdorners Unit