Skip to content

Commit c2bda4e

Browse files
denis-gvardionovdenis-gvardionov
committed
EDITORNET-2972 - Write article about deleting slides for public docs
1 parent 810f75b commit c2bda4e

6 files changed

Lines changed: 159 additions & 6 deletions

File tree

‎net/developer-guide/edit-document/edit-excel/deleting-worksheets-from-spreadsheet.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,10 +30,10 @@ With the new worksheet removal feature the GroupDocs.Editor performs the next al
3030
2. If the value of the [`WorksheetNumber`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) property in the [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) instance is set to the default value `0`, the GroupDocs.Editor generates a new spreadsheet with one worksheet. The `WorksheetNumbersToDelete` property is ignored regardless of its value.
3131
3. If the value of the [`WorksheetNumber`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) property in the [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) instance has some non-zero value, the GroupDocs.Editor treats it as a command to insert the edited worksheet into the original spreadsheet.
3232
4. Depending on the [`InsertAsNewWorksheet`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/insertasnewworksheet/) property, the GroupDocs.Editor replaces old worksheet, specified by the value of the [`WorksheetNumber`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions/worksheetnumber) property, on the new one, taken from the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, or puts the new worksheet to be placed among existing worksheets without replacing any of them.
33-
5. Finally, when all worksheets insertions and rearrangements are finished, the GroupDocs.Editor reads the value of the `WorksheetNumbersToDelete` property, iterates over all numbers and removes specified worksheets from the spreadsheet.
33+
5. Finally, when all worksheet insertions and rearrangements are finished, the GroupDocs.Editor reads the value of the `WorksheetNumbersToDelete` property, iterates over all numbers and removes specified worksheets from the spreadsheet.
3434
6. The final spreadsheet, with updated and deleted worksheets, is written to the output stream or file.
3535

