Language

The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15

API

SDK

Tips ‘n’ Tricks

Miscellaneous


:: com :: sun :: star :: awt ::

interface XAnimatedImages
Base Interfaces
XAnimatedImages
┗ ::com::sun::star::container::XContainer

::com::sun::star::container::XContainer
Description
allows other components to observer the insertion, removal, and replacement of image sets
Description
allows administrating a set of images, to be displayed as animated seres.

Components implementing this interface maintain a variable number of image sets. Components displaying those images will choose the best-fitting image set depending on the available space, and possibly other restrictions.

Since
OOo 3.4

Methods' Summary
getImageSetCount returns the number of images sets maintained by the component.  
getImageSet returns the URLs of the image set with the given index  
insertImageSet sets the URLs of the image set with the given index  
replaceImageSet replaces the image set given by index with a new one  
removeImageSet removes the image set with the given index  
Attributes' Summary
StepTime specifies the time in milliseconds between two animation steps.  
AutoRepeat specifies whether the animation should start over with the first image of the image series when the last image has been played.  
ScaleMode controls the way the images are scaled up or down, when the available space is larger or smaller than what is needed for them.  
Methods' Details
getImageSetCount
long
getImageSetCount();

Description
returns the number of images sets maintained by the component.
getImageSet
sequence< string >
getImageSet( [in] long  i_index )
raises( ::com::sun::star::lang::IndexOutOfBoundsException );

Description
returns the URLs of the image set with the given index
Parameter i_index
the index of the set those image URLs are to be retrieved. Must be greater than or equal to 0, and smaller than the value returned by getImageSetCount.
Throws
::com::sun::star::lang::IndexOutOfBoundsException if the i_index is not a valid index.
insertImageSet
void
insertImageSet( [in] long  i_index,
[in] sequence< string >  i_imageURLs )
raises( ::com::sun::star::lang::IndexOutOfBoundsException );

Description
sets the URLs of the image set with the given index
Parameter i_index
the index at which a new image set should be inserted. Must be greater than or equal to 0, and smaller than or equal to the value returned by getImageSetCount.
Parameter i_imageURLs
the URLs for the images for the given set. Will be resolved using a ::com::sun::star::graphic::GraphicProvider.
Throws
::com::sun::star::lang::IndexOutOfBoundsException if the i_index is not a valid index.
replaceImageSet
void
replaceImageSet( [in] long  i_index,
[in] sequence< string >  i_imageURLs )
raises( ::com::sun::star::lang::IndexOutOfBoundsException );

Description
replaces the image set given by index with a new one
Parameter i_index
the index of the set those image URLs are to be replaced. Must be greater than or equal to 0, and smaller than the value returned by getImageSetCount.
Parameter i_imageURLs
the URLs for the images for the given set. Will be resolved using a ::com::sun::star::graphic::GraphicProvider.
Throws
::com::sun::star::lang::IndexOutOfBoundsException if the i_index is not a valid index.
removeImageSet
void
removeImageSet( [in] long  i_index )
raises( ::com::sun::star::lang::IndexOutOfBoundsException );

Description
removes the image set with the given index
Parameter i_index
the index of the set to remove. Must be greater than or equal to 0, and smaller than the value returned by getImageSetCount.
Throws
::com::sun::star::lang::IndexOutOfBoundsException if the i_index is not a valid index.
Attributes' Details
StepTime
long StepTime;
Description
specifies the time in milliseconds between two animation steps.

This is the minimum time, the actual value might be longer due to system load. The default value will be 100 ms.

AutoRepeat
boolean AutoRepeat;
Description
specifies whether the animation should start over with the first image of the image series when the last image has been played.

The default value for this attribute is true.

ScaleMode
short ScaleMode
set raises (::com::sun::star::lang::IllegalArgumentException);

Description
controls the way the images are scaled up or down, when the available space is larger or smaller than what is needed for them.

Allowed values are those from the ImageScaleMode constants group.

Top of Page

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.