Matrix::Reset 方法 (gdiplusmatrix.h)

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

另请参阅

全局变换和局部变换

矩阵

转换的矩阵表示形式

Matrix::IsIdentity

转换