L_ISISGetTagShortChoice

#include "l_bitmap.h"
#include "ltisi.h"

L_INT EXT_FUNCTION L_ISISGetTagShortChoice(uTag, nIndex, pnValue)

L_UINT uTag;

/* ASCII tag */

L_INT32 nIndex;

/* index value */

L_INT L_FAR *pnValue;

/* pointer to a variable */

Gets the number of possible values (or choices), or gets the value at the specified index, for the specified ISIS Scanner Driver Short Tag. This function is available in the Document/Medical Toolkits.

Parameter

Description

uTag

Value indicating the tag for which to get the specified value, or the number of possible values. For a list of possible tags, refer to ISIS Short tags.

nIndex

Index into an array of possible values (or choices) for the specified short tag. This value must be between 0 and the maximum number of values/choices - 1. Pass ISIS_DEFAULT to update pnValue with the maximum number of available values/choices for the specified tag.

pnValue

Pointer to a variable to be updated with the value at the specified index. If nIndex is ISIS_DEFAULT, this parameter will be updated with the maximum number of available values/choices for the specified tag.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

ISIS tags can have multiple values, also called choices. This function can be used to get the maximum number of available values/choices, or to get individual values.

To get the maximum number of available values/choices, pass ISIS_DEFAULT for nIndex. The pnValue parameter will be updated with the number of available values/choices.

Required DLLs and Libraries

LTISI

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 95 / 98 / Me, Windows 2000 / XP.

See Also

Functions:

L_ISISGetTagShort, L_ISISSetTagShort, L_ISISGetTagLong, L_ISISSetTagLong, L_ISISGetTagLongChoice, L_ISISGetTagASCII, L_ISISGetTagASCIIChoice, L_ISISSetTagASCII

Topics:

Raster Image Functions: Scanning Images using ISIS

 

Using ISIS to Scan Images

Example

   L_INT nValue;
   L_INT nCount;
   L_INT x;
   L_CHAR szBuf[400];
   L_INT nRet;

   //First, get the number of choices
   nRet = L_ISISGetTagShortChoice(TAG_BRIGHTNESS, ISIS_DEFAULT, &nCount);
   if(nRet == SUCCESS)
   {
      //get and display each choice
      wsprintf(szBuf, "There are %d choices\n", nCount);
      MessageBox(NULL, szBuf, "Count", MB_OK);
      for(x=0; x<nCount; x++)
      {
         //get the value
         nRet = L_ISISGetTagShortChoice(TAG_BRIGHTNESS, x, &nValue);
         wsprintf(szBuf, "Choice: %d has Value: %d\n", x, nValue);
         MessageBox(NULL, szBuf, "Value", MB_OK);
      }
   }