LEADTOOLS Raster Imaging C++ Class Library Help > Classes and Member Functions > LFile > LFile Member Functions > LFile::GetFileName |
#include "ltwrappr.h"
L_TCHAR * LFile::GetFileName()
L_INT LFile::GetFileName(pBuffer, puBuffSize)
L_TCHAR * pBuffer; |
/* character string to be updated */ |
L_UINT * puBuffSize; |
/* size of pBuffer */ |
LFile::GetFileName() gets a pointer to the internal file name.
LFile::GetFileName(pBuffer, puBuffSize) gets a copy of the internal file name.
Parameter |
Description |
pBuffer |
Character string that will be updated with the internal file name. |
uBuffSize |
Pointer to a variable to be updated with the size of pBuffer. |
Returns
LFile::GetFileName returns a pointer to the internal file name. You should not attempt to free this pointer.
LFile::GetFileName(pBuffer, uBuffSize) returns the following:
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
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. |
Win32, x64.
See Also
Functions: |
Example
#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName L_INT LFile__GetFileNameExample(HWND hWnd) { L_INT nRet = 0; CString szMessage; L_UINT puFileNameLen ; L_TCHAR szOldFileName[255] ; L_TCHAR szNewFileName[255] ; LFile LeadFile; LBitmapBase LeadBitmap; LeadFile.SetBitmap(&LeadBitmap) ; LeadFile.SetFileName(MAKE_IMAGE_PATH(TEXT("image1.cmp"))) ; MessageBox(0,LeadFile.GetFileName() ,TEXT("file to load"),MB_OK); nRet = LeadFile.LoadFile (24, ORDER_RGB, LOADFILE_ALLOCATE | LOADFILE_STORE) ; if(nRet != SUCCESS) return nRet; nRet = LeadFile.GetFileName(szOldFileName,&puFileNameLen) ; if(nRet < 1) return nRet; LeadFile.SetFileName (MAKE_IMAGE_PATH(TEXT("TESTSTMP.CMP"))); // Save a CMP file nRet = LeadFile.Save(FILE_CMP); if (nRet == SUCCESS) { MessageBox (hWnd, TEXT("Function complete - Look at TESTSTMP.CMP"), TEXT("Notice"), MB_OK); nRet = LeadFile.GetFileName(szNewFileName,&puFileNameLen); if(nRet < 1) return nRet; szMessage.Format(L"Old File Name = %s\nBitmap compressed with stamp to\nNew File Name = %s", szOldFileName, szNewFileName); MessageBox(hWnd,szMessage,TEXT("Information"),MB_OK); } else return nRet; nRet = LeadBitmap.Free() ; if(nRet != SUCCESS) return nRet; return SUCCESS; }