RISC OS Open

RISC OS  OPEN


A fast and easily customised operating system for devices using ARM processor cores.

Documentation: Message_DataSave (Version #2)

Programmer’s Reference Manuals
» Part 7 – The Desktop
» The Window Manager
» Messages
» Message Codes
» Message_DataSave

Message_DataSave

(Code &1)

Message Block
+20 Destination window handle
+24 Destination icon handle
+28 Destination screen x
+32 Destination screen y
+36 Estimated size
+40 Filetype of data (&1000 for directory, &2000 for application, -1 for untyped)
+44 Proposed leafname (zero terminated)

Use

This message is used to indicate that a task wants to save data to receiver.

Notes

If this message is ignored by the receiver, then the task originator should do nothing.

An application that receives this message should store the ‘my_ref’ of each DataSave message, to check against any future Message_Datasaved? message you might receive.

Normal use:
  • User has terminated a drag
  • Get the first four words with Wimp_GetPointerInfo
  • Send the message to mentioned window
Possible use:
  • Task sends Message_DataSaveAck (wishes to use file transfer)
  • Task sends Message_RamFetch? (wishes to use memory transfer)
  • Task does not reply (not interested in files of a specific filetype)

See also

   .