L_DicomLoadXmlContextGroup

#include "Ltdic.h"

L_LTDIC_API L_UINT16 L_DicomLoadXmlContextGroup(pszFile, uFlags)

Loads the Context Groups contained in the pszFile into the internal DICOM TAGTable.

Parameters

L_TCHAR *pszFile

Character string that contains the name of the XML file containing the Context Groups to load.

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

Value Meaning
DICOM_SUCCESS The function was successful.
>0 An error occurred. Refer to Return Codes.

Comments

Starting in version 17.5 of the toolkit, you can easily and quickly customize the DICOM Context Group table by editing the dicTableContextGroup.xml file that is found in the LEADTOOLS Sample Images folder.  The dicTableContextGroup.xml file is a human-readable XML file that lists all of the DICOM Context Groups currently defined in the DICOM Specification.  You can edit this with any text editor (for example, notepad) to add or remove DICOM Context Groups. Then call L_DicomLoadXmlContextGroup() and pass the complete path of the dicTableContextGroup.xml file. Note that calling  L_DicomLoadXmlContextGroup() will first remove all context groups that are already present in the table.

To see the default values for the DICOM Context Group Table, refer to the Default Data Context Group Table.

For more information, see the topic Working with DICOM Tables.

Required DLLs and Libraries

Platforms

Win32, x64

See Also

Functions

Topics

Example

This example loads the DICOM Context Group table from the dicTableContextGroup.xml file that is shipped with the toolkit.

L_INT DicomLoadXmlContextGroupExample(L_VOID) 
{ 
   L_DicomLoadXmlContextGroup(TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\dicTableContextGroup.xml"), 0); 
   return DICOM_SUCCESS; 
} 

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help