OpenAnimation

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!:

w_about.OpenAnimation = CenterAnimation!

See also

AnimationTime

CloseAnimation