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.