Add()

GlobalLayoutSlideCollection::Add(System::SharedPtr<IMasterSlide>, SlideLayoutType, System::String) method

Adds a new layout slide to the presentation.

System::SharedPtr<ILayoutSlide> Aspose::Slides::GlobalLayoutSlideCollection::Add(System::SharedPtr<IMasterSlide> master, SlideLayoutType layoutType, System::String layoutName) override

Arguments

ParameterTypeDescription
masterSystem::SharedPtr<IMasterSlide>Master slide for a new layout.
layoutTypeSlideLayoutTypeLayout type for a new layout. Supported layout types: Title, TitleOnly, Blank, TitleAndObject, VerticalText, VerticalTitleAndText, TwoObjects, SectionHeader, TwoTextAndTwoObjects, TitleObjectAndCaption, PictureAndCaption, Custom. Other layout types are not supported now: Text, TwoColumnText, Table, TextAndChart, ChartAndText, Diagram, Chart, TextAndClipArt, ClipArtAndText, TextAndObject, ObjectAndText, Object, TextAndMedia, MediaAndText, ObjectOverText, TextOverObject, TextAndTwoObjects, TwoObjectsAndText, TwoObjectsOverText, FourObjects, ClipArtAndVerticalText, VerticalTitleAndTextOverChart, ObjectAndTwoObject, TwoObjectsAndObject.
layoutNameSystem::StringName for a new layout. If passed name is already in use the ArgumentException will be thrown. If null parameter is passed then name genarated atomatically in regards to passed layout type (for example “Title Slide” or “1_Title Slide”, “2_..”, etc.).

Return Value

Added slide.

Exceptions

ExceptionDescription
System::NotImplementedExceptionThrown if unsupported value of parameter layoutType is passed. Layout types that are not supported now: Text, TwoColumnText, Table, TextAndChart, ChartAndText, Diagram, Chart, TextAndClipArt, ClipArtAndText, TextAndObject, ObjectAndText, Object, TextAndMedia, MediaAndText, ObjectOverText, TextOverObject, TextAndTwoObjects, TwoObjectsAndText, TwoObjectsOverText, FourObjects, ClipArtAndVerticalText, VerticalTitleAndTextOverChart, ObjectAndTwoObject, TwoObjectsAndObject.
System::ArgumentNullExceptionThrown if master is null.
System::ArgumentExceptionThrown if master belongs to the other presentation.
System::ArgumentExceptionThrown if layout name value layoutName is already in use in collection of the layouts of master .

Remarks

  1. Added layout for value SlideLayoutType::Custom of layoutType contains no placeholders and no shapes. 2) Analogue of this method is method IMasterLayoutSlideCollection::Add(SlideLayoutType, String) accessed with IMasterSlide::get_LayoutSlides() property.

See Also