WaveAudioFile Class

Audio from WAV File.When the object is serialized out as xml, its qualified name is a:wavAudioFile.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Drawing.EmbeddedWavAudioFileType
        DocumentFormat.OpenXml.Drawing.WaveAudioFile

Namespace:  DocumentFormat.OpenXml.Drawing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
Public Class WaveAudioFile _
    Inherits EmbeddedWavAudioFileType
'Usage
Dim instance As WaveAudioFile
public class WaveAudioFile : EmbeddedWavAudioFileType

Remarks

[ISO/IEC 29500-1 1st Edition]

20.1.3.7 wavAudioFile (Audio from WAV File)

This element specifies the existence of an audio WAV file. This element is specified within the non-visual properties of an object. The audio shall be attached to an object as this is how it is represented within the document. The actual playing of the audio however is done within the timing node list that is specified under the timing element.

[Example: Consider the following picture object that has an audio WAV file attached to it.

<p:pic>
<p:nvPicPr>
<p:cNvPr id="7" name="Rectangle 6">
<a:hlinkClick r:id="" action="ppaction://media"/>
</p:cNvPr>
    <p:cNvPicPr>
<a:picLocks noRot="1"/>
</p:cNvPicPr>
    <p:nvPr>
<a:wavAudioFile r:embed="rId2"/>
</p:nvPr>
</p:nvPicPr>
…
</p:pic>

In the above example, we see that there is a single wavAudioFile element attached to this picture. This picture is placed within the document just as a normal picture or shape would be. The id of this picture, namely 7 in this case, is used to refer to this wavAudioFile element from within the timing node list. The Embedded relationship id is used to retrieve the actual audio file for playback purposes. end example]

[Note: This element is generally used for the purposes of embedding audio files within the document. For linking to generic audio files the audioFile element should be used. end note]

Parent Elements

nvPr (§19.3.1.33)

Attributes

Description

embed (Embedded Audio File Relationship ID)

Namespace: .../officeDocument/2006/relationships

Specifies the identification information for an embedded audio file. This attribute is used to specify the location of an object that resides locally within the file. [Note: A list of suggested audio types is provided in §15.2.2. end note]

The possible values for this attribute are defined by the ST_RelationshipId simple type (§22.8.2.1).

name (Sound Name)

Specifies the original name or given short name for the corresponding sound. This is used to distinguish this sound from others by providing a human readable name for the attached sound should the user need to identify the sound among others within the UI.

The possible values for this attribute are defined by the W3C XML Schema string datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_EmbeddedWAVAudioFile) is located in §A.4.1. end note]

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

WaveAudioFile Members

DocumentFormat.OpenXml.Drawing Namespace