Today Screen Messages
The following messages are used with the Today Screen API.
| Message | Description |
|---|---|
| TODAYM_GETCOLOR | Send this message to get Today color information for the Today Screen. If you send a TODAYM_GETCOLOR message with TODAYCOLOR_TEXT as the WPARAM, you get back a COLOREF for the font color. See also the TODAYCOLOR_TEXT constant. |
| TODAYM_DRAWWATERMARK | Send this message to ask the Shell to draw a portion of the background (watermark) bitmap. |
| WM_TODAYCUSTOM_CLEARCACHE | This message is sent to a Today custom item's window to indicate that it is about to be unloaded. The WPARAM contains a pointer to the TODAYLISTITEM structure for the item. Upon receipt of this message, the item should discard any cached data pertaining to the item; update the grfFlags, prgbCachedData, and cbCachedData members of the structure and return. |
| WM_TODAYCUSTOM_QUERYREFRESHCACHE | This message is sent to a Today custom item's window to determine whether the data pertaining to the item has been updated or not. The WPARAM contains a pointer to the TODAYLISTITEM structure for the item. If the item needs updating, it should set the cyp member of the structure to the height of the item and return TRUE. The Today screen will redraw and resize the item as needed. If the item does not need updating, it should return FALSE in response to this message.
This message is also used for the item to set the cyp member of the TODAYLISTITEM structure (which is initialized to 0) to the appropriate height. The item should set the height and return TRUE the first time the message is received and return FALSE after that. |
See Also
TODAYCOLOR_TEXT
Send feedback on this topic to the authors.
© 2005 Microsoft Corporation. All rights reserved.