During my portation of a widget to mobile devices I used the Widget Emulator for testing the docked mode.
I don't know if it's a error of the emulator or if it's described wrong in this (and several other articles).
At the event onwidgetmodechange there's:
- widget.widgetMode = undefined //should work as this article says
- widget.mode = widget //not updated (start mode?)
- evt.mode = undefined //should work aswell
- evt.widgetMode = docked //mode in which the widget has changed

Maybe this will help someone.