File Panel Messages

The file panel produces three messages: B_REFS_RECEIVED, B_SAVE_REQUESTED, and B_CANCEL. The first of these was discussed in "General Messages". It's produced when the user picks files to open from the panel. The other two messages are described below.

The file panel produces this message when the user asks the application to save a document. It has two data fields:

Field	Type code	Description
"directory"	B_REF_TYPE	An entry_ref referring to the directory where the document should be saved.
"name"	B_STRING_TYPE	The file name under which the document should be saved.

A cancel notification is sent whenever a file panel is hidden. This includes the Cancel button being clicked, the panel being closed, and the panel being hidden after an open or a save.

Field	Type code	Description
"old_what"	B_INT32_TYPE	The "previous" what value. This is only useful (and dependable) if you supplied the BFilePanel with your own BMessage: The what from your message is moved to the "old_what" field. If you didn't supply a BMessage, you should ignore this field (it could contain garbage).
"source"	B_POINTER_TYPE	A pointer to the BFilePanel object.

See the BFilePanel class in The Storage Kit chapter for more information.