AddCurrentViewStateToHistory Method

Creates a new ViewHistoryItem object using the current state of the C1PreviewPane.

The newly created object is then added to the ViewHistory collection. Adding of the new state to history is cancelled if the Document property of the current preview pane is null, or if the specified action should not be saved according to the HistoryOptions.SavedActions value of the current pane's HistoryOptions.

Adding of the new state to history can also be cancelled in the HistoryItemAdding event.

Syntax

Visual Basic
C#

'Declaration
 
Public Function AddCurrentViewStateToHistory( _
   ByVal userAction As HistorySavedActionsEnum, _
   ByVal historyItemCaption As System.String, _
   ByVal force As System.Boolean _
) As ViewHistoryItem

public ViewHistoryItem AddCurrentViewStateToHistory( 
   HistorySavedActionsEnum userAction,
   System.string historyItemCaption,
   System.bool force
)

Parameters

userAction: A HistorySavedActionsEnum value defining the user action associated with the new history item.
historyItemCaption: The caption of the new history item.
force: If true, forces adding of the current state even if it is equal to the state stored in the CurrentHistoryEntry.

Return Value

The newly created ViewHistoryItem object, or null if the action was cancelled.

Reference

C1PreviewPane Class
C1PreviewPane Members