Share via

InvisibleApp.ScreenUpdating Property

  • Article
Visio Automation Reference

Determines whether the screen is updated (redrawn) during a series of actions. Read/write.

Version Information
 Version Added:  Visio 3.0

Syntax

expression.ScreenUpdating

expression   A variable that represents an InvisibleApp object.

Return Value
Integer

Remarks

Use the ScreenUpdating property to increase performance during a series of actions. For example, you can turn off screen updating while a series of shapes are created so that the screen is not redrawn after each shape appears. Then you can turn screen updating on to update the screen.

If you send a large number of commands to a Microsoft Office Visio instance while screen updating is turned off, the Visio instance may redisplay the screen occasionally to flush its buffers.

If a program neglects to turn screen updating on after turning it off, the Visio instance turns screen updating back on when a user performs an operation.

ms428352.vs_note(en-us,office.12).gif  Note
Beginning with Visio 2000, the ShowChanges property is included. The ShowChanges and ScreenUpdating properties are similar in that they are both designed to increase performance during a series of actions, but they work differently. Setting the ShowChanges property also sets the ScreenUpdating property, but setting the ScreenUpdating property does not set the ShowChanges property. For a comparison of these two properties, see the ShowChanges property.

Example

This Microsoft Visual Basic code snippet shows how to use the ScreenUpdating property.

Visual Basic for Applications 
  'Turn off screen updating to improve performance during
'the series of actions that follow. 
 Visio.Application.ScreenUpdating = False

'Drop several shapes.
'Set the shapes' text.
'Connect the shapes.
'Format the connectors.


'Turn screen updating on again when the actions are complete.
Visio.Application.ScreenUpdating = True

See Also