Restoreobjectactions.t[2759]

Superclass
Tree 		Property
Summary 		Method
Summary 		Property
Details 		Method
Details

Perform the save, using the filename given in our fname_ parameter, trimmed of quotes.

Restore :   SystemAction

Superclass Tree   (in declaration order)

Restore
        SystemAction
                IAction
                        Action
                                ReplaceRedirector
                                        Redirector
                                                object

Summary of Properties  

includeInUndo 

Inherited from SystemAction :
isRepeatable  timeTaken  turnsTaken 

Inherited from IAction :
againRepeatsParse 

Inherited from Action :
actionFailed  advanceOnFailure  allowAll  extraMessageParams  failCheckMsg  failedActionCountsAsTurn  implicitTimeTaken  isConversational  isImplicit  oldRoom  parentAction  parentAllowAll  preCond  redirectParent  reportImplicitActions  scopeList  spellingPriority  synthParamID  unhides  verifyObj  wasIlluminated 

Summary of Methods  

askAndRestore  execAction  filePromptFailed  filePromptFailedMsg  performRestore  startupRestore 

Inherited from SystemAction :
afterAction  exec  execCycle  getInputFile  turnSequence 

Inherited from IAction :
execResolvedAction  resolvedObjectsInScope  scoreObjects  setResolvedObjects 

Inherited from Action :
acknowledgeNotifyStatus  addExtraScopeItems  addImplicitTime  advanceTime  announceObject  beforeAction  buildImplicitActionAnnouncement  buildScopeList  checkAction  checkActionPreconditions  commandNotPresent  execGroup  getAll  getAllUnhidden  getMessageParam  implicitAnnouncement  reportAction  setMessageParam  setMessageParams  spPrefix  spSuffix  synthMessageParam  verify  verifyObjRole  wrapObjectsNP 

Inherited from ReplaceRedirector :
redirect 

Inherited from Redirector :
doInstead  doNested  doOtherAction 

Properties  

includeInUndoOVERRIDDENactions.t[2971]

There's no point in including this in undo. If the command succeeds, it's not undoable itself, and there won't be any undo information in the newly restored state. If the command fails, it won't make any changes to the game state, so there won't be anything to undo.

Methods  

askAndRestore ( )actions.t[2779]

Ask for a file and try to restore it. Returns true on success, nil on failure. (Failure could indicate that the user chose to cancel out of the file selector, that we couldn't find the file to restore, or that the file isn't a valid saved state file. In any case, we show an appropriate message on failure.)

execAction (cmd)OVERRIDDENactions.t[2760]
no description available

filePromptFailed ( )actions.t[2974]
error showing the input file dialog (or character-mode equivalent)

filePromptFailedMsg (msg)actions.t[2982]
error showing the input file dialog, with a system error message

performRestore (fname, code)actions.t[2889]
Restore a file. 'code' is the restoreCode value for the PostRestoreObject notifications. Returns true on success, nil on failure.

startupRestore (fname)actions.t[2850]
Restore a game on startup. This can be called from mainRestore() to restore a saved game directly as part of loading the game. (Most interpreters provide a way of starting the interpreter directly with a saved game to be restored, skipping the intermediate step of running the game and using a RESTORE command.)

Returns true on success, nil on failure. On failure, the caller should simply exit the program. On success, the caller should start the game running, usually using runGame(), after showing any desired introductory messages.

Adv3Lite Library Reference Manual
Generated on 01/03/2024 from adv3Lite version 1.6.2