36-
Example below shows full roundtrip of input XLSX file: spreadsheet with 3 worksheets inside is loaded, its second worksheet is converted to the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), then HTML-markup is emitted from the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, edited, and then edited HTML-markup is converted back to the another [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance. From this point two instances of the [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) class are created — one is intended for generating a first version of an output spreadsheet with a new worksheet and without deletion and finally it has 4 worksheets in total (3 original + 1 edited). The second [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) instance has the WorksheetNumbersToDelete property set to remove the first and last worksheets, so the 2nd version of an output spreadsheet will have 2 worksheets in total (1 original + 1 edited).
36+
Example below shows full roundtrip of input XLSX file: spreadsheet with 3 worksheets inside is loaded, its second worksheet is converted to the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), then HTML-markup is emitted from the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, modified, and then edited HTML-markup is converted back to the another [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance. From this point two instances of the [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) class are created — one is intended for generating a first version of an output spreadsheet with a new worksheet and without deletion and finally it has 4 worksheets in total (3 original + 1 edited). The second [`SpreadsheetSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/spreadsheetsaveoptions) instance has the WorksheetNumbersToDelete property set to remove the first and last worksheets, so the 2nd version of an output spreadsheet will have 2 worksheets in total (1 original + 1 edited).
3737

3838
Input XLSX as well as two versions of the output XLSX files may be downloaded here:
3939

‎net/developer-guide/edit-document/edit-powerpoint/deleting-slides-from-presentation.md‎

Lines changed: 153 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,153 @@
1+
---
2+
id: deleting-slides-from-presentation
3+
url: editor/net/deleting-slides-from-presentation
4+
title: Deleting slides from presentation
5+
weight: 3
6+
description: "This article describes the new feature of the GroupDocs.Editor for .NET version 25.11 - deleting (removing) one or many slides from the loaded and edited presentation during its saving to the output format"
7+
keywords: Edit PowerPoint, delete slide from PowerPoint presentation, delete slide from PPT PPTX presentation, delete slide from presentation, remove slide from presentation
8+
productName: GroupDocs.Editor for .NET
9+
hideChildren: False
10+
toc: True
11+
---
12+
There are many [resentation](https://docs.fileformat.com/presentation/) document formats — PPT, PPTX, ODP and many more. They all have one common thing — the *slides*. Each presentation document has one or more slides, and these slides may be treated as containers of different content: text, geometric shapes, raster and vector images, animations, video, audio, comments, embedded objects and many more. The GroupDocs.Editor from its beginning had an ability to edit presentations, but only on a per-slide basis: a user can edit only the content of one slide at a time.
13+
14+
Initially, when the content of the slide was edited, it was only possible to save it as a new one-slide presentation. In particular, the pipeline was the next: user loads a presentation to the [`Editor`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor) class, selects the slide to edit with help of [`PresentationEditOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationeditoptions), obtains [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), edits the HTML-content of the slide, saves this content back to the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), and finally generates a new presentation file with one slide using the [`Editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method.
15+
16+
After release of the [version 20.4](https://releases.groupdocs.com/editor/net/release-notes/2020/groupdocs-editor-for-net-20-4-release-notes/), when the new SlideNumber
17+
property was introduced, this pipeline was expanded — it became possible to insert an edited slide into the original presentation using two ways:
18+
19+
1. by replacing the original slide, that was initially set for editing, onto its edited version,
20+
2. and by putting the edited slide to “co-exist” together with its original version before edit.
21+
22+
This mechanism is explained in detail in a [separate article](https://docs.groupdocs.com/editor/net/inserting-edited-slide-into-existing-presentation/).
23+
24+
Starting from the [version 25.11](https://releases.groupdocs.com/editor/net/release-notes/2025/groupdocs-editor-for-net-25-11-release-notes/), it is possible not only to edit and replace slides in the resultant presentation, but also delete them from it. The [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) class now contains one new property — a `int[] SlideNumbersToDelete`, which basically is an array of integers, where each integer represents a number of one slide that should be removed. Slide numbers here are 1-based, so the 1st slide has number `1`, not `0`.
25+
26+
With the new slides removal feature the GroupDocs.Editor performs the next algorithm during saving the presentation:
27+
28+
1. User edits a content of the slide in the WYSIWYG-editor, passes the edited content to the instance of the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) class [using one of its static methods](https://docs.groupdocs.com/editor/net/create-editabledocument-from-file-or-markup/), creates and adjusts the [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions), and passes the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) instance, and output stream or file path for writing to the [`Editor.Save()`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editor/save) method.
29+
2. If the value of the [`SlideNumber`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumber) property in the [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) instance is set to the default value `0`, the GroupDocs.Editor generates a new presentation with one slide inside it. The `SlideNumbersToDelete` property is ignored regardless of its value.
30+
3. If the value of the [`SlideNumber`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumber) property in the [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) instance has some non-zero value, the GroupDocs.Editor treats it as a command to insert the edited slide into the original presentation.
31+
4. Depending on the [`InsertAsNewSlide`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/insertasnewslide) property, the GroupDocs.Editor replaces old slide, specified by the value of the [`SlideNumber`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions/slidenumber) property, on the new one, taken from the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, or puts the new slide to be placed among existing slides without replacing any of them.
32+
5. Finally, when all slide insertions and rearrangements are finished, the GroupDocs.Editor reads the value of the `SlideNumbersToDelete` property, iterates over all numbers and removes specified slides from the presentation.
33+
6. The final presentation, with updated and deleted slides, is written to the output stream or file.
34+
35+
Example below shows full roundtrip of input PPT file: presentation with 21 slides inside is loaded, its second slide is converted to the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument), then HTML-markup is emitted from the [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance, modified, and then edited HTML-markup is converted back to the another [`EditableDocument`](https://reference.groupdocs.com/editor/net/groupdocs.editor/editabledocument) instance. From this point two instances of the [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) class are created — one is intended for generating a first version of an output presentation with a new slide and without deletion and finally it has 22 slides in total (21 original + 1 edited). The second [`PresentationSaveOptions`](https://reference.groupdocs.com/editor/net/groupdocs.editor.options/presentationsaveoptions) instance has the `SlideNumbersToDelete` property set to remove the first and last slides, so the 2nd version of an output presentation will have 20 slides in total (19 original + 1 edited).
36+
37+
Input PPT as well as two versions of the output PPTX files may be downloaded here:
38+
- [Presentations-Tips.ppt](/editor/net/sample-files/Presentations-Tips.ppt)
39+
- [Output22Slides-without-delete.pptx](/editor/net/sample-files/Output22Slides-without-delete.pptx)
40+
- [Output20Slides-with-delete.pptx](/editor/net/sample-files/Output22Slides-with-delete.pptx)
41+
42+
{{< tabs "DeleteSlidesFromLoadedAndEditedPresentations">}}
43+
{{< tab "C#" >}}
44+
```csharp
45+
using GroupDocs.Editor;
46+
using GroupDocs.Editor.Formats;
47+
using GroupDocs.Editor.Options;
48+
// ...
49+
50+
// Load input spreadsheet to the Editor and specify loading options
51+
using (Editor editor = new Editor("Input3Worksheets.xlsx", new SpreadsheetLoadOptions()))
52+
{
53+
// Prepare edit options and set 2nd worksheet to edit
54+
SpreadsheetEditOptions editOptions = new SpreadsheetEditOptions();
55+
editOptions.WorksheetIndex = 1;//2nd worksheet to edit, here WorksheetIndex is 0-based due to historical reasons
56+
57+
//generate EditableDocument with original content of 2nd worksheet
58+
using (EditableDocument worksheet2OpenedForEdit = editor.Edit(editOptions))
59+
{
60+
// Get the HTML-markup from the EditableDocument with original content
61+
string originalHtmlContentOf2ndWorksheet = worksheet2OpenedForEdit.GetEmbeddedHtml();
62+
63+
//emulate HTML content editing in WYSIWYG-editor in browser or somewhere else
64+
string editedHtmlContentOf2ndWorksheet = originalHtmlContentOf2ndWorksheet.Replace("2nd row", "Edited 2nd row at 1st column");
65+
66+
//generate EditableDocument with edited content of 2nd worksheet
67+
using (EditableDocument worksheet2AfterEdit = EditableDocument.FromMarkup(editedHtmlContentOf2ndWorksheet))
68+
{
69+
//prepare save options without deletions
70+
SpreadsheetSaveOptions saveOptionsWithoutDelete = new SpreadsheetSaveOptions(SpreadsheetFormats.Xlsx);
71+
// let it be the 2nd worksheet...
72+
saveOptionsWithoutDelete.WorksheetNumber = 2;//here WorksheetNumber is 1-based
73+
//... and we also save the original 2nd worksheet, which is pushed to the 3rd position
74+
saveOptionsWithoutDelete.InsertAsNewWorksheet = true;
75+
76+
// So now the spreadsheet must have 4 worksheets, not 3. Save it to file
77+
editor.Save(worksheet2AfterEdit, "Output4Worksheets-without-delete.xlsx", saveOptionsWithoutDelete);
78+
79+
// Create another save options, with deletions at this time
80+
SpreadsheetSaveOptions saveOptionsWithDelete = new SpreadsheetSaveOptions(SpreadsheetFormats.Xlsx);
81+
// let the new worksheet will be 2nd for now, but after deleting it will became the 1st later
82+
saveOptionsWithDelete.WorksheetNumber = 2;
83+
84+
//... and we also save the original 2nd worksheet, which will be next sibling to the newly inserted
85+
saveOptionsWithDelete.InsertAsNewWorksheet = true;
86+
87+
// delete the 1st and last worksheet
88+
saveOptionsWithDelete.WorksheetNumbersToDelete = new int[2]
89+
{
90+
1,//1st worksheet
91+
4//last worksheet is 4, not 3, because we inserted the edited 2nd worksheet as the new worksheet instance, without rewriting the original 2nd worksheet
92+
};
93+
// Save it again to distinct file. Output XLSX should have 2 worksheets now.
94+
editor.Save(worksheet2AfterEdit, "Output2Worksheets-with-delete.xlsx", saveOptionsWithDelete);
95+
}
96+
}
97+
}
98+
```
99+
{{< /tab >}}
100+
{{< tab "VB.NET">}}
101+
```vb
102+
Imports GroupDocs.Editor
103+
Imports GroupDocs.Editor.Formats
104+
Imports GroupDocs.Editor.Options
105+
' ...
106+
107+
' Load input spreadsheet to the Editor and specify loading options
108+
Using editor As New Editor("Input3Worksheets.xlsx", New SpreadsheetLoadOptions())
109+
' Prepare edit options and set 2nd worksheet to edit
110+
Dim editOptions As New SpreadsheetEditOptions()
111+
editOptions.WorksheetIndex = 1 '2nd worksheet to edit, here WorksheetIndex is 0-based due to historical reasons
112+
113+
' generate EditableDocument with original content of 2nd worksheet
114+
Using worksheet2OpenedForEdit As EditableDocument = editor.Edit(editOptions)
115+
' Get the HTML-markup from the EditableDocument with original content
116+
Dim originalHtmlContentOf2ndWorksheet As String = worksheet2OpenedForEdit.GetEmbeddedHtml()
117+
118+
' emulate HTML content editing in WYSIWYG-editor in browser or somewhere else
119+
Dim editedHtmlContentOf2ndWorksheet As String = originalHtmlContentOf2ndWorksheet.Replace("2nd row", "Edited 2nd row at 1st column")
120+
121+
' generate EditableDocument with edited content of 2nd worksheet
122+
Using worksheet2AfterEdit As EditableDocument = EditableDocument.FromMarkup(editedHtmlContentOf2ndWorksheet)
123+
' prepare save options without deletions
124+
Dim saveOptionsWithoutDelete As New SpreadsheetSaveOptions(SpreadsheetFormats.Xlsx)
125+
126+
' let it be the 2nd worksheet...
127+
saveOptionsWithoutDelete.WorksheetNumber = 2 'here WorksheetNumber is 1-based
128+
'... and we also save the original 2nd worksheet, which is pushed to the 3rd position
129+
saveOptionsWithoutDelete.InsertAsNewWorksheet = True
130+
131+
' So now the spreadsheet must have 4 worksheets, not 3. Save it to file
132+
editor.Save(worksheet2AfterEdit, "Output4Worksheets-without-delete.xlsx", saveOptionsWithoutDelete)
133+
134+
' Create another save options, with deletions at this time
135+
Dim saveOptionsWithDelete As New SpreadsheetSaveOptions(SpreadsheetFormats.Xlsx)
136+
' let the new worksheet will be 2nd for now, but after deleting it will became the 1st later
137+
saveOptionsWithDelete.WorksheetNumber = 2
138+
'... and we also save the original 2nd worksheet, which will be next sibling to the newly inserted
139+
saveOptionsWithDelete.InsertAsNewWorksheet = True
140+
141+
' delete the 1st and last worksheet
142+
saveOptionsWithDelete.WorksheetNumbersToDelete = New Int32(1) {
143+
1, '1st worksheet
144+
4 'last worksheet is 4, not 3, because we inserted the edited 2nd worksheet as the new worksheet instance, without rewriting the original 2nd worksheet
145+
}
146+
' Save it again to distinct file. Output XLSX should have 2 worksheets now.
147+
editor.Save(worksheet2AfterEdit, "Output2Worksheets-with-delete.xlsx", saveOptionsWithDelete)
148+
End Using
149+
End Using
150+
End Using
151+
```
152+
{{< /tab >}}
153+
{{< /tabs >}}

0 commit comments

Comments
 (0)