New Members and Constants (PowerPoint)

New Members

The following properties, methods, and events have been added to existing objects in Microsoft PowerPoint 2010.

Application

Properties	Description
SmartArtColors	Returns the SmartArt colors of the current Application object. Read-only.
ActiveProtectedViewWindow	Returns a ProtectedViewWindow object that represents the active Protected View window (the window on top). Read-only.
ProtectedViewWindows	Returns a ProtectedViewWindows collection that represents all the Protected View windows that are open in the application. Read-only
HideChartDraftModeNotification	Indicates whether to show or hide charts in draft mode notifications. Read/write.
SmartArtQuickStyles	Returns the quick styles of the SmartArt diagram in the current Application object. Read-only.
IsSandboxed	Returns True if the specified presentation is open in a Protected View window. Read-only.
SmartArtLayouts	Returns the SmartArt layout of the current Application object. Read-only.
FileValidation	Returns or sets a value that indicates how PowerPoint will validate files before opening them. Read/write
FileConverters	Returns information about installed file converters. Returns null if there are no converters installed. Read-only Variant.
InsertChartInDraftMode	Inserts a Chart object in draft mode. Read/write.

Methods	Description
StartNewUndoEntry	Starts a new undo entry in the Application object.

Events	Description
ProtectedViewWindowBeforeEdit	Occurs immediately before editing is enabled on the document in the specified protected view window.
PresentationBeforeClose	Represents a Presentation object before it closes.
PresentationCloseFinal	Represents closing the final Presentation object.
ProtectedViewWindowBeforeClose	Occurs immediately before a protected view window or a document in a protected view window closes.
ProtectedViewWindowDeactivate	Occurs when a protected view window is deactivated.
ProtectedViewWindowOpen	Occurs when a protected view window is opened.
ProtectedViewWindowActivate	Occurs when any protected view window is activated.

ColorFormat

Properties	Description
Brightness	Returns or sets the brightness of the specified picture or OLE object. The value for this property must be a number from 0.0 (dimmest) to 1.0 (brightest). Read/write Single.

CommandEffect

Properties	Description
bookmark	Sets or returns the bookmark of the specified object. Read/write.

DocumentWindow

Methods	Description
ExpandSection	Expands the section in the current DocumentWindow.
IsSectionExpanded	Indicates whether the selected section is expanded in the DocumentWindow.

FillFormat

Properties	Description
GradientAngle	Returns or sets the angle of the gradient fill for the specified fill format. Read/write.
PictureEffects	Returns an object that represents the picture or texture fill for the specified fill format. Read-only.

Options

Properties	Description
ShowCoauthoringMergeChanges	Returns or sets the show changes mode. Read/write.

PictureFormat

Properties	Description
Crop	Returns or sets the number of points that are cropped off the specified picture or OLE object. Read-only.

Presentation

Properties	Description
SectionProperties	Returns a SectionProperties object. Read-only.
InMergeMode	Indicates whether the document window is in merge mode. Read-only
CreateVideoStatus	Returns the status of creating a video in the current Presentation. Read-only.
HasHandoutMaster	Indicates whether the presentation has media that resides on a handout master. Read-only
Broadcast	Returns the Broadcast object of the current Presentation object. Read-only.
HasNotesMaster	Indicates whether the presentation has media that resides on a notes master. Read-only.
Coauthoring	Returns a Coauthoring object in the current Presentation object. Read-only.

Methods	Description
MergeWithBaseline	Merges a presentation into another presentation.
DisableDraftModeAllCharts	Disables draft mode in all charts of the Presentation object.
Convert2	Converts a file to a different file type.
RejectAll	Rejects all changes.
EnableDraftModeAllCharts	Enables draft mode in all charts of the Presentation object.
AcceptAll	Accepts all changes.
CheckInWithVersion
EnsureAllMediaUpgraded	Ensures that all media is up to date in a Presentation object.
CreateVideo	Creates a video in a Presentation object.

Presentations

Methods	Description
Open2007	Opens the specified presentation and provides the option to repair the presentation file. Returns a Presentation object that represents the opened presentation.

PrintOptions

Properties	Description
sectionIndex	Returns the index of the selected section in the PrintOptions object. Read/write.
HighQuality	Indicates whether to print in high quality. Read/write.

Selection

Properties	Description
TextRange2	Returns the TextRange2 object of the current Selection object. Read-only.

Sequence

Methods	Description
AddTriggerEffect	Adds a trigger effect to the animation in a Sequence object.

Shape

