L_TwainEnableShowUserInterfaceOnly

#include "lttwn.h"

L_LTTWN_API L_INT L_TwainEnableShowUserInterfaceOnly (hSession, bEnable)

HTWAINSESSION hSession;

/* handle to an existing TWAIN session */

L_BOOL bEnable;

/* enable flag */

Indicates whether to display the Twain user interface with or without the Scan button, if supported.

Parameter

Description

hSession

Handle to an existing TWAIN session. This handle is obtained by calling the L_TwainInitSession function.

bEnable

Flag that indicates whether to display the user interface.  Possible values are:

 

Value

Meaning

 

TRUE

Display the Twain user interface without the scan button, if supported.

 

FALSE

Display the normal Twain driver user interface with the scan button. (Default)

Returns

SUCCESS

The function was successful.

! = SUCCESS

An error occurred. Refer to Return Codes.

Comments

To display the Twain driver user interface without the scan button, call this function with the bEnable parameter set to true. Then call L_TwainTemplateDlg to display the template dialog.

If you call this function with the bEnable parameter set to false, the template dialog will display the normal Twain user interface, with the scan button.

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

Function:

L_TwainInitSession, L_TwainTemplateDlg.

Topics:

Handling Template Files

 

TWAIN Functionality: Template File Functions.

Example

static HTWAINSESSION g_hSession;

L_INT TwainEnableShowUserInterfaceOnlyExample(L_TCHAR* pszFileName)
{
   L_INT nRet;
   nRet = L_TwainEnableShowUserInterfaceOnly(g_hSession, TRUE);
   if(nRet != SUCCESS)
      return nRet;
   nRet = L_TwainTemplateDlg(g_hSession, pszFileName, NULL, NULL, NULL);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}