TextureBrush：：GetTransform 方法 (gdiplusbrush.h)

项目
08/23/2023

TextureBrush：：GetTransform 方法获取此纹理画笔的转换矩阵。

语法

Status GetTransform(
  [out] Matrix *matrix
);

参数

[out] matrix

类型：矩阵*

指向接收转换矩阵的 Matrix 对象的指针。

返回值

类型：状态

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

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

备注

TextureBrush 对象维护可存储任何仿射转换的转换矩阵。使用纹理画笔填充区域时，GDI+ 会根据画笔的转换矩阵转换画笔的图像，然后填充该区域。转换后的图像仅在呈现期间存在;不会转换 存储在 TextureBrush 对象中的图像。例如，假设调用 someTextureBrush.ScaleTransform (3) 然后使用 someTextureBrush 绘制区域。画笔图像的宽度在绘制区域时是三倍，但存储在 someTextureBrush 中的图像保持不变。

示例

以下示例创建纹理画笔并设置画笔的转换。然后，代码获取画笔的转换矩阵，并继续检查或使用元素。

VOID Example_GetTransform(HDC hdc)
{
   Graphics graphics(hdc);
  
   // Create a texture brush, and set its transform.
   Image image(L"marble.jpg");
   TextureBrush textureBrush(&image);
   textureBrush.ScaleTransform(3, 2);

   // Obtain information about the texture brush.
   Matrix matrix;
   REAL elements[6];

   textureBrush.GetTransform(&matrix);
   matrix.GetElements(elements);

   for(INT j = 0; j <=5; ++j)
   {
      // Inspect or use the value in elements[j].
   }
}

要求


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