Get the size of the comments with LFile::GetCommentSizeLFile::ReadCommentExt
#include "ltwrappr.h"
virtual L_INT LFile::ReadCommentExt(uType, pComments, pBuffer, puLength, pLoadFileOption=NULL)
|
L_UINT uType; |
/* type of comment*/ |
|
LPFILECOMMENTS pComments; |
/* pointer to a structure */ |
|
/* pointer to a buffer */ | |
|
/* pointer to a variable to be updated */ | |
|
pLOADFILEOPTIONpLoadFileOption; |
/* pointer to optional extended load options */ |
Gets a single comment, a group of comments or several groups of comments from a file.
|
Parameter |
Description |
|
uType |
The type of comment. Refer to Types of File Comments. A group of comments may be obtained such as CMNT_FPXSUMMARYINFORMATION, or more than one group of comments may be retrieved by using OR as in CMNT_FPXSUMMARYINFORMATION | CMNT_FPXFILESOURCEGROUP, or all comments may be obtained by using CMNT_ALL. See Example listed below. For more information concerning FlashPix file comments, see FlashPix File Comments. |
|
pComments |
Pointer to a structure which contains a data value indicating the number of comments stored, a pointer to an array of pointers which in turn point to the individual Comments, and a pointer to an array of integers which indicate the size of each Comment stored. |
|
pBuffer |
Pointer to the buffer object that will hold all the comments. |
|
puLength |
Pointer to a variable to be updated with the size of the buffer that will hold all the comments. |
|
pLoadFileOption |
Pointer to optional extended load options. Pass NULL to use the default load options. |
Returns
|
SUCCESS |
The function was successful. |
|
< 1 |
An error occurred. Refer to Return Codes. |
Comments
Presently this function only works with FlashPix format files.
The basic order of function calls to retrieve comments is as follows:
Get the size of the comments with LFile::GetCommentSize
Allocate a buffer of a corresponding size.
Read the comments with LFile::ReadComment
Free the buffer
To write comments to a file, all the comments you wish to add to a new file must be set. LFileSettings::SetComment sets each comment individually, but it does not save the comments to the file, it prepares the values for the next save.. Once all comments are set, the comments are saved using any function which saves files, such as LFile::SaveFile or LFile::SaveBitmap when creating a new file. If you wish to change a comment in an existing file, use LFile::WriteComment.
Required DLLs and Libraries
|
LTFIL For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
See Also
|
Functions: |
|
|
Topics: |
|
|
|
Example
L_UINT uLength;
L_TCHAR szMessage[80];
L_CHAR L_FAR *pTextToGet;
L_UINT32 L_FAR *pLong;
L_CHAR L_FAR *pString;
FPXCOMMENT_HEADER_ARRAY L_FAR *pArray;
FPXCOMMENT_HEADER_ELEMENT L_FAR *pElement;
FILECOMMENTS FileComments;
L_UCHAR L_FAR *pPointer [CMNT_LAST + 1];
L_UINT uSize[CMNT_LAST + 1];
/*Read one group of comments:*/
L_INT nStatus;
LFile file;
LBuffer Buff;
/* Determine the size, in bytes, of the desired group of comments. */
file.SetFileName(TEXT("TEST.FPX"));
nStatus = file.GetCommentSize(CMNT_FPXSUMMARYINFORMATION, &uLength);
/* Allocate a buffer based on the size of the comments obtained by LFile::GetCommentSize and stored in uLength. */
Buff.Reallocate(uLength);
pTextToGet = (L_CHAR L_FAR *)Buff.Lock();
/* Initialize the FileComments structure. */
FileComments.count = CMNT_LAST + 1;
FileComments.pointer = pPointer;
FileComments.size = uSize;
/* Read the group of comments into the buffer. */
nStatus = file.ReadCommentExt(CMNT_FPXSUMMARYINFORMATION,&FileComments,(L_UCHAR L_FAR*) pTextToGet, &uLength);
/* Extract the desired individual comments from within the group */
pArray = (FPXCOMMENT_HEADER_ARRAY L_FAR *)pPointer [CMNT_FPXTITLE];
pElement = (FPXCOMMENT_HEADER_ELEMENT L_FAR *) pPointer [CMNT_FPXSECURITY];
/* Test to be sure the comments exist. If they exist, print them.*/
if((pArray != NULL)&&(pElement != NULL))
{
pString = (L_CHAR*)(pArray + 1);
pLong = (L_UINT32 L_FAR *)(pElement + 1);
wsprintf(szMessage, TEXT("%hs-%ul"), pString, *pLong);
MessageBox(NULL, szMessage, TEXT("Title & Security"), MB_OK);
}