**GDI+ SDK 参考（翻译版本）**
GDI+（Graphics Device Interface Plus）是微软为C/C++开发者提供的一款基于类的应用程序编程接口，主要用于处理图形和格式化的文本。GDI+允许程序员在视频显示器和打印机上创建和显示图形内容，而无需直接与图形硬件交互。它是构建在Win32 API之上的，同时也支持Win64平台。
**适用范围与读者**
GDI+适用于所有Windows应用程序，特别是Windows XP和Windows Server 2003及以上版本。对于运行在Windows NT 4.0 SP6、Windows 2000、Windows 98及Windows Me等较旧操作系统上的应用程序，需要在分发时包含GDI+库（Gdiplus.dll）。开发者应具备Windows图形用户接口（GUI）和消息驱动机制的熟练知识，以利用GDI+ C++基类接口进行开发。
**运行环境**
Gdiplus.dll是Windows XP操作系统的一部分，但可以重新分发到其他支持的系统，如Windows NT 4.0 SP6、Windows 2000、Windows 98和Windows Me。为了在不包含GDI+的系统上运行应用，你需要从微软官方网站下载最新的可重新分发安装包，并确保正确部署Gdiplus.dll，以避免地址空间冲突。
**文档组织**
GDI+的参考文档通常包括以下部分：
1. **概览**：提供GDI+的基本介绍。
2. **用法**：涵盖使用GDI+执行各种任务和示例。
3. **参考**：详尽的GDI+ C++基类API参考，包括类和方法的说明。
4. **相关主题**：指向其他图形技术（如DirectX、Windows Image Acquisition、OpenGL和Windows Multimedia）的链接。
**安全考虑**
在使用GDI+开发时，安全是重要的考量因素。例如，要检查构造函数是否成功调用，可以使用`Image::GetLastStatus`方法来获取状态信息。如果返回`Ok`，则表示构造函数成功；若返回`InvalidParameter`，则表示参数无效。此外，需要注意缓冲区的分配，某些GDI+方法需要预先分配的缓冲区来存储返回的数据。例如，在使用`GraphicsPath::GetPathPoints`前，先通过`GetPointCount`确定所需的点数，再分配足够的内存空间。
**使用示例**
以下是一个简单的示例，展示如何创建一个`Image`对象并检查其构造是否成功，以及如何处理`GraphicsPath`对象的点：
```cpp
Image myImage(L"Climber.jpg");
Status st = myImage.GetLastStatus();
if (Ok == st) {
// 构造成功，可以使用myImage
} else if (InvalidParameter == st) {
// 参数无效，处理错误
} else {
// 检查其他Status枚举值或进行一般错误处理
}
int pointCount = myGraphicsPath.GetPointCount();
Point* points = new Point[pointCount];
if (nullptr != points) {
myGraphicsPath.GetPathPoints(points, pointCount);
// 处理points数组
delete[] points;
}
```
GDI+提供了一套丰富的图形绘制和处理功能，让开发者能够创建出复杂的图形用户界面和高质量的图像内容。通过理解GDI+的API和最佳实践，开发者可以构建出高效且安全的Windows应用程序。
