I just came across this message which addresses a problem that has been bothering me for a long time
Specifically: some applications of mine need to run maximized so I use SetPanelAttribute (hparent, ATTR_WINDOW_ZOOM, VAL_MAXIMIZE); to directly show the main panel to full screen. According to the function help, Setting the ATTR_WINDOW_ZOOM attribute always makes the panel visible so I do not need (and actually do not call) DisplayPanel to show the window. So far, so good.
A problem arises when the user tries to minimize the main window, as in some conditions he's not able to restore the window any more, leaving killing the program as the only solution to gain control again. The program however is still running in the background even if minimized.
This happens only if the window is minimized using "Show desktop" button in the taskbar: using window minimize button permits to restore it all the times.
Just to add a bit of salt 
if the window is minimized at least once using the minimize button, subsequent uses of Show desktop button do not prevent from restoring it normally! 
Now according to Yves post, if I first call DisplayPanel and then SetPanelAttribute to maximize it this problem do not appear any more. The first tests I made seem to abide by this statement.
Is this the expected behaviour? Can anybody explain why it is happening?
If this is the expected behaviour, in my opinion at least a note should be added to the help stating this risk.