函数引用
>
L_DicomSetStringValue2
在本主题▼
L_DicomSetStringValue2
# include“Ltdic.h”
L_LTDIC_APIL_BOOLL_DicomSetStringValue2(hDS, pElement, pValue, nCount)
使用默认DICOM字符集(DICOM_CHARACTER_SET_DEFAULT)设置数据元素的字符串值。
参数
HDICOMDShDS
一个DICOM句柄。
pDICOMELEMENTpElement
指向DICOMELEMENT数据集中的结构。
L_TCHAR* pValue
指向包含要设置的字符串值的字符串指针。如果你想在Value Field中设置多个值，将所有的字符串值都放在这个字符串中，并将nCount设置为适当的值的数量。
L_UINT32nCount
值，指示要在“值字段”中设置的值的数量。如果你想在Value Field中设置多个值，将所有的字符串值放在pValue中，并将nCount设置为适当的数字。
返回
| 价值 | 意义 |
|---|---|
| 真正的 | 成功设置字符串值。 |
| 假 | 无法设置数据元素的字符串值。 |
评论
若要使用特定字符集值设置数据元素的字符串值，请使用L_DicomSetStringValue．
注意:必须为pValue分配内存。
如果要在数据元素的value字段中设置多个值，请将所有字符串值放在pValue中，并将nCount设置为相应的条目数。例如，如果你想在数据元素的Value字段中设置三个字符串值，将这三个字符串都放在pValue中，用“0”分隔符分隔，并将nCount设置为3。例如，下图显示了一个字符串，包含三个由0分隔符分隔的字符串。
有关多个值之间所需分隔符的详细信息，请参见DICOM文件格式概述和DICOM标准．
如果数据元素的值字段中存储了多个值，则必须同时设置所有值。
当数据元素的值表示形式为VR_AE、VR_CS、VR_LO、VR_LT、VR_SH、VR_ST、VR_UI、VR_UT、VR_PN时，才能调用该函数。有关值表示的详细信息，请参见默认值表示表．
必需的dll和库
- LTDIC
- 有关所需dll和库的确切列表(基于工具包版本)，请参见应用程序中包含的文件
Win32, x64, Linux。
另请参阅
功能
- L_DicomSetStringValue
- L_DicomSetDateTimeRangeValue
- L_DicomGetTimeRangeValue
- L_DicomSetTimeRangeValue
- L_DicomSetDateRangeValue
- L_DicomGetDateRangeValue
- L_DicomGetDateTimeRangeValue
主题
例子
下面的例子使用两种不同的方法设置了patient name元素的字符串值:
- 通过使用现有的特定字符集DICOM元素
- 通过指定字符集
//向前声明L_BOOL SetSpecificCharacterSet(LDicomDS *pDS, L_TCHAR *pszCharacterSet);L_INT DicomSetStringValueExample (L_VOID)｛LDicomDS ds(文本(＂＂));L_TCHAR * psztokyetext1 = TEXT("亜美"）;pDICOMELEMENT = NULL;//示例1 -使用特定字符集属性(0008,0005)来设置一个字符串ds.ResetDS ();SetSpecificCharacterSet (ds、文本(“ISO_IR 192”));// UTF-8中的UnicodepElement = ds。InsertElement(NULL, FALSE, TAG_PATIENT_NAME, VR_PN, FALSE, 0);ds。SetStringValue(pElement, psztokyetext1,1);L_TCHAR *pszResult = ds。GetStringValue(pElement, 0,1);lstrcmp (pszResult pszJapaneseText1);assert(lstrcmp(pszResult, psztokyetext1) == 0);传入DicomCharacterSet并设置一个字符串ds.ResetDS ();pElement = ds。InsertElement(NULL, FALSE, TAG_PATIENT_NAME, VR_PN, FALSE, 0);ds。SetStringValue(pElement, psztokyetext1,1, DICOM_CHARACTER_SET_UNICODE_IN_UTF8);pszResult = ds。GetStringValue(pElement, 0,1);assert(lstrcmp(pszResult, psztokyetext1) == 0);返回DICOM_SUCCESS;｝L_BOOL SetSpecificCharacterSet(LDicomDS *pDS, L_TCHAR *pszCharacterSet)｛如果(pDS == NULL)｛返回虚假的;｝如果(pszCharacterSet == NULL)｛返回虚假的;｝pDICOMELEMENT pElement = pDS->InsertElement(NULL, FALSE, TAG_SPECIFIC_CHARACTER_SET, VR_CS, FALSE, 0);如果(pElement == NULL)｛返回虚假的;｝返回pDS->SetStringValue(pElement, pszCharacterSet, 1);｝
LEADTOOLS DICOM C API帮助
