The Be Book - Classes And Methods - The Storage Kit
The file panel produces three messages:
B_REFS_RECEIVED,
B_SAVE_REQUESTED, and B_CANCEL.
The first of these was discussed
here.
It's produced when the user picks files to open from
the panel. The other two messages are described below.
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. |
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. |
| Purpose: | Deliverable |
| Source: | The system. |
| Target: | App-defined. |
| Hook: |
Sent when the results of a live query change: If a new file meets the
query requirements,
B_ENTRY_CREATED
is sent. If a file that previously passed the query requirements no longer does,
B_ENTRY_REMOVED
is sent.
