Skip to main content

AddAttachment

原型

void AddAttachment(unsigned objId, const QString& name, const std::filesystem::path& filePath);

功能

用于给一个对象添加一个命名附件。该附件可以是任意的本地文件,以命名附件的方式保存到工作站中。 可以给同一个对象添加多个命名附件,不同的命名附件根据名称进行区分。

当命名附件添加后,附件的副本会保存在工作站中,直到对象删除或者直接通过API调用进行删除。 删除原文件不会影响保存在工作站中的副本。

命名附件会随着其附加主体的删除而删除,但这不会立即发生,而是在保存工作站的时候删除才会实际发生。这是考虑到命令模式redo/undo的时候,防止附件删除后无法redo。

参数

  • objId: 需要添加命名附件的对象的id
  • name: 添加的命名附件的名称,可以使用此名称区分添加到同一个对象的不同命名附件。
  • filePath: 添加为命名附件的本地文件的路径。

返回值

示例

mpl::AddAttachment(10243, "photo", "D:/videoimg/19_30_38.jpg");

说明: 该示例将D盘录像目录下的19_30_38.jpg文件,添加为id是10243的点云对象的名为"photo"的命名附件。

更多

查看HasAttachment、GetAttachments、RemoveAttachment获取更多信息。