LTwain::CreateNumericContainerEnum

#include "ltwrappr.h"

virtual L_INT LTwain::CreateNumericContainerEnum (pCapability, Type, uNumOfItems, uCurrentIndex, uDefaultIndex, pData)

TW_CAPABILITY * pCapability;	pointer to a structure
LTWAINNUMERICTYPE Type;	container type
L_UINT32 uNumOfItems;	number of enumeration items
L_UINT32 uCurrentIndex;	current index
L_UINT32 uDefaultIndex;	default index
L_VOID * pData;	pointer to an allocated array

Allocates the hContainer member of the TW_CAPABILITY structure to be type TW_ENUMERATION and fills it with the appropriate data.

Parameter	Description
pCapability	Pointer to a structure that contains the capability container to allocate as type TW_ENUMERATION.
Type	Type of data contained in the TW_ENUMERATION container. For a list of possible values, refer to LTWAINNUMERICTYPE.
uNumOfItems	Number of items in the enumeration.
uCurrentIndex	Index of the current value in the enumeration data.
uDefaultIndex	Index of the default value in the enumeration data.
pData	Pointer to an allocated array of type TW_ENUMERATION that has been initialized with the appropriate data and size information.

Returns

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

Comments

When enumerating and getting capabilities, the toolkit takes care of creating the necessary TW_CAPABILITY containers. However, if the user wants to set a capability using the LTwain::SetCapability function, he or she must declare a TW_CAPABILITY container of the appropriate type (TW_ARRAY, TW_ENUMERATION, TW_RANGE, or TW_ONEVALUE).

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.

Example

// initialize session and call this function 
L_INT LTwain__CreateNumericContainerEnumExample(LTwain *MyClass) 
{ 
   L_INT          nRet; 
   TW_CAPABILITY  twCap; 
   L_UINT16       uItem[3]; 
   memset (&twCap, 0, sizeof(TW_CAPABILITY)); 
   twCap.Cap = ICAP_XFERMECH; 
   twCap.ConType = TWON_ENUMERATION; 
   uItem[0] = TWSX_FILE; 
   uItem[1] = TWSX_MEMORY; 
   uItem[2] = TWSX_NATIVE; 
   nRet = MyClass->CreateNumericContainerEnum(&twCap, TWAINNUMERICTYPE_TW_UINT32, 3, TWSX_MEMORY, TWSX_NATIVE, (L_VOID *)uItem); 
   if(nRet != SUCCESS) 
      return nRet; 
   nRet = MyClass->SetCapability (&twCap, LTWAIN_CAPABILITY_SET); 
   if(nRet != SUCCESS) 
      return nRet; 
   nRet = MyClass->FreeContainer(&twCap); 
   if(nRet != SUCCESS) 
      return nRet; 
   return SUCCESS; 
}

Help Version 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS TWAIN C++ Class Library Help

Introduction

Version History

LEADTOOLS TWAIN Features

Redistributables/Files To Be Included With Your Application

Classes and Function References

Tutorials

Quick Reference

Functions:	LTwain::FreeContainer, LTwain::CreateNumericContainerRange, LTwain::CreateNumericContainerOneValue, LTwain::CreateNumericContainerArray, LTwain::LockContainer, LTwain::UnlockContainer.
Topics:	How to Work with the Containers
	TWAIN Functionality: Container Functions.