]> git.saurik.com Git - wxWidgets.git/blobdiff - interface/wx/animate.h
Note that CanCut / CanCopy / CanPaste are not currently supported on the OSX WebKit...
[wxWidgets.git] / interface / wx / animate.h
index 62e2ab5a8fec5a3fb6bf816e8d03e900513a6d1f..5b4e5b5cde8ddbc98c98d11077e88526d68df8a8 100644 (file)
@@ -3,7 +3,7 @@
 // Purpose:     interface of wxAnimation* classes
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Purpose:     interface of wxAnimation* classes
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
-// Licence:     wxWindows license
+// Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 /**
 /////////////////////////////////////////////////////////////////////////////
 
 /**
@@ -25,7 +25,6 @@ enum wxAnimationType
 
 /**
     @class wxAnimationCtrl
 
 /**
     @class wxAnimationCtrl
-    @wxheader{animate.h}
 
     This is a static control which displays an animation.
     wxAnimationCtrl API is as simple as possible and won't give you full control
 
     This is a static control which displays an animation.
     wxAnimationCtrl API is as simple as possible and won't give you full control
@@ -50,7 +49,7 @@ enum wxAnimationType
 
     @nativeimpl{wxgtk,wxmsw}
 
 
     @nativeimpl{wxgtk,wxmsw}
 
-    <!-- @appearance{animationctrl.png} -->
+    @appearance{animationctrl.png}
 
     @see wxAnimation, @sample{animate}
 */
 
     @see wxAnimation, @sample{animate}
 */
@@ -71,7 +70,7 @@ public:
     /**
         Creates the control with the given @a anim animation.
 
     /**
         Creates the control with the given @a anim animation.
 
-        After control creation you must explicitely call Play() to start to play
+        After control creation you must explicitly call Play() to start to play
         the animation. Until that function won't be called, the first frame
         of the animation is displayed.
 
         the animation. Until that function won't be called, the first frame
         of the animation is displayed.
 
@@ -177,12 +176,17 @@ public:
 
 /**
     @class wxAnimation
 
 /**
     @class wxAnimation
-    @wxheader{animate.h}
 
     This class encapsulates the concept of a platform-dependent animation.
     An animation is a sequence of frames of the same size.
     Sound is not supported by wxAnimation.
 
 
     This class encapsulates the concept of a platform-dependent animation.
     An animation is a sequence of frames of the same size.
     Sound is not supported by wxAnimation.
 
+    Note that on wxGTK wxAnimation is capable of loading the formats supported
+    by the internally-used @c gdk-pixbuf library (typically this means only
+    @c wxANIMATION_TYPE_GIF).
+    On other platforms wxAnimation is always capable of loading both GIF and ANI
+    formats (i.e. both @c wxANIMATION_TYPE_GIF and @c wxANIMATION_TYPE_ANI).
+
     @library{wxadv}
     @category{gdi}
 
     @library{wxadv}
     @category{gdi}
 
@@ -205,7 +209,7 @@ public:
         @param name
             The name of the file to load.
         @param type
         @param name
             The name of the file to load.
         @param type
-            See LoadFile for more info.
+            See LoadFile() for more info.
     */
     wxAnimation(const wxString& name,
                 wxAnimationType type = wxANIMATION_TYPE_ANY);
     */
     wxAnimation(const wxString& name,
                 wxAnimationType type = wxANIMATION_TYPE_ANY);
@@ -247,11 +251,10 @@ public:
 
         @param stream
             The stream to use to load the animation.
 
         @param stream
             The stream to use to load the animation.
+            Under wxGTK may be any kind of stream; under other platforms
+            this must be a seekable stream.
         @param type
         @param type
-            One of the following values:
-             @li wxANIMATION_TYPE_GIF: loads an animated GIF file;
-             @li wxANIMATION_TYPE_ANI: load an ANI file;
-             @li wxANIMATION_TYPE_ANY: tries to autodetect the filetype.
+            One of the ::wxAnimationType enumeration values.
 
         @return @true if the operation succeeded, @false otherwise.
     */
 
         @return @true if the operation succeeded, @false otherwise.
     */
@@ -264,7 +267,7 @@ public:
         @param name
             A filename.
         @param type
         @param name
             A filename.
         @param type
-            One of the wxAnimationType values; wxANIMATION_TYPE_ANY
+            One of the ::wxAnimationType values; wxANIMATION_TYPE_ANY
             means that the function should try to autodetect the filetype.
 
         @return @true if the operation succeeded, @false otherwise.
             means that the function should try to autodetect the filetype.
 
         @return @true if the operation succeeded, @false otherwise.