L_DicomSetPresStateInfo

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 L_DicomSetPresStateInfo(hDS, pPresState)

HDICOMDS hDS;

/* a DICOM handle */

pDICOMPRESSTATEINFO pPresState;

/* pointer to a structure */

Sets the attributes of the "Presentation State Module".

Parameter

Description

hDS

A DICOM handle.

pPresState

Pointer to a "Presentation State Module" attributes structure.

Returns

0

SUCCESS

>0

An error occurred. Refer to Return Codes.

Comments

This function will set the attributes of the "Presentation State Module". Before calling this function, initialize pPresState->uStructSize to be sizeof(DICOMPRESSTATEINFO) and initialize all the members of the 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

Platforms

Win32, x64

See Also

Functions:

L_DicomGetPresStateInfo, L_DicomAddPresStateImageRefByFileName, L_DicomAddPresStateImageRefByDS, L_DicomRemovePresStateImageRefBySOPInstance, L_DicomRemoveAllPresStateImageRefs, L_DicomGetPresStateImageRefSOPInstance, L_DicomGetPresStateImageRefCount, L_DicomFindFirstPresStateRefSeriesItem, L_DicomFindNextPresStateRefSeriesItem, L_DicomGetPresStateImageRefBySOPInstance

Topics:

Working with DICOM Annotations

 

Dicom Annotations: Presentation State Module

Example

L_INT DicomSetPresStateInfoExample(HDICOMDS hPresStateDS)
{
   L_UINT16             nRet;
   VALUEDATE            Date;
   VALUETIME            Time;
   DICOMPRESSTATEINFO   PresState;
   SYSTEMTIME           SysTime;

   GetSystemTime(&SysTime);
   Date.nYear = SysTime.wYear; 
   Date.nMonth = SysTime.wMonth; 
   Date.nDay = SysTime.wDay;

   Time.nHours = SysTime.wHour;
   Time.nMinutes = SysTime.wMinute;
   Time.nSeconds = SysTime.wSecond;

   PresState.nInstanceNumber = 1;
   PresState.pszPresLabel = TEXT("Label");
   PresState.pszPresDescription = TEXT("Description");
   PresState.pszPresCreator = TEXT("Creator");
   PresState.pPresCreationDate = &Date;
   PresState.pPresCreationTime = &Time;
   PresState.uStructSize = sizeof(DICOMPRESSTATEINFO);
   nRet = L_DicomSetPresStateInfo(hPresStateDS,&PresState);
   if (nRet == DICOM_SUCCESS)
      MessageBox( NULL, TEXT("Presentation state has been successfully updated"), TEXT("Error"), MB_OK);
   return nRet;
}