COM Objects > TagsEditor object > Methods > TagsEditor.ID3V2

Remarks

Adds a new commercial frame (COMR) to the ID3V2 tag.

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.ID3V2_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.ID3V2_CommercialFrameAddWithFile (

strPicturePathname as String,

strPrice as String,

strValidUntil as String,

strContactUrl as String,

nReceivedAs as enumId3v2ReceivedAsType,

strSeller as String,

strDescription as String

) as enumErrorCodes

[C++]

short control.TagsEditor.ID3V2_CommercialFrameAddWithFile (

BSTR strPicturePathname,

BSTR strPrice,

BSTR strValidUntil,

BSTR strContactUrl,

short nReceivedAs,

BSTR strSeller,

BSTR strDescription

);

Parameter

Description

strPicturePathname

String containing the absolute pathname of the picture file to add to the commercial frame. The resulting picture usually represents the seller's logo.

strPrice

String containing the price field.

strValidUntil

String containing the "Valid until" field.

strContactUrl

String containing the "Contact URL" field.

nReceivedAs

Value representing the "Received as" field.

Supported values are the following:

Mnemonic value	Value	Meaning
ID3V2_COMMERCIAL_RECAS_Other	0	Other
ID3V2_COMMERCIAL_RECAS_Standard_CD	1	Standard CD album with other songs
ID3V2_COMMERCIAL_RECAS_Compressed	2	Compressed audio on CD
ID3V2_COMMERCIAL_RECAS_File_Internet	3	File over the Internet
ID3V2_COMMERCIAL_RECAS_Stream_Internet	4	Stream over the Internet
ID3V2_COMMERCIAL_RECAS_Note_sheets	5	As note sheets
ID3V2_COMMERCIAL_RECAS_Note_sheets_book	6	As note sheets in a book with other sheets
ID3V2_COMMERCIAL_RECAS_Music	7	Music on other media
ID3V2_COMMERCIAL_RECAS_Merchandise	8	Non-musical merchandise

strSeller

String containing the "Seller" field.

strDescription

String containing the "Description" 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.