Matrix：：Reset 方法 (gdiplusmatrix.h)

项目
08/24/2023

Matrix：：Reset 方法使用标识矩阵的元素更新此矩阵。

语法

Status Reset();

返回值

类型：状态

如果方法成功，则返回 Ok，这是 Status 枚举的元素。

如果方法失败，它将返回 Status 枚举的其他元素之一。

注解

标识矩阵main对角线上的元素为 1。标识矩阵的所有其他元素均为 0。

示例

以下示例创建一个 Matrix 对象，该对象表示水平缩放比例为 5，垂直缩放比例为 3。代码调用 Matrix：：Reset 方法，将该矩阵的元素替换为标识矩阵的元素。然后，代码调用 Matrix：：Translate 方法，以使用自身 (标识) 和转换矩阵的乘积更新矩阵。结果是矩阵仅表示转换，而不是缩放。代码使用矩阵设置 Graphics 对象的世界转换，然后绘制一个矩形，该矩形根据该世界转换进行转换。

VOID Example_Reset(HDC hdc)
{
   Graphics graphics(hdc);
   Pen pen(Color(255, 0, 0, 255));

   Matrix matrix(5.0f, 0.0f, 0.0f, 3.0f, 0.0f, 0.0f);
   matrix.Reset();
   matrix.Translate(50.0f, 40.0f);

   graphics.SetTransform(&matrix);
   graphics.DrawRectangle(&pen, 0, 0, 100, 100);  
}

要求

要求	值
最低受支持的客户端	Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	gdiplusmatrix.h (包括 Gdiplus.h)
Library	Gdiplus.lib
DLL	Gdiplus.dll