AnimationSetParameter (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Controls, pages and windows / Animation functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

AnimationSetParameter (Function)

In french: AnimationChangeParamètre

Changes one of the animation parameters used for:

an animated image (in an Image control),
an animated text (in a Static Text control).

New in version 2025

It is now possible to modify the animation parameters used for animated text in a Static Text control.

In this version, you can only change the animation parameters used for an animated text (in a Static Text control).

Example

// Change animation parameters for an image field
IMG_Image1.Animation = True
AnimationSetParameter(IMG_Image1, acpDirectionAlternate, True)

// Change the animation parameters of a Static Text control
STC_MyStatic.Animation = True
AnimationSetMode(STC_MyStatic, actBlinking)
AnimationSetParameter(STC_MyStatic, acpDuration, 100)
AnimationSetParameter(STC_MyStatic, acpColor, DarkBlue)

Syntax

Changing the animation parameters of an image Hide the details

AnimationSetParameter(<Image control> , <Parameter to modify> , <Parameter value>)

<Image control>: Character string

Name of the Image control to be used.

<Parameter to modify>: Constant or character string

Name of parameter to modify.
acpDirection (or "Direction") Scroll direction.
"Scrolling" animation only.
These parameters can be combined.
1 (default): stretching from left to right
2: stretching from right to left
4: stretching from bottom to top
8: stretching from top to bottom
Example of combination:
3 (2+1): left right: gradual widening from the center
5 (4+1) from bottom to top and from right to left
This constant is not available.
acpDirectionAlternate (or "DirectionAlternate") Read the image drawings from the first drawing to the last one, then from the last drawing to the first one continuously (this parameter is set to False by default).
acpDuration (or "Duration") Amount of time for displaying each drawing of the animation in milliseconds (300 ms by default).
acpLoop (or "Loop") Read the image drawings from the first drawing to the last one continuously (this parameter is set to True by default).
acpNbImageX (or "NumberOfImagesX") Number of drawings found in the width of image file. Depending on the specified number, the image will be automatically divided into as many drawings as necessary (1 by default).
"Image to animate" animation only.
This constant is not available.
acpNbImageY (or "NumberOfImagesY") Number of drawings found in the height of image file. Depending on the specified number, the image will be automatically divided into as many drawings as necessary (1 by default).
"Image to animate" animation only.
This constant is not available.
acpNbStep (or "NumberOfSteps") 10 by default
"Scrolling" animation only.
This constant is not available.
acpReverse (or "Reverse") Read the image drawings from the last drawing (bottom right) to the first drawing (top left) (this parameter is set to False by default)

<Parameter value>: Type of expected parameter

New value for the parameter.

Changing the animation parameters of a static control Hide the details

AnimationSetParameter(<Static Text control> , <Parameter to modify> , <Parameter value>)

<Static Text control>: Character string

Name of the Static Text control to be used.

<Parameter to modify>: Constant or character string

Name of parameter to modify.
acpColor (or "Color") Blinking color. This parameter can correspond to a color constant. This color corresponds to Transparent by default.
"Blinking" animation only.
acpDirection (or "Direction") Scroll direction.
"Scrolling" animation only.
These parameters cannot be combined.
1 (default): dequeue to the left
2: Dequeue to the right
4: scroll down
8: scrolls upwards
acpDuration (or "Duration") Time for displaying each animation element in milliseconds (300 ms by default).
New in version 2025
acpLoop (or "Loop")
Dequeue continuously (this parameter is True by default).
"Scrolling" animation only.
Note: This feature is only available from version 2025 Update 1.
New in version 2025
acpNbLoopMax (or "NombreBoucleMax")
Number of loops for continuous dequeue (0 unlimited number of loops).
"Scrolling" animation only.
Note: This feature is only available from version 2025 Update 1.
acpNbPixel (or "NumberOfPixels") Number of pixels for each scrolling step.
"Scrolling" animation only.

<Parameter value>: Type of expected parameter

New value for the parameter.

Component: wd300obj.dll