结构 - 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 实用工具方法。 InkStart、InkDraw 和 InkStop 方法使用 NextSlot 获取数组中的新槽。 在需要时,NextSlot 会动态扩展数组。
客户端调用 IPaper::Erase 方法来擦除当前绘图。 此方法不重新分配数组;它只是将所有当前墨迹数据标记为INKTYPE_NONE并将数组的数据结束索引重置为零。
客户端调用 IPaper::Lock 和 Unlock 方法来管理用于绘制的 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 接口管理此信息。