Add

GlobalLayoutSlideCollection.Add-Methode

Fügt eine neue Layoutfolie zur Präsentation hinzu.

public ILayoutSlide Add(IMasterSlide master, SlideLayoutType layoutType, string layoutName)
ParameterTypBeschreibung
masterIMasterSlideMasterfolie für ein neues Layout.
layoutTypeSlideLayoutTypeLayouttyp für ein neues Layout. Unterstützte Layouttypen: Title, TitleOnly, Blank, TitleAndObject, VerticalText, VerticalTitleAndText, TwoObjects, SectionHeader, TwoTextAndTwoObjects, TitleObjectAndCaption, PictureAndCaption, Custom. Andere Layouttypen werden derzeit nicht unterstützt: Text, TwoColumnText, Table, TextAndChart, ChartAndText, Diagram, Chart, TextAndClipArt, ClipArtAndText, TextAndObject, ObjectAndText, Object, TextAndMedia, MediaAndText, ObjectOverText, TextOverObject, TextAndTwoObjects, TwoObjectsAndText, TwoObjectsOverText, FourObjects, ClipArtAndVerticalText, VerticalTitleAndTextOverChart, ObjectAndTwoObject, TwoObjectsAndObject.
layoutNameStringName für ein neues Layout. Wenn der übergebene Name bereits verwendet wird, wird eine ArgumentException ausgelöst. Wenn ein null-Parameter übergeben wird, wird der Name automatisch in Bezug auf den übergebenen Layouttyp generiert (zum Beispiel “Title Slide” oder “1_Title Slide”, “2_..”, usw.).

Rückgabewert

Hinzugefügte Folie.

Ausnahmen

AusnahmeBedingung
NotImplementedExceptionWird ausgelöst, wenn ein nicht unterstützter Wert des Parameters layoutType übergeben wird. Nicht unterstützte Layouttypen sind derzeit: Text, TwoColumnText, Table, TextAndChart, ChartAndText, Diagram, Chart, TextAndClipArt, ClipArtAndText, TextAndObject, ObjectAndText, Object, TextAndMedia, MediaAndText, ObjectOverText, TextOverObject, TextAndTwoObjects, TwoObjectsAndText, TwoObjectsOverText, FourObjects, ClipArtAndVerticalText, VerticalTitleAndTextOverChart, ObjectAndTwoObject, TwoObjectsAndObject.
ArgumentNullExceptionWird ausgelöst, wenn master null ist.
ArgumentExceptionWird ausgelöst, wenn master zu einer anderen Präsentation gehört.
ArgumentExceptionWird ausgelöst, wenn der Wert des Layoutnamens layoutName bereits in der Sammlung der Layouts von master verwendet wird.

Hinweise

  1. Das hinzugefügte Layout für den Wert SlideLayoutType.Custom von layoutType enthält keine Platzhalter und keine Formen. 2) Das Äquivalent dieser Methode ist die Methode Add, die über die Eigenschaft LayoutSlides aufgerufen wird.

Siehe auch