Pinboard

Introduction and Overview

The Pinboard has been updated to provide additional backdrop types and to allow applications to control the entire background window if necessary. The application now uses the ImageFileRender interfaces to render image files on the backdrop. This means that in addition to the Sprite and JPEG files which Pinboard has been able to render, it can also render any format which is supported by the ImageFileRender stack. In particular, this means that DrawFiles and PNGs may be used. The rendering of these images may be subject to delays in conversion for some image formats.

Messages

Message_ToggleBackdrop&400D1
Request the backdrop application to move the backdrop, or report its position
OffsetContents
024 (message size)
4Backdrop controlling application
8,12Reference numbers
16&400D1 (Message_ToggleBackdrop)
20Flags (if not present, assumed 0):
Bit(s)Meaning
0-1Type of toggle:
ValueMeaning
0Toggle
1Front
2Back
3Notify of status
2-31Reserved, must be zero
Task
Task
Message must be sent directly to task

Message may only be sent normally (reason code 17)

This message is broadcast by applications to request that the backdrop application move the backdrop to the front, back, toggles, or notify the application of the backdrop window's position. This message is then sent back to the application to indicate the new position.