ControlGrayed (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Animating a group of controls
Special cases

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ControlGrayed (Function)

In french: ChampGrisé

Grays a control or a group of controls. During this operation, an animation can be performed on the controls.

No animation can be played when the controls are grayed.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// Grays the GR_Name group of controls
ControlGrayed(GR_Name, animFadeIn, 200)

Syntax

ControlGrayed(<Control name> [, <Type of animation> [, <Animation duration>]])

<Control name>: Character string (with or without quotes)

Name of control or group of controls to gray.

<Type of animation>: Optional Integer constant

Type of animation to play:
animScrollBottom Scroll to the bottom.
animScrollRight Scroll to right.
animScrollLeft Scroll to left.
animScrollTop Scrolling to the top.
animFlipDownwardDiagonal Flip around the diagonal from the top left point to the bottom right point.
animFlipUpwardDiagonal Flip around the diagonal from the top right point to the bottom left point.
animFadeIn Fade-in animation.
animOverlap4Corner The image is displayed from the 4 corner while the previous status is overlapped.
animOverlapBottom Scrolling to the bottom while the previous status is overlapped.
animOverlapRight Scrolling to the right while the previous status is overlapped.
animOverlapLeft Scrolling to the left while the previous status is overlapped.
animOverlapTop Scrolling to the top while the previous status is overlapped.
animOverlapZoom New status appearing from the center with a zoom effect while the previous status is overlapped.
animShrinkThen4Corner The previous status is shrunk then the new status is appearing from the 4 corners.
This parameter is ignored. No animation can be played when the controls are grayed.

<Animation duration>: Optional integer or optional Duration

Duration of animation in hundredths of a second. This parameter can correspond to:
an integer corresponding to the number of hundredths of a second,
a Duration variable,
Versions 23 and later
the duration in clear ('1cs' or '10 ms' for example).
New in version 23
the duration in clear ('1cs' or '10 ms' for example).
the duration in clear ('1cs' or '10 ms' for example).
We recommend that you use a short duration (up to 1 second).
The application is locked as long as the animation is not over. If the user clicks or preses a key, the animation is stopped and the controls are displayed in their final status.
This parameter is ignored. No animation can be played when the controls are grayed.

Remarks

Animating a group of controls

If <Control Name> corresponds to a group of controls, the animation is played in the rectangle defined by the most top left control and by the most top right control.

The controls that do not belong to the group of controls but found in this area will also be animated.

Special cases

ControlGrayed has no effect if the control or the group of controls is grayed.
..State can also be used to gray the controls. This property cannot be used to play an animation during this operation. In Windows Mobile and Linux, ..State and ControlGrayed are equivalent.

Component : wd240obj.dll