Properties	Description
SmartArt	Returns the SmartArt diagram of the Shape object. Read-only.
MediaFormat	Allows access to the new audio or video object. Read-only.
Title	Returns a Shape object that represents the slide title. Read-only.
Chart	Returns a Chart object of the current Shape object. Read-only.
HasSmartArt	Returns True if the current Shape object contains a SmartArt diagram. Read-only.

Methods	Description
ConvertTextToSmartArt	Converts text in a Shape object to a SmartArt diagram.
PickupAnimation	Picks up all animation from the Shape object.
ApplyAnimation	Applies the last picked up animation to the Shape object.
UpgradeMedia	Converts a legacy media object to an updated media object.

ShapeRange

Properties	Description
MediaFormat	Returns the current MediaFormat object. Read-only.
Chart	Returns the Chart object of the current ShapeRange object. Read-only.
Title	Returns a Shape object that represents the slide title. Read-only.
SmartArt	Returns the SmartArt diagram of the ShapeRange object. Read-only.
HasSmartArt	Returns True if the current ShapeRange object has a SmartArt diagram. Read-only.

Methods	Description
UpgradeMedia	Upgrades media within the specified ShapeRange object.
PickupAnimation	Picks up all animation from the ShapeRange object.
ConvertTextToSmartArt	Returns the number of objects in the specified collection. Read-only.
ApplyAnimation	Applies animation to a ShapeRange object.

Shapes

Methods	Description
AddSmartArt	Adds a SmartArt diagram to the Shapes object.
AddMediaObject2	Adds a new media object.
AddMediaObjectFromEmbedTag	Adds a media object from an embedded tag to a Shapes object.

Slide

Properties	Description
HasNotesPage	Indicates whether the selected Slide has media that resides on a notes page. Read-only.
sectionIndex	Returns the index of the selected section in the Slide range. Read-only.

Methods	Description
MoveToSectionStart	Moves the current slide to the start of the specified section.

SlideRange

Properties	Description
HasNotesPage	Indicates whether the selected SlideRange has media that resides on a notes page. Read-only.
sectionIndex	Returns the index of the selected section in the SlideRange. Read-only.

Methods	Description
MoveToSectionStart	Moves the current position to the start of the specified section in the SlideRange object.

SlideShowSettings

Properties	Description
ShowMediaControls	Allows access to the media controls in the SlideShowSettings object. Read/write.
ShowPresenterView	Returns the presenter view of the SlideShowSettings object. Read/write.

SlideShowTransition

Properties	Description
Duration	Returns or sets the length of an animation in seconds. Read/write.

SlideShowView

Properties	Description
MediaControlsWidth	Returns the width, in points, of the media control bounding box. Read-only.
MediaControlsHeight	Returns the height of the media control bounding box. Read-only.
MediaControlsLeft	Returns the distance, in points, from the left edge of the media control bounding box to the left edge of the Slide. Read-only.
MediaControlsTop	Returns the distance, in points, from the top edge of the media control bounding box to the top edge of the Slide object. Read-only.
MediaControlsVisible	Indicates whether the media controls are visible. Read-only.

Methods	Description
Player	Allows access to playback controls for the associated view in the current window.

Table

Properties	Description
AlternativeText	Returns or sets the alternative text associated with a shape in a Web presentation. Read/write.
Title	Returns or sets the title of the Table object. Read/write.

TextFrame2

Properties	Description
NoTextRotation	Indicates whether to rotate text with the TextFrame2 rotation. One of the MsoTriState constants. Read/write.

Timing

Properties	Description
TriggerBookmark	Read/write
BounceEnd	Read/write
BounceEndIntensity	Read/write

View

Properties	Description
MediaControlsVisible	Indicates whether the media controls are currently visible. Read-only.
MediaControlsWidth	Returns the width, in points, of the media control bounding box. Read-only.
MediaControlsLeft	Returns the distance, in points, from the left edge of the media control bounding box to the left edge of the slide. Read-only.
MediaControlsTop	Returns the distance, in points, from the top edge of the media control bounding box to the top edge of the slide. Read-only.
MediaControlsHeight	Returns the height, in points, of the media controls. Read-only.

Methods	Description
Player	Allows access to playback controls for the associated view in the current window.

New Constants

The following constants have been added to existing enumerations in Microsoft PowerPoint 2010.

