LDicomIOD::Find

#include "Ltdic.h"

static pDICOMIOD LDicomIOD::Find(pIOD, nCode, nType, bTree)

pDICOMIOD pIOD;

/* pointer to a DICOMIOD structure */

L_UINT32 nCode;

/* code */

L_UCHAR nType;

/* type */

L_BOOL bTree;

/* flag that indicates how to evaluate the IOD structure */

Returns a pointer to an item in the IOD Structure that contains the IOD with the specified code and type.

Parameter

Description

pIOD

Pointer to a DICOMIOD structure that contains an item in the IOD Structure. A pointer to the item in the IOD Structure that contains the IOD with the specified nCode and nType will be returned.

nCode

Code value that specifies the Information Object Definition. The information object may be a Class, a Module or a Tag. For lists of default values, refer to Data Element Tag Constants, IOD Class Constants, and IOD Module Constants.

nType

The type of Information Object Definition you are working with. Possible values are:

 

Value

Meaning

 

IOD_TYPE_CLASS

[0x00] Class type Information Object Definition.

 

IOD_TYPE_MODULE

[0x01] Module type Information Object Definition.

 

IOD_TYPE_ELEMENT

[0x02] Element type Information Object Definition.

bTree

Flag that indicates how the IOD Structure will be evaluated. Possible values are:

 

Value

Meaning

 

TRUE

Evaluate the IOD Structure as a tree.

 

FALSE

Evaluate the IOD Structure as a list.

Returns

!NULL

A pointer to a DICOMIOD structure that contains the item in the IOD Structure of the specified code and type.

NULL

An item with the specified code and type was not found.

Comments

The nCode and nType parameters must correspond. For example, if you specify IOD_TYPE_CLASS in nType, you must specify a value from the IOD Class Constants in nCode. If you specify some other value, the item will not be found in the IOD Structure.

Required DLLs and Libraries

LTDIC

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:

LDicomIOD::FindClass, LDicomIOD::FindModule, LDicomIOD::FindIndexModule

Topics:

Working with Information Object Definitions

Example

This example displays the name of an item.

L_INT LDicomIOD_FindExample()
{
   pDICOMIOD pIOD;
   pIOD = LDicomIOD::Find(NULL, TAG_PATIENT_NAME, IOD_TYPE_ELEMENT, FALSE);
   if (pIOD != NULL)
   {
      ::MessageBox(NULL, pIOD->pszName, TEXT("Notice"), MB_OK);
   }
   return DICOM_SUCCESS;
}