DataRecordset.RefreshSettings Property

  • Article
Visio Automation Reference

Gets and sets options that determine how the data recordset is refreshed. Read/write.

ms367409.vs_note(en-us,office.12).gif  Note
This Visio object or member is available only to licensed users of Microsoft Office Visio Professional 2007.

Version Information
 Version Added:  Visio 2007

Syntax

expression.RefreshSettings

expression   An expression that returns a DataRecordset object.

Return Value
Long

Remarks

Constants for how a data recordset is refreshed are declared in the VisRefreshSettings enumeration in the Visio type library:

Constant Value Description

visRefreshNoReconciliationUI

2

Disables the Refresh Conflicts task pane in the Visio user interface (UI) after a refresh operation.

visRefreshOverwriteAll

1

When data is refreshed, overwrites all user changes made in the shape data of shapes linked to data in this recordset since the previous refresh operation. See note.

The default is for neither of the VisRefreshSettings flags to be turned on. (RefreshSettings = 0).

When visRefreshNoReconciliationUI is set, support for reconciling refresh conflicts in the Visio UI is disabled. As a developer, you should reconcile refresh conflicts programmatically by using the GetAllRefreshConflicts, GetMatchingRowsForRefreshConflict, and RemoveRefreshConflict methods.

ms367409.vs_note(en-us,office.12).gif  Note
In previous versions of Visio, shape data was called custom properties.

See Also