LDicomDS: AnnSave

# include“ltdic.h”

L_UINT16LDicomDS::AnnSave(hAnnContainer, uFormat, bSelected, pSaveOption, nIndex, pnPrivateCreatorTag)

将注释保存为DICOM数据集中的私有数据。

参数

HANNOBJECThAnnContainer

根注释对象的句柄,该对象包括要保存在文件中的所有对象。这通常是一个容器对象。

L_UINTuFormat

标注数据的保存格式。可能取值为:

价值 意义
ANNFMT_NATIVE 不再支持这种格式。
ANNFMT_ENCODED 不再支持这种格式。
ANNFMT_XML [0x0005]保存为XML文本格式。这是目前唯一支持的格式。

L_BOOLbSelected

标志,指示要保存哪些对象。可能取值为:

价值 意义
真正的 保存所有将所选属性设置为TRUE的对象。要设置所选属性,请调用LAnnotation: SetSelected函数。
只保存指定的对象。

pSAVEFILEOPTIONpSaveOption

指向SAVEFILEOPTION结构,该结构包含可选的扩展保存选项。该信息用于在多页注释文件中添加注释页或替换注释页。传递NULL以保存一个单页注释文件。

L_INTnIndex

要保存的注释文件的索引。这是对存储在DICOM数据集中的注释文件数组的索引。每个DICOM数据集最多可存储256个注释文件。这是一个从零开始的索引。取值范围为0 ~ 255。

L_UINT32* pnPrivateCreatorTag

指向私有创建者标记的指针。您可以指定一个私有的创建者标记,或者传递NULL来自动创建标记。

返回

价值 意义
0 成功
> 0 发生错误。指返回代码

评论

LEAD注释文件可以保存为DICOM数据集中的私有数据(LEAD原生格式或二进制编码格式)。LEAD注释文件最多可以有256个私有数据标记。通过将nIndex参数设置为0到255的值,指定256个可能的文件之一。

您可以选择私有创建者标记(因此也可以选择私有标记),或者自动选择私有创建者标记。

要选择私有创建者标记,请执行以下操作:

  1. 声明一个类型变量L_UINT32。例如:L_UINT32 uPrivateCreatorElement
  2. 将值设置为所需的标记和元素。

    • 注意,私有创建者标记必须遵循以下格式:(段勇,0010 - 00 - ff)在哪里段勇是奇数
    • 这将保留256个私有数据元素。例如:uPrivateCreatorElement = 0x00710043 .使用实例
    • 这个特殊的私有创建者标记保留了从0x00714300到0x007143FF的元素
  3. 传递uPrivateCreatorElement的地址作为最后一个参数(pnPrivateCreatorTag)

要选择组而不是私有创建者标记的元素,请执行以下操作:

  1. 声明一个类型变量L_UINT32。例如:L_UINT32 uPrivateCreatorElement
  2. uPrivateCreatorElement如下:(gggg0000)在哪里段勇是奇数
  3. 传递地址uPrivateCreatorElement作为最后一个参数(pnPrivateCreatorTag)
  4. 如果成功,私有创建者标记(组和元素)将返回uPrivateCreatorElement

要自动选择并返回私有创建者标记,请执行以下操作:

  1. 声明一个类型变量L_UINT32。例如:L_UINT32 uPrivateCreatorElement
  2. uPrivateCreatorElement = 0
  3. 传递地址uPrivateCreatorElement作为最后一个参数(pnPrivateCreatorTag)
  4. 如果成功,私有创建者标记(组和元素)将返回uPrivateCreatorElement

要自动选择私有创建者标记但不返回,请执行以下操作:

向注释多页文件插入新页:

  1. 声明一个类型变量SAVEFILEOPTION
  2. 设置uFlags字段SAVEFILEOPTION结构ESO_INSERTPAGE
  3. 设置PageNumber字段SAVEFILEOPTION结构设置为要插入的位置。方法中指定的页面的前面将插入新页面PageNumber字段。

替换注释多页文件中已有的页面:

  1. 声明一个类型变量SAVEFILEOPTION
  2. 设置uFlags字段SAVEFILEOPTION结构ESO_REPLACEPAGE
  3. 设置PageNumber字段SAVEFILEOPTION结构转换为要替换的页面。

若要从注释多页文件中删除页面,或删除整个注释文件,请调用LDicomDS: AnnDelete

请注意:必须同时解锁DICOM和DOCUMENT功能才能使用DICOM注释。有关解锁这些功能的更多信息,请参阅LSettings: SetLicenseFile

必需的dll和库

平台

Win32, x64

LEADTOOLS DICOM c++类库帮助
188金宝搏的网址客服|支持|联系我们|知识产权公告
©1991 - 2021领德科技有限公司版权所有。