FileOpAction class | actions.t[2744]

A base class for file-oriented actions, such as SCRIPT, RECORD, and REPLAY. We provide common handling that prompts interactively for a filename; subclasses must override a few methods and properties to carry out the specific subclassed operation on the file.

`class FileOpAction : SystemAction`

Superclass Tree (in declaration order)

`FileOpAction`
`SystemAction`
`IAction`
`Action`
`ReplaceRedirector`
`Redirector`
`object`

Subclass Tree

(none)

Global Objects

(none)

Summary of Properties

`fileDisposition filePromptMsg fileTypeID includeInUndo isRepeatable showCancelMsg`

Inherited from `SystemAction` :
`timeTaken turnsTaken`

Inherited from `IAction` :
`againRepeatsParse`

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

``

``

Summary of Methods

`execAction performFileOp setUpFileOp`

Inherited from `SystemAction` :
`afterAction exec execCycle getInputFile turnSequence`

Inherited from `IAction` :
`checkAction execResolvedAction resolvedObjectsInScope scoreObjects setResolvedObjects`

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

Inherited from `ReplaceRedirector` :
`redirect`

Inherited from `Redirector` :
`askMissingLiteral doInstead doNested doOtherAction`

Properties

`fileDisposition` | `actions.t[2749]`

the file dialog open/save type

`filePromptMsg` | `actions.t[2746]`

our file dialog prompt message

`fileTypeID` | `actions.t[2752]`

the file dialog type ID

`includeInUndo` OVERRIDDEN | `actions.t[2823]`

we can't include this in undo, as it affects external files

`isRepeatable` OVERRIDDEN | `actions.t[2826]`

don't allow repeating with AGAIN

`showCancelMsg` | `actions.t[2755]`

show our cancellation mesage

Methods

`execAction (cmd)`OVERRIDDEN | `actions.t[2775]`

Each concrete action subclass must override this to carry out our operation. This is called when the user has successfully selected a filename for the operation.

`performFileOp (fname, ack, desc, :?)` | `actions.t[2766]`

Carry out our file operation.

'desc' is an optional named argument giving a description string entered by the user via the Save Game dialog. Some versions of the Save Game dialog let the user enter this additional information, which can be stored as part of the saved game metadata.

`setUpFileOp (ack)` | `actions.t[2786]`

ask for a file, and carry out our operation is we get one

Adv3Lite Library Reference Manual
Generated on 08/12/2025 from adv3Lite version 2.2.2