src/hbwidgets/devicedialogs/hbdevicemessageboxsymbian.cpp
changeset 28 b7da29130b0e
parent 23 e6ad4ef83b23
child 30 80e4d18b72f5
--- a/src/hbwidgets/devicedialogs/hbdevicemessageboxsymbian.cpp	Thu Sep 02 20:44:51 2010 +0300
+++ b/src/hbwidgets/devicedialogs/hbdevicemessageboxsymbian.cpp	Fri Sep 17 08:32:10 2010 +0300
@@ -547,9 +547,14 @@
 }
 
 /*!
+    @stable
+    @hbwidgets
+
     \class CHbDeviceMessageBoxSymbian
     \brief CHbDeviceMessageBoxSymbian is a Symbian implementation of HbDeviceMessageBox.
 
+    <b>This class is Symbian only. Not available on other platforms.</b>
+
     CHbDeviceMessageBoxSymbian is intended for use by servers that don't run Qt event loop
     and cannot use HbDeviceMessageBox.
 
@@ -579,7 +584,8 @@
         <tr><td>EQuestion</td><td>Question icon</td><td>"Yes" and "No" buttons</td><td>No timeout</td><td>Button press</td><td>Question sound</td></tr>
     </table>
 
-    ShowL() displays a message box asynchronously. The function returns immediately. The launched
+    ShowL() displays a message box asynchronously. The function returns immediately.
+    A new message box is lauched every time ShowL() is called. The launched
     dialog can be updated by setters and then calling UpdateL(). Closing can be observed by a
     callback. Because each UpdateL() after the ShowL() requires interprocess communication,
     it's advisable to fully construct the device message box before displaying it.
@@ -599,7 +605,14 @@
     static functions contain a default set of properties depending on the message box type and their
     contents cannot be updated while the message box executes.
 
-    Supported icon animation formats are following:
+    If CHbDeviceMessageBoxSymbian has no observer set, the object can be deleted after
+    ShowL() has been called and device-dialog service takes care showing the message box. If
+    observer is set, message box is closed when CHbDeviceMessageBoxSymbian object goes out of
+    scope.  
+
+    An animation can replace an icon on device message box. Supported icon animation formats are
+    following:
+
     - GIF (.gif)
     - MNG (.mng)
         - Frame animations
@@ -680,9 +693,6 @@
     \endcode
 
     \sa HbDeviceMessageBox, HbMessageBox, MHbDeviceMessageBoxObserver
-
-    @stable
-    @hbwidgets
 */
 
 /*!