Enumeration	New Constants
MsoAnimEffect	msoAnimEffectMediaPlayFromBookmark
MsoAnimTriggerType	msoAnimTriggerOnMediaBookmark
PpEntryEffect	ppEffectBoxDown ppEffectBoxLeft ppEffectBoxRight ppEffectBoxUp ppEffectConveyorLeft ppEffectConveyorRight ppEffectCubeDown ppEffectCubeLeft ppEffectCubeRight ppEffectCubeUp ppEffectDoorsHorizontal ppEffectDoorsVertical ppEffectFerrisWheelLeft ppEffectFerrisWheelRight ppEffectFlashbulb ppEffectFlipDown ppEffectFlipLeft ppEffectFlipRight ppEffectFlipUp ppEffectFlyThroughIn ppEffectFlyThroughInBounce ppEffectFlyThroughOut ppEffectFlyThroughOutBounce ppEffectGalleryLeft ppEffectGalleryRight ppEffectGlitterDiamondDown ppEffectGlitterDiamondLeft ppEffectGlitterDiamondRight ppEffectGlitterDiamondUp ppEffectGlitterHexagonDown ppEffectGlitterHexagonLeft ppEffectGlitterHexagonRight ppEffectGlitterHexagonUp ppEffectHoneycomb ppEffectOrbitDown ppEffectOrbitLeft ppEffectOrbitRight ppEffectOrbitUp ppEffectPanDown ppEffectPanLeft ppEffectPanRight ppEffectPanUp ppEffectRevealBlackLeft ppEffectRevealBlackRight ppEffectRevealSmoothLeft ppEffectRevealSmoothRight ppEffectRippleCenter ppEffectRippleLeftDown ppEffectRippleLeftUp ppEffectRippleRightDown ppEffectRippleRightUp ppEffectRotateDown ppEffectRotateLeft ppEffectRotateRight ppEffectRotateUp ppEffectShredRectangleIn ppEffectShredRectangleOut ppEffectShredStripsIn ppEffectShredStripsOut ppEffectSwitchDown ppEffectSwitchLeft ppEffectSwitchRight ppEffectSwitchUp ppEffectVortexDown ppEffectVortexLeft ppEffectVortexRight ppEffectVortexUp ppEffectWarpIn ppEffectWarpOut ppEffectWheelReverse1Spoke ppEffectWindowHorizontal ppEffectWindowVertical
PpPrintRangeType	ppPrintSection
PpSaveAsFileType	ppSaveAsExternalConverter ppSaveAsOpenDocumentPresentation ppSaveAsOpenXMLPicturePresentation ppSaveAsWMV
PpSlideShowType	ppShowTypeWindow2

New Members

The following properties, methods, and events have been added to existing objects in Microsoft PowerPoint 2010.

Application

Properties	Description
SmartArtColors	Returns the SmartArt colors of the current Application object. Read-only.
ActiveProtectedViewWindow	Returns a ProtectedViewWindow object that represents the active Protected View window (the window on top). Read-only.
ProtectedViewWindows	Returns a ProtectedViewWindows collection that represents all the Protected View windows that are open in the application. Read-only
HideChartDraftModeNotification	Indicates whether to show or hide charts in draft mode notifications. Read/write.
SmartArtQuickStyles	Returns the quick styles of the SmartArt diagram in the current Application object. Read-only.
IsSandboxed	Returns True if the specified presentation is open in a Protected View window. Read-only.
SmartArtLayouts	Returns the SmartArt layout of the current Application object. Read-only.
FileValidation	Returns or sets a value that indicates how PowerPoint will validate files before opening them. Read/write
FileConverters	Returns information about installed file converters. Returns null if there are no converters installed. Read-only Variant.
InsertChartInDraftMode	Inserts a Chart object in draft mode. Read/write.

Methods	Description
StartNewUndoEntry	Starts a new undo entry in the Application object.

Events	Description
ProtectedViewWindowBeforeEdit	Occurs immediately before editing is enabled on the document in the specified protected view window.
PresentationBeforeClose	Represents a Presentation object before it closes.
PresentationCloseFinal	Represents closing the final Presentation object.
ProtectedViewWindowBeforeClose	Occurs immediately before a protected view window or a document in a protected view window closes.
ProtectedViewWindowDeactivate	Occurs when a protected view window is deactivated.
ProtectedViewWindowOpen	Occurs when a protected view window is opened.
ProtectedViewWindowActivate	Occurs when any protected view window is activated.

ColorFormat

Properties	Description
Brightness	Returns or sets the brightness of the specified picture or OLE object. The value for this property must be a number from 0.0 (dimmest) to 1.0 (brightest). Read/write Single.

CommandEffect

Properties	Description
bookmark	Sets or returns the bookmark of the specified object. Read/write.

DocumentWindow

Methods	Description
ExpandSection	Expands the section in the current DocumentWindow.
IsSectionExpanded	Indicates whether the selected section is expanded in the DocumentWindow.

