Add()
Contents
[
Hide
]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
| Parameter | Type | Description |
|---|---|---|
| master | System::SharedPtr<IMasterSlide> | Master slide for a new layout. |
| layoutType | SlideLayoutType | Layout 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. |
| layoutName | System::String | Name 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
| Exception | Description |
|---|---|
| System::NotImplementedException | Thrown 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::ArgumentNullException | Thrown if master is null. |
| System::ArgumentException | Thrown if master belongs to the other presentation. |
| System::ArgumentException | Thrown if layout name value layoutName is already in use in collection of the layouts of master . |
Remarks
- 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
- Enum SlideLayoutType
- Typedef SharedPtr
- Class ILayoutSlide
- Class IMasterSlide
- Class String
- Class GlobalLayoutSlideCollection
- Namespace Aspose::Slides
- Library Aspose.Slides