OpenAnimation
property for PowerScript controls
Applies to
Window controls
Description
Specifies an optional animation effect that displays when the window
opens.
Usage
The OpenAnimation property takes a value of the WindowAnimationStyle
enumerated variable. For “slide” values, the whole window appears to slide
into view from the direction selected. For “roll” values, the window is
painted from the direction selected. Values are:
-
NoAnimation! (default) — The window displays with no
animation. -
TopSlide! — The window slides from the top to the bottom of its
extent. -
BottomSlide! — The window slides from the bottom to the top of
its extent. -
LeftSlide! — The window slides from the left to the right of
its extent. -
RightSlide! — The window slides from the right to the left of
its extent. -
TopRoll! — The window rolls from the top to the bottom of its
extent. -
BottomRoll! — The window rolls from the bottom to the top of
its extent. -
LeftRoll! — The window rolls from the left to the right of its
extent. -
RightRoll! — The window rolls from the right to the left of its
extent. -
FadeAnimation! — The window fades in.
-
CenterAnimation! — The window expands from the center.
You can modify the animation properties at any time and use them for
any window type. They are most often used in pop-up windows.
FadeAnimation! can be used only in top-level windows. It does not work in
child windows. In MDI applications, you cannot use FadeAnimation! for
sheet windows. Fading affects the transparency of the window, and sheet
windows in MDI applications always inherit the transparency of the frame
window.
Some controls, such as InkEdit, InkPicture, and RichTextEdit
controls, may not paint properly when you use animation features. For
example, if you place an InkPicture control on a window, the image in the
control does not display when the animation completes until the control is
clicked.
While the animation executes, the application waits for it to
complete. Use the AnimationTime property to control the number of
milliseconds the animation takes to execute.
The window’s Open event is triggered before the animation starts,
allowing any code that changes the size or layout of the window to
complete before it is painted.
In a painter
To set the OpenAnimation property on a window:
-
Select a value from the OpenAnimation drop-down list on the
General page of the window’s Properties view
In scripts
The following example sets the OpenAnimation property of the w_about
window to CenterAnimation!:
|
1 |
w_about.OpenAnimation = CenterAnimation! |
See also