LTwain::TemplateDlg

#include "ltwrappr.h"

virtual L_INT LTwain::TemplateDlg (lpszTemplateFile)

L_TCHAR * lpszTemplateFile;

/* pointer to a character string */

Displays the TWAIN source manufacturer's template dialog, without actually acquiring an image.

Parameter	Description
lpszTemplateFile	A character string that contains the name of the template file used in the saving the capability values.

Returns

SUCCESS	The function was successful.
<1	An error occurred. Refer to Return Codes.

Comments

This function saves the current values of all the supported capabilities to the specified file.

Required DLLs and Libraries

LTTWN

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:	LTwain::SaveCapCallBack, LTwain::SaveErrorCallBack, LTwain::OpenTemplateFile, LTwain::AddCapabilityToFile, LTwain::GetCapabilityFromFile, LTwain::GetNumOfCapsInFile, LTwain::CloseTemplateFile, LTwain::InitSession, LTwain::EndSession.
Topics:	Handling Template Files
	TWAIN Functionality: Template File Functions.

Example

L_INT CMyTwain::SaveCapCallBack(pTW_CAPABILITY pCapability)
{
   UNREFERENCED_PARAMETER(pCapability);
   // Do pre operations on data to save
   return SUCCESS; 
}
L_INT CMyTwain::SaveErrorCallBack(pTW_CAPABILITY pCapability, L_UINT uError)
{
   UNREFERENCED_PARAMETER(pCapability);
   UNREFERENCED_PARAMETER(uError);
   // Do the error handling
   return SUCCESS; 
}
L_INT LTwain__TemplateDlgExample(L_TCHAR * pszFileName, CMyTwain *MyClass)
{
   L_INT nRet;
   MyClass->EnableCallBack (TRUE);
   nRet = MyClass->TemplateDlg (pszFileName);
   if (nRet != SUCCESS) 
   {
      // Error check procedure
      return nRet;
   }
   return SUCCESS;
}