[Slide.MoveTo:]
Moves the current slide to a new position within a PowerPoint document.
Purpose
Moves the current slide to a new position within a PowerPoint document (or PowerPoint slide section), based on an index.
Macro Compatibility
The macro can be used in the highlighted input document types only. A greyed-out icon indicates not supported.
Usage
When using PowerPoint slide sections (see: PowerPoint sections), moved slides will be placed into the correct section, or the one specified. Empty sections that remain are NOT deleted by default.For more information on using macros in PowerPoint, see: PowerPoint help.
Parameter | Type | Presence | Purpose | Options | Default |
---|---|---|---|---|---|
Int32 | Mandatory | The index (0-based) of the slide's new position. |
|
N/A | |
String | Optional | Add a comment to make your document template more readable. The comment is discarded in the output document. | N/A | N/A | |
Boolean | Optional | Once the slide has been moved, whether to delete empty slide sections. |
|
false | |
Boolean | Optional | Should NCalc expression evaluation throw error on Overflow |
|
true | |
String | Optional | The text to display should the macro fail to execute. Note that a poorly-specified macro (e.g. omitting mandatory parameters) will still result in an error message. | N/A | N/A | |
String | Optional | The condition that must be true in order for the macro to be executed/evaluated. Must either evaluate to true or false, for example: "3+5=8" or "contains('abcd', 'z'). | N/A | true | |
Slide.IndexType | Optional | Whether to move the slide relative to the start or the end of the presentation (or slide section, when the 'sectionName' parameter is used). To move a slide to the start of the presentation: 'index=0, indexType=FromStart'. To move a slide to the end of the presentation: 'index=0, indexType=FromEnd'. |
|
FromStart | |
MacroMode | Optional | The mode in which variables are stored. In the legacy mode (default for Schedules), the variable created is a string and formatted. In the normal mode (default for Report Studio), the output variable is stored as a strongly-typed object, e.g. an Int32 or a List |
|
Legacy | |
ObfuscationType | Optional | Obfuscation type. Use obfuscation to write reports where sensitive data is hidden. When used, ReportMagic guarantees that the same input string will map to the same output string for the whole of the report (but the next time the report runs, it will most likely map to a different value). If you use obfuscation, the property in your macro will not show up and instead, you will see a fake item of the obfuscation type chosen. |
|
None | |
String | Optional | The section name to move the slide into. The 'index' and 'indexType' parameters then relate to the section. More details on PowerPoint sections can be found here. | N/A | N/A | |
String | Optional | If specified, adds a warning message for this macro. This is processed as an NCalc, and the warning message will ALWAYS be present and will be the value of the evaluated NCalc expression. | N/A | N/A |
Examples (3)
Example 1:
Moves the current slide to the start of the presentation:
[Slide.MoveTo: index=0]
Example 2:
Moves the current slide to the end of the presentation:
[Slide.MoveTo: index=0, indexType=FromEnd]
Example 3:
Moves the current slide to the start of the slide section called 'My Section' (which can be anywhere in the presentation):
[Slide.MoveTo: index=0, sectionName=My Section]