Remarks
Sets contents of a specific text-based frame of the MP4 tag. Current contents can be retrieved through the TagsEditor.MP4_TextFrameGet 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.MP4_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
[C++]
short control.TagsEditor.MP4_TextFrameSet (
short nFrameId,
BSTR strText
);
|
|
Parameter
|
Description
|
|
|
nFrameId
|
Identifier of the specific frame to set.
Supported identifiers are the following:
Mnemonic Value
|
Value
|
Meaning
|
MP4_FRAME_ALBUM
|
0
|
Album (identifier ©alb)
|
MP4_FRAME_ARTIST
|
1
|
Artist (identifier ©ART)
|
MP4_FRAME_AUTHOR
|
2
|
Author (identifier ©aut)
|
MP4_FRAME_ALBUMARTIST
|
3
|
Album artist (identifier aART)
|
MP4_FRAME_BEATSPERMINUTE
|
4
|
Beats Per Minute (identifier tmpo)
|
MP4_FRAME_CATEGORY
|
5
|
Category (identifier catg)
|
MP4_FRAME_CDSETNUMBER
|
6
|
CD set number (identifier dsk)
|
MP4_FRAME_DISCNUMBER
|
7
|
Disk number (identifier disk)
|
MP4_FRAME_COMMENT
|
9
|
Comment (identifier ©cmt)
|
MP4_FRAME_COMPOSER
|
10
|
Composer (identifier ©wrt)
|
MP4_FRAME_COMPILATION
|
11
|
Compilation (identifier cpil)
|
MP4_FRAME_DAY
|
12
|
Day (identifier ©day)
|
MP4_FRAME_COPYRIGHT
|
13
|
Copyright (identifier ©cpy)
|
MP4_FRAME_CREATEDATE
|
14
|
Creation date (identifier ©day)
|
MP4_FRAME_DESCRIPTION
|
15
|
Description (identifier ©des)
|
MP4_FRAME_INFORMATION
|
16
|
Information (identifier ©inf)
|
MP4_FRAME_DIRECTOR
|
17
|
Director (identifier ©dir)
|
MP4_FRAME_DISCLAIMER
|
18
|
Disclaimer (identifier ©dis)
|
MP4_FRAME_ENCODER
|
19
|
Encoder (identifier ©too)
|
MP4_FRAME_GROUPING
|
20
|
Grouping (identifier ©grp)
|
MP4_FRAME_KEYWORD
|
21
|
Keyword (identifier keyw)
|
MP4_FRAME_LYRICS
|
22
|
Lyrics (identifier ©lyr)
|
MP4_FRAME_TITLE
|
23
|
Title (identifier ©nam)
|
MP4_FRAME_NETURL
|
24
|
Net URL (identifier ©url)
|
MP4_FRAME_ORIGINALARTIST
|
25
|
Original artist (identifier ©ope)
|
MP4_FRAME_ORIGINALFORMAT
|
26
|
Original format (identifier ©fmt)
|
MP4_FRAME_ORIGINALSOURCE
|
27
|
Original source (identifier ©src)
|
MP4_FRAME_PERFORMER
|
28
|
Performer (identifier ©prf)
|
MP4_FRAME_RATING
|
29
|
Rating (identifier rate)
|
MP4_FRAME_PRODUCER
|
30
|
Producer (identifier ©prd)
|
MP4_FRAME_WARNING
|
31
|
Warning (identifier ©wrn)
|
MP4_FRAME_GENRE
|
32
|
Genre
|
MP4_FRAME_TRACK
|
33
|
Track
|
|
strText
|
String of text to enter inside the given frame
|
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.
|
