SLIDE.PASTE

Macro Sheets Only

Equivalent to choosing the Paste button in a slide show document. Pastes the contents of the Clipboard as the next available slide of the active slide show document, and gives the slide the attributes you specify.

If this function is not available, you must install the Slide Show add-in macro.

Syntax

SLIDE.PASTE(effect_num, speed_num, advance_rate_num, soundfile_text)
SLIDE.PASTE?(effect_num, speed_num, advance_rate_num, soundfile_text)

Effect_num is a number specifying the transition effect you want to use when displaying the slide.

• The numbers correspond to the effects in the Effect list in the Edit Slide dialog box. The first effect in the list is 1 (None).
• If effect_num is omitted, the default setting is used.

Speed_num is a number from 1 to 10 specifying the speed of the transition effect.

• If speed_num is omitted, the default setting is used.
• If speed_num is greater than 10, Microsoft Excel uses the value 10 anyway.
• If effect_num is 1 (none), speed_num is ignored.

Advance_rate_num is a number specifying how long (in seconds) the slide is displayed before advancing to the next one.

• If advance_rate_num is omitted, the default setting is used.
• If advance_rate_num is 0, you must press a key or click with the mouse to advance to the next slide.

Soundfile_text is the name of a file enclosed in quotation marks and specifies sound that will be played when the slide is displayed.

• If soundfile_text is omitted, Microsoft Excel plays the default sound defined for the slide show document, if any.
• If soundfile_text is empty text (""), no sound is played.
• In Microsoft Excel for the Macintosh, soundfile_text also includes the number or name of the sound resource to play in the file.

Resource is the number or name of a sound resource in soundfile_text.

• This argument applies only to Microsoft Excel for the Macintosh.
• If resource is omitted, Microsoft Excel uses the first resource in the file.
• If the file does not contain a sound resource with the specified name or number, Microsoft Excel halts the macro and displays an error message.

Remarks

• SLIDE.PASTE returns TRUE if it successfully pastes the slide, or FALSE if you choose the Cancel button when using the dialog-box form. If the active document is not a slide show or is protected, SLIDE.PASTE returns the #N/A error value. If the Clipboard format is not compatible with the slide show document's format, SLIDE.PASTE returns the #VALUE error value.

Examples

In Microsoft Excel for Windows, the following macro formula pastes the contents of the Clipboard into the active slide show document. The slide's transition effect is fade, at a speed of 8; it is displayed for five seconds; and Microsoft Excel plays the specified sound file:

SLIDE.PASTE(3, 8, 5, "C:\SLIDES\SOUND\MACHINES.WAV")

In Microsoft Excel for the Macintosh, the formula is:

SLIDE.PASTE(3, 8, 5, "HARD DISK:SLIDES:SOUND:MACHINE SOUNDS")

Related Functions

List of Command-Equivalent Functions