FlowChart.MergeUndoRecords Method

( a feature of FlowChartX Pro edition)

Merges several undo records into one composite record.

 Syntax

VB6

Public Sub MergeUndoRecords( _
    ByVal numRecords As Long _
)

C++

public:
void MergeUndoRecords (
    int numRecords
)

 Parameters

numRecords

The number of records to merge.

 Remarks

The specified number of records just before the current position in the undo queue are moved into one composite record. The composite record is placed in the queue, and when it is undone or redone, all records that compose it are undone or redone as one integral action. Invoking MergeUndoRecords removes all records after the current position in the undo queue. The method fails if the records in the queue are less than the specified number.

Use this method with caution - some properties can exert influence on how many records are created by seemingly identical sets of actions. For example if SelectAfterCreate is enabled, there are selection-change records inserted between item creation records.

Use the BeginUndoRecord and EndUndoRecord methods to create a composite record that stores programmatic actions done in a single method of your application. That allows creating a composite record without knowing how many actions would be recorded while the enclosed code executes.