TagsEditor.ID3V2_PictureFrameBitmapGet method |
|
Remarks
Obtains the memory bitmap (HBITMAP) representation of the picture stored inside an ID3V2 picture frame (APIC).
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_PictureFrameBitmapGet ( nIndex as Integer, hBitmap as OLE_HANDLE, nOriginalWidth as Long, nOriginalHeight as Long, nResizeWidth as Long, nResizeHeight as Long ) as enumErrorCodes |
[C++] short control.TagsEditor.ID3V2_PictureFrameBitmapGet ( short nIndex, OLE_HANDLE *hBitmap, long *nOriginalWidth, long *nOriginalHeight, long nResizeWidth, long nResizeHeight ); |
Parameter |
Description |
|
|
nIndex |
Zero-based index of the picture frame. The total number of picture frames available inside the ID3V2 tag can be obtained through a call to the TagsEditor.ID3V2_FrameCountGet method with the strFrameId parameter set to "APIC". |
hBitmap |
Reference that, on return from the method call, will contain the HBITMAP of the picture. |
nOriginalWidth |
Reference that, on return from the method call, will contain the original width, expressed in pixels, of the picture. |
nOriginalHeight |
Reference that, on return from the method call, will contain the original height, expressed in pixels, of the picture. |
nResizeWidth |
Value containing the width, expressed in pixels, for horizontally resizing the picture before returning the HBITMAP; this parameter is ignored if set to 0 in which case the picture represented by the HBITMAP handle will have the same width returned inside the nOriginalWidth parameter. |
nResizeHeight |
Value containing the height, expressed in pixels, for vertically resizing the picture before returning the HBITMAP; this parameter is ignored if set to 0 in which case the picture represented by the HBITMAP handle will have the same height returned inside the nOriginalHeight parameter. |
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. |