L_IsTwainAvailable

#include "lttwn.h"

L_LTTWN_API L_BOOL L_IsTwainAvailable(hWnd)

HWND hWnd;

/* handle to a window */

Determines whether a TWAIN source is installed.

Parameter

Description

hWnd

Handle to a window. (Internal TWAIN functions require a window handle; any valid window handle will work in this case.)

Returns

TRUE

At least one TWAIN source is installed.

FALSE

No TWAIN source is installed.

Comments

You can use this function when deciding whether to enable or disable TWAIN menu items.

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:

L_TwainAcquire, L_TwainAcquireList, L_TwainInitSession, L_TwainEndSession, L_TwainOpenTemplateFile, L_TwainCloseTemplateFile, L_TwainTemplateDlg, L_TwainAddCapabilityToFile, L_TwainGetNumofCapsInFile, L_TwainGetCapabilityFromFile.

Topics:

TWAIN Functionality: Property Functions

Example

 L_INT IsTwainAvailableExample(HWND hWnd,HBITMAPLIST hBitmap)
{
   L_BOOL bAvailable;
   L_INT nRet;
   HTWAINSESSION hSession = NULL;
   APPLICATIONDATA AppData;

   /* Check to see if TWAIN is installed */
   bAvailable = L_IsTwainAvailable(hWnd);
   if (bAvailable)
   {
      AppData.uStructSize = sizeof(APPLICATIONDATA);
      AppData.hWnd = hWnd;
      lstrcpy (AppData.szManufacturerName, TEXT("LEAD Technologies, Inc."));
      lstrcpy (AppData.szAppProductFamily, TEXT("LEAD Test Applications"));
      lstrcpy (AppData.szVersionInfo, TEXT("Version 1.0"));
      lstrcpy (AppData.szAppName, TEXT("TWAIN Test Application"));
      AppData.uLanguage = TWLG_ENGLISH_USA;
      AppData.uCountry  = TWCY_USA;
      nRet = L_TwainInitSession(&hSession, &AppData);
      if (nRet != SUCCESS) 
         return nRet;

      nRet = L_TwainAcquireList(hSession, hBitmap, NULL, LTWAIN_SHOW_USER_INTERFACE);
      if(nRet != SUCCESS)
         return nRet;
      nRet = L_TwainEndSession(&hSession);
      if(nRet != SUCCESS)
         return nRet;
   }
   return SUCCESS;
}