find

Class: mlreportgen.ppt.Presentation
Package: mlreportgen.ppt

Search a presentation

Syntax

searchResults = find(presentation,objectName)

Description

searchResults = find(presentation,objectName) searches the specified presentation for the content or slide objects whose Name property value matches objectName.

Examples

expand all

Find Content in Presentation

Open Live Script

Import the PPT package so that you do not have to use long, fully qualified names for the PPT API classes.

import mlreportgen.ppt.*

Create a presentation. Add two slides that have titles.

ppt = Presentation('myPresentation.pptx');
open(ppt);
add(ppt,'Title Slide');
add(ppt,'Title and Content');

Find presentation objects whose Name property is Title.

contents = find(ppt,'Title')

contents=1×2 object
  1×2 TextBoxPlaceholder array with properties:

    Bold
    Font
    ComplexScriptFont
    FontColor
    FontSize
    Italic
    Strike
    Subscript
    Superscript
    Underline
    BackgroundColor
    VAlign
    Name
    X
    Y
    Width
    Height
    Style
    Children
    Parent
    Tag
    Id

The find method returns a 1-by-2 array of mlreportgen.ppt.TextBoxPlaceholder objects. The first object is for the title in the first slide and the second object is for the title in the second slide.

Replace the title in the first slide with My Presentation Title.

p = Paragraph('My Presentation Title');
replace(contents(1),p);

Close and view the presentation.

close(ppt);
rptview(ppt);

Here is the generated presentation:

Input Arguments

expand all

`presentation` — Presentation to search
`mlreportgen.ppt.Presentation` object

Presentation to search, specified as an mlreportgen.ppt.Presentation object.

`objectName` — Name property value to search for
character vector | string scalar

Name property value to search for, specified as a character vector or string scalar.

When you add a slide to a presentation, the add method sets the Name property of the content objects on the slide based on the slide layout. See getLayoutNames. The Name property values include: