PictureEffects.Insert method (Office)

Inserts a picture effect in a chain of composite effects.

Syntax

expression.Insert(EffectType, Position)

expression An expression that returns a PictureEffects object.

Parameters

Name Required/Optional Data type Description
EffectType Required MsoPictureEffectType An enumeration specifying the type of picture effect.
Position Optional Integer The position of the effect in the composite chain of picture effects.

Return value

PictureEffect

Remarks

Picture effects are processed as a chain composed of individual items that are applied in sequence to create the final composited image. An effects chain will allow an effect to be added to the chain, reordered, or removed from the chain.

Example

The following code sets several PictureEffect fill properties on a shape in a Microsoft PowerPoint slide.

Sub PictureEffectSample() 
' Setup a slide with one picture shape. 
With ActivePresentation.Slides(1).Shapes(1).Fill.PictureEffects 
 
 ' Insert a 150% Saturation effect. 
 .Insert(msoEffectSaturation).EffectParameters(1).Value = 1.5 
 
 ' Insert Brightness/Contrast effect and set values to -50% Brightness and +25% Contrast. 
 Dim brightnessContrast As PictureEffect 
 Set brightnessContrast = .Insert(msoEffectBrightnessContrast) 
 brightnessContrast.EffectParameters(1).Value = -0.5 
 brightnessContrast.EffectParameters(2).Value = 0.25 
 
 ' Remove all Picture effects. 
 While .Count > 0 
 .Delete (1) 
 Wend 
 
End With 
End Sub

See also

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.