LDicomContextGroup::LoadXml

#include "Ltdic.h"

static L_UINT16 LDicomContextGroup::LoadXml(pszFile, uFlags)

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. */

Loads the context groups contained in the pszFile into the internal DICOM Context Group Table.

Parameter

Description

pszFile

Character string that contains the name of the XML file containing the context groups to load.

uFlags

Reserved for future use.  Pass 0.

Returns

0

DICOM_SUCCESS

>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 (i.e. notepad) to add or remove DICOM context groups. Then call LDicomContextGroup::LoadXml() and pass the full path of the dicTableContextGroup.xml file.   Note that calling LoadXml() will first remove all context groups that are already present in the table.

For more information, refer to the Working with DICOM Tables topic.

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

Platforms

Win32, x64

See Also

Functions:

LDicomContextGroup::Insert, LDicomContextGroup::Delete, LDicomContextGroup::Reset, LDicomContextGroup::Default, Class Members

Topics:

DICOM Context Groups: Loading/Inserting and Deleting Context Groups

Working with Unique Identifiers

Working with DICOM Tables

Example

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

L_INT LDicomContextGroup_LoadXmlExample()
{
   LDicomContextGroup::LoadXml(TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\dicTableContextGroup.xml"), 0);
   return DICOM_SUCCESS;
}