ScreenUpdating プロパティ

Microsoft Office Visio 2003 SDK ドキュメント

ScreenUpdating プロパティ

一連のアクション中に、画面を更新 (再描画) するかどうかを指定します。

intRet = object**.ScreenUpdating**

object**.ScreenUpdating** = intExpression

intRet     整数型 (Integer) の値です。画面更新がオフの場合はゼロ (0)、画面更新がオンの場合は -1 です。

object     必須項目です。Application オブジェクトを返す式です。

intExpression     必須の整数型 (Integer) 変数です。画面更新をオフにする場合はゼロ (0)、画面更新をオンにする場合はゼロ以外の値です。

初出バージョン

3.0

備考

ScreenUpdating プロパティは、一連のアクション中のパフォーマンスを向上するために使用します。たとえば、一連の図形を作成している間は画面更新をオフにすると、図形を表示するたびに画面が再描画されなくなります。その後、画面更新をオンにすると、画面が更新されます。

画面更新がオフの場合に Visio インスタンスに大量のコマンドを送信すると、バッファをフラッシュするために Microsoft Office Visio インスタンスが画面を再表示する場合があります。

画面更新をオフにした後に、プログラムが画面更新をオンにしなかった場合、Visio インスタンスはユーザーが操作を実行したときにオンに戻します。

メモ Visio 2000 以降、ShowChanges プロパティが追加されました。ShowChanges および ScreenUpdating プロパティは、共に一連のアクション中のパフォーマンスを向上するために設計されましたが、動作は異なります。ShowChanges プロパティを設定すると、ScreenUpdating プロパティも設定されますが、ScreenUpdating プロパティを設定しても、ShowChanges プロパティは設定されません。これら 2 つのプロパティの比較については、ShowChanges プロパティを参照してください。

この VBA (Microsoft Visual Basic for Applications) のコードは、ScreenUpdating プロパティの使用方法を示します。

  '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