Partager via


EffectInformation.AnimateBackground Property (PowerPoint)

Returns msoTrue if the specified effect is a background animation. Read-only.

Syntax

expression .AnimateBackground

expression A variable that represents an EffectInformation object.

Remarks

Use the TextLevelEffect and TextUnitEffect properties to control the animation of text attached to the specified shape.

If this property is set to msoTrue and the TextLevelEffect property is set to ppAnimateByAllLevels, the shape and its text are animated simultaneously. If this property is set to msoTrue and the TextLevelEffect property is set to anything other than ppAnimateByAllLevels, the shape is animated immediately before the text is animated.

You won't see effects of setting this property unless the specified shape is animated. For a shape to be animated, the TextLevelEffect property for the shape must be set to something other than ppAnimateLevelNone, and either the Animate property must be set to msoTrue, or the EntryEffect property must be set to a constant other than ppEffectNone.

The value returned by the AnimateBackground property can be one of these MsoTriState constants.

Constant

Description

msoFalse

The specified effect is not a background animation.

msoTrue

The specified effect is a background animation.

Example

This example changes the direction of the animation if the background is currently animated.

Sub ChangeAnimationDirection()

    With ActivePresentation.Slides(1).TimeLine.MainSequence(1)

        If .EffectInformation.AnimateBackground = msoTrue Then

            .EffectParameters.Direction = msoAnimDirectionTopLeft

        End If

    End With

End Sub

See Also

Concepts

EffectInformation Object

EffectInformation Object Members