FillFormat

Properties	Description
GradientAngle	Returns or sets the angle of the gradient fill for the specified fill format. Read/write.
PictureEffects	Returns an object that represents the picture or texture fill for the specified fill format. Read-only.

Options

Properties	Description
ShowCoauthoringMergeChanges	Returns or sets the show changes mode. Read/write.

PictureFormat

Properties	Description
Crop	Returns or sets the number of points that are cropped off the specified picture or OLE object. Read-only.

Presentation

Properties	Description
SectionProperties	Returns a SectionProperties object. Read-only.
InMergeMode	Indicates whether the document window is in merge mode. Read-only
CreateVideoStatus	Returns the status of creating a video in the current Presentation. Read-only.
HasHandoutMaster	Indicates whether the presentation has media that resides on a handout master. Read-only
Broadcast	Returns the Broadcast object of the current Presentation object. Read-only.
HasNotesMaster	Indicates whether the presentation has media that resides on a notes master. Read-only.
Coauthoring	Returns a Coauthoring object in the current Presentation object. Read-only.

Methods	Description
MergeWithBaseline	Merges a presentation into another presentation.
DisableDraftModeAllCharts	Disables draft mode in all charts of the Presentation object.
Convert2	Converts a file to a different file type.
RejectAll	Rejects all changes.
EnableDraftModeAllCharts	Enables draft mode in all charts of the Presentation object.
AcceptAll	Accepts all changes.
CheckInWithVersion
EnsureAllMediaUpgraded	Ensures that all media is up to date in a Presentation object.
CreateVideo	Creates a video in a Presentation object.

Presentations

Methods	Description
Open2007	Opens the specified presentation and provides the option to repair the presentation file. Returns a Presentation object that represents the opened presentation.

PrintOptions

Properties	Description
sectionIndex	Returns the index of the selected section in the PrintOptions object. Read/write.
HighQuality	Indicates whether to print in high quality. Read/write.

Selection

Properties	Description
TextRange2	Returns the TextRange2 object of the current Selection object. Read-only.

Sequence

Methods	Description
AddTriggerEffect	Adds a trigger effect to the animation in a Sequence object.

Shape

Properties	Description
SmartArt	Returns the SmartArt diagram of the Shape object. Read-only.
MediaFormat	Allows access to the new audio or video object. Read-only.
Title	Returns a Shape object that represents the slide title. Read-only.
Chart	Returns a Chart object of the current Shape object. Read-only.
HasSmartArt	Returns True if the current Shape object contains a SmartArt diagram. Read-only.

Methods	Description
ConvertTextToSmartArt	Converts text in a Shape object to a SmartArt diagram.
PickupAnimation	Picks up all animation from the Shape object.
ApplyAnimation	Applies the last picked up animation to the Shape object.
UpgradeMedia	Converts a legacy media object to an updated media object.

ShapeRange

Properties	Description
MediaFormat	Returns the current MediaFormat object. Read-only.
Chart	Returns the Chart object of the current ShapeRange object. Read-only.
Title	Returns a Shape object that represents the slide title. Read-only.
SmartArt	Returns the SmartArt diagram of the ShapeRange object. Read-only.
HasSmartArt	Returns True if the current ShapeRange object has a SmartArt diagram. Read-only.

Methods	Description
UpgradeMedia	Upgrades media within the specified ShapeRange object.
PickupAnimation	Picks up all animation from the ShapeRange object.
ConvertTextToSmartArt	Returns the number of objects in the specified collection. Read-only.
ApplyAnimation	Applies animation to a ShapeRange object.

Shapes

Methods	Description
AddSmartArt	Adds a SmartArt diagram to the Shapes object.
AddMediaObject2	Adds a new media object.
AddMediaObjectFromEmbedTag	Adds a media object from an embedded tag to a Shapes object.

Slide

Properties	Description
HasNotesPage	Indicates whether the selected Slide has media that resides on a notes page. Read-only.
sectionIndex	Returns the index of the selected section in the Slide range. Read-only.

Methods	Description
MoveToSectionStart	Moves the current slide to the start of the specified section.

SlideRange

Properties	Description
HasNotesPage	Indicates whether the selected SlideRange has media that resides on a notes page. Read-only.
sectionIndex	Returns the index of the selected section in the SlideRange. Read-only.

Methods	Description
MoveToSectionStart	Moves the current position to the start of the specified section in the SlideRange object.

SlideShowSettings

Properties	Description
ShowMediaControls	Allows access to the media controls in the SlideShowSettings object. Read/write.
ShowPresenterView	Returns the presenter view of the SlideShowSettings object. Read/write.

