结构 - StoServe

COPaper 将笔颜色、宽度和坐标打包到 INKDATA 结构中,并将其存储在它在内存中管理的动态分配数组中。

INKDATA 结构

以下是 PAPER.H 中 INKDATA 结构的声明。

// The types of Ink Data.
#define INKTYPE_NONE  0
#define INKTYPE_START 1
#define INKTYPE_DRAW  2
#define INKTYPE_STOP  3

  // The Ink Data structure.
  typedef struct _INKDATA
  {
    SHORT nType;            // Ink Type.
    SHORT nX;               // X-coordinate of ink point.
    SHORT nY;               // Y-coordinate of ink point.
    SHORT nWidth;           // Ink line width in pixels.
    COLORREF crColor;       // Ink color.
  } INKDATA;

IPaper 实现类的成员 m_paInkData 指向这些 INKDATA 数据包的动态数组。 该数组是在 IPaper::InitPaper 方法中使用初始分配创建的。 有关详细信息,请参阅 PAPER.H 中 CImpIPaper 实现的 InitPaper 方法和专用 NextSlot 实用工具方法。 InkStartInkDrawInkStop 方法使用 NextSlot 获取数组中的新槽。 在需要时,NextSlot 会动态扩展数组。

客户端调用 IPaper::Erase 方法来擦除当前绘图。 此方法不重新分配数组;它只是将所有当前墨迹数据标记为INKTYPE_NONE并将数组的数据结束索引重置为零。

客户端调用 IPaper::LockUnlock 方法来管理用于绘制的 COPaper 的所有权。 提供这些方法来组织多个客户端之间对共享 COPaper 中保存的绘图的访问。

PAPER_PROPERTIES 结构

客户端调用 IPaper::Resize 方法以告知 COPaper 用户调整了当前绘图纸矩形的大小。 此坐标数据保存在 PAPER_PROPERTIES 结构中,当所有纸张数据存储在复合文件中时,该结构与墨迹数据一起存储。

下面是 PAPER.H 中的PAPER_PROPERTIES 声明。

#define PAPER_TITLE_SIZE 64
  typedef struct _PAPER_PROPERTIES
  {
    LONG lInkDataVersion;
    LONG lInkArraySize;
    COLORREF crWinColor;
    RECT WinRect;
    WCHAR wszTitle[PAPER_TITLE_SIZE];
    WCHAR wszAuthor[PAPER_TITLE_SIZE];
    WCHAR wszReserved1[PAPER_TITLE_SIZE];
    WCHAR wszReserved2[PAPER_TITLE_SIZE];
  } PAPER_PROPERTIES;

PAPER_PROPERTIES结构的设计目的是随着 DllPaper 组件的发展,随时可以添加新的墨迹数据格式。 IPaper 接口很通用,DllPaper 组件的后续版本可以在实现同一 IPaper 接口时存储不同的墨迹数据格式。 由于 IPaper 的方法不依赖于特定的墨迹数据格式,因此支持不同墨迹数据格式的 DllPaper 组件的新版本可以使用此同一接口。

复合文件中存储的纸张属性记录墨迹数据数组的当前大小。 然后,可以分配适当的数组大小,以适应从文件读取的墨迹数据。

PAPER_PROPERTIES结构还存储纸张表面的绘图矩形大小和背景窗口颜色。

尽管未在 StoServe/StoClien 示例中使用,但也可以存储绘图标题和作者姓名。

创建日期和上次修改日期不包括在这些纸张属性中,因为用于访问复合文件的 IStorage 接口管理此信息。