Home / Autodocs / datatypes.library
NAME
- SaveDTObjectA
-
Save object's contents (V45)
SYNOPSIS
success = SaveDTObjectA( o, win, req, file, mode, saveicon, attrs );
ULONG SaveDTObjectA( Object *, struct Window *, struct Requester *,
success = SaveDTObject( o, win, req, file, mode, saveicon, tag1,
ULONG SaveDTObject( Object *, struct Window *, struct Requester *,
ULONG SaveDTObjectA( Object *, struct Window *, struct Requester *,
STRPTR, ULONG, BOOL, struct TagItem * );
... );
STRPTR, ULONG, BOOL, Tag, ... );
FUNCTION
This function saves the contents of an object into a file.
The function opens the named file and saves the object's contexts into it (DTM_WRITE). Then it closes the file. If the DTM_WRITE method returns success and the saveicon option is TRUE, matching icon is saved.
If DTM_WRITE returns 0, the file will be deleted.
The function opens the named file and saves the object's contexts into it (DTM_WRITE). Then it closes the file. If the DTM_WRITE method returns success and the saveicon option is TRUE, matching icon is saved.
If DTM_WRITE returns 0, the file will be deleted.
INPUTS
- o
-
Object like returned from NewDTObjectA
- win
-
Window the object is attached to
- req
-
Requester the object is attached to
- file
-
file name to save to
- mode
-
Save mode, (RAW, IFF etc.), one of the DTWM_#? identifiers
- saveicon
-
Save icon? Does not overwrite an existing icon.
- attrs
-
Additional attributs
TAGS
Subclass specific.
For example, animation.datatype V41 recognizes ADTA_Frame (start frame to save) and ADTA_Frames (number of frames to save).
For example, animation.datatype V41 recognizes ADTA_Frame (start frame to save) and ADTA_Frames (number of frames to save).
RESULT
- success
-
The return value returned by DTM_WRITE or NULL for an error.
BUGS
SEE ALSO
datatypesclass/DTM_WRITE