SlideShowTransition

Properties	Description
Duration	Returns or sets the length of an animation in seconds. Read/write.

SlideShowView

Properties	Description
MediaControlsWidth	Returns the width, in points, of the media control bounding box. Read-only.
MediaControlsHeight	Returns the height of the media control bounding box. Read-only.
MediaControlsLeft	Returns the distance, in points, from the left edge of the media control bounding box to the left edge of the Slide. Read-only.
MediaControlsTop	Returns the distance, in points, from the top edge of the media control bounding box to the top edge of the Slide object. Read-only.
MediaControlsVisible	Indicates whether the media controls are visible. Read-only.

Methods	Description
Player	Allows access to playback controls for the associated view in the current window.

Table

Properties	Description
AlternativeText	Returns or sets the alternative text associated with a shape in a Web presentation. Read/write.
Title	Returns or sets the title of the Table object. Read/write.

TextFrame2

Properties	Description
NoTextRotation	Indicates whether to rotate text with the TextFrame2 rotation. One of the MsoTriState constants. Read/write.

Timing

Properties	Description
TriggerBookmark	Read/write
BounceEnd	Read/write
BounceEndIntensity	Read/write

View

Properties	Description
MediaControlsVisible	Indicates whether the media controls are currently visible. Read-only.
MediaControlsWidth	Returns the width, in points, of the media control bounding box. Read-only.
MediaControlsLeft	Returns the distance, in points, from the left edge of the media control bounding box to the left edge of the slide. Read-only.
MediaControlsTop	Returns the distance, in points, from the top edge of the media control bounding box to the top edge of the slide. Read-only.
MediaControlsHeight	Returns the height, in points, of the media controls. Read-only.

Methods	Description
Player	Allows access to playback controls for the associated view in the current window.

New Constants

The following constants have been added to existing enumerations in Microsoft PowerPoint 2010.

Enumeration	New Constants
MsoAnimEffect	msoAnimEffectMediaPlayFromBookmark
MsoAnimTriggerType	msoAnimTriggerOnMediaBookmark
PpEntryEffect	ppEffectBoxDown ppEffectBoxLeft ppEffectBoxRight ppEffectBoxUp ppEffectConveyorLeft ppEffectConveyorRight ppEffectCubeDown ppEffectCubeLeft ppEffectCubeRight ppEffectCubeUp ppEffectDoorsHorizontal ppEffectDoorsVertical ppEffectFerrisWheelLeft ppEffectFerrisWheelRight ppEffectFlashbulb ppEffectFlipDown ppEffectFlipLeft ppEffectFlipRight ppEffectFlipUp ppEffectFlyThroughIn ppEffectFlyThroughInBounce ppEffectFlyThroughOut ppEffectFlyThroughOutBounce ppEffectGalleryLeft ppEffectGalleryRight ppEffectGlitterDiamondDown ppEffectGlitterDiamondLeft ppEffectGlitterDiamondRight ppEffectGlitterDiamondUp ppEffectGlitterHexagonDown ppEffectGlitterHexagonLeft ppEffectGlitterHexagonRight ppEffectGlitterHexagonUp ppEffectHoneycomb ppEffectOrbitDown ppEffectOrbitLeft ppEffectOrbitRight ppEffectOrbitUp ppEffectPanDown ppEffectPanLeft ppEffectPanRight ppEffectPanUp ppEffectRevealBlackLeft ppEffectRevealBlackRight ppEffectRevealSmoothLeft ppEffectRevealSmoothRight ppEffectRippleCenter ppEffectRippleLeftDown ppEffectRippleLeftUp ppEffectRippleRightDown ppEffectRippleRightUp ppEffectRotateDown ppEffectRotateLeft ppEffectRotateRight ppEffectRotateUp ppEffectShredRectangleIn ppEffectShredRectangleOut ppEffectShredStripsIn ppEffectShredStripsOut ppEffectSwitchDown ppEffectSwitchLeft ppEffectSwitchRight ppEffectSwitchUp ppEffectVortexDown ppEffectVortexLeft ppEffectVortexRight ppEffectVortexUp ppEffectWarpIn ppEffectWarpOut ppEffectWheelReverse1Spoke ppEffectWindowHorizontal ppEffectWindowVertical
PpPrintRangeType	ppPrintSection
PpSaveAsFileType	ppSaveAsExternalConverter ppSaveAsOpenDocumentPresentation ppSaveAsOpenXMLPicturePresentation ppSaveAsWMV
PpSlideShowType	ppShowTypeWindow2