COM Objects > TagsEditor object > Methods > TagsEditor.APE

Remarks

Sets contents of a specific text-based frame of the APE tag. Current contents can be retrieved through the TagsEditor.APE_TextFieldGet 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.APE_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.APE_TextFieldSet (

nField as enumTagFields,

strText as String

) as enumErrorCodes

[C++]

short control.TagsEditor.APE_TextFieldSet (

short nField,

BSTR strText

);

Parameter

Description

nField

Identifier of the tag field to set.

Supported values are the following:

Mnemonic Value	Value	Meaning
TAG_FIELD_TITLE	0	Title
TAG_FIELD_ARTIST	1	Artist
TAG_FIELD_ALBUM	2	Album
TAG_FIELD_YEAR	3	Year
TAG_FIELD_COMMENT	4	Comment
TAG_FIELD_TRACK	5	Track number
TAG_FIELD_GENRE_CODE	6	Genre code for ID3
TAG_FIELD_GENRE_STRING	7	Genre string
TAG_FIELD_COPYRIGHT	9	Copyright

User-defined frames can be added and retrieved through the TagsEditor.APE_UserFieldSet and TagsEditor.APE_UserFieldGet methods.

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.