New Members and Constants (PowerPoint)

  • Article

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