index   headlines   <<previous   next>> 

System Messages
Developer Release Notes
BeOS Release 4.5

B_APP_SILENT_RELAUNCH

      B_APP_SILENT_RELAUNCH is sent to an application when (a) the user double-clicks the icon for a single/exclusive launch app that's already running, or (b) the user relaunches a single/exclusive launch app from the shell and doesn't include any command line arguments (if arguments are included, the app's ArgvReceived() function is called, as usual).

By default, an application reponds to B_APP_SILENT_RELAUNCH by (indirectly) invoking its own AppActivated() message. In other words, it doesn't do anything special. Some applications, however, may want to respond to the event by putting up a new document (for example), rather than simply bringing an existing window to the front. To do this, you catch the message in be_app's MessageReceived() function.

The message doesn't contain any fields.


B_CLIPBOARD_CHANGED

      This message is sent when data is committed to a monitored clipboard.  To monitor a clipboard, you call the new BClipboard::StartWatching() function.

FieldTypeMeaning
"be:clipboard"B_STRING_TYPE The clipboard's name.
"be:count"B_INT32_TYPE The number of times data has been committed to the clipboard. 


B_UNMAPPED_KEY_DOWN and B_UNMAPPED_KEY_UP

      B_UNMAPPED_KEY_DOWN and B_UNMAPPED_KEY_UP are sent to the focus view's window when the user depresses and releases a key that isn't mapped to a character (or set of characters).  The message format is the same as for B_KEY_UP and B_KEY_DOWN except that the unmapped versions lack the "byte", "bytes", and "raw_char" fields:

FieldTypeMeaning
"when"B_INT64_TYPE Event time in microseconds since 01/01/70.
"key"B_INT32_TYPE The code for the key that was pressed or released.
"modifiers"B_INT32_TYPE The modifiers keys that were down at the time of the event.
"states"B_UINT8_TYPE The 16-byte vector that records the state of the keyboard.
"be:key_repeat"B_INT32_TYPE The "iteration number" of the event.

There are no hook functions for these messages.


B_WINDOW_MOVE_TO and B_WINDOW_MOVE_BY

      These new window messages move the window that receives them to an absolute location or by a relative amount. BWindow catches these messages in its MessageReceived() implementation and invokes MoveTo() or MoveBy() in response.

FieldTypeMeaning
"data"B_POINT_TYPE Absolute location (B_WINDOW_MOVE_TO), or amount to move the window (B_AMOUNT_MOVE_BY).



 index   headlines   <<previous   next>> 

BeOS Release 4.5


Copyright © 1999 Be, Inc.  All rights reserved.