COM Objects > TagsEditor object > Methods > TagsEditor.WAV

Remarks

Sets contents of a specific text-based field of the BEXT chunk. Current contents can be retrieved through the TagsEditor.WAV_BextChunkTextFieldGet method.

The modification only happens in memory and not directly into the original sound file: in order to store modifications inside the file you need to call the TagsEditor.WAV_SaveChanges method.

For further details about methods related to tags editing refer to the TagsEditor object.

For details about the editing of tags see the How to edit tag info in sound files tutorial.

Syntax

[Visual Basic]

control.TagsEditor.WAV_BextChunkTextFieldSet (

nFieldId as enumBextChunkField,

strText as String

) as enumErrorCodes

[C++]

short control.TagsEditor.WAV_BextChunkTextFieldSet (

short nFieldId,

BSTR strText

);

Parameter

Description

nFieldId

Identifier of the field to set.

Supported values are the following:

Mnemonic Value	Value	Meaning
WAV_BEXT_CHUNK_Description	0	Description of the sound sequence
WAV_BEXT_CHUNK_Originator	1	Name of the originator
WAV_BEXT_CHUNK_OriginatorReference	2	Reference of the originator
WAV_BEXT_CHUNK_OriginationDate	3	Originator date yyyy-mm-dd
WAV_BEXT_CHUNK_OriginationTime	4	Originator time hh-mm-ss
WAV_BEXT_CHUNK_TimeReference_Low	5	First sample count since midnight: lower 32 bits
WAV_BEXT_CHUNK_TimeReference_High	6	First sample count since midnight: higher 32 bits
WAV_BEXT_CHUNK_TimeReference_Full	7	First sample count since midnight: 64 bits number
WAV_BEXT_CHUNK_TimeReference_Formatted	8	Formatted time since midnight
WAV_BEXT_CHUNK_Version	9	Version of the BWF; unsigned binary number (Read only)
WAV_BEXT_CHUNK_CodHistory	10	Coding history

strText

String of text to enter inside the given field

Return value

Value	Meaning

Negative value	An error occurred (see the LastError property for further error details)
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.