Region：：GetRegionScansCount 方法 (gdiplusheaders.h)

Region：：GetRegionScansCount 方法获取此区域近似的矩形数。 在计算矩形之前，区域由指定的矩阵转换。

语法

UINT GetRegionScansCount(
  [in] const Matrix *matrix
);

参数

[in] matrix

类型： const Matrix*

指向用于转换区域的矩阵的指针。

返回值

类型： UINT

此方法返回一个整数，指示此区域近似的矩形数。

注解

可以在 GetRegionScans 方法之前使用 Region：：GetRegionScansCount 方法来确定矩形的数量。 然后，可以分配大小正确的缓冲区，以存储使用 GetRegionScans 方法获取的矩形。

示例

以下示例从路径创建一个区域，并获取一组与该区域近似的矩形。 然后，代码绘制每个矩形。

VOID Example_GetRegionScansCount(HDC hdc)
{
   Graphics graphics(hdc);

   SolidBrush solidBrush(Color(255, 255, 0, 0));
   Pen pen(Color(255, 0, 0, 0));
   GraphicsPath path;
   Matrix matrix;
   RectF* rects = NULL;
   INT count = 0;  

   // Create a region from a path.
   path.AddEllipse(10, 10, 50, 300);
   Region pathRegion(&path);    
   graphics.FillRegion(&solidBrush, &pathRegion);

   // Get the rectangles.
   graphics.GetTransform(&matrix);
   count = pathRegion.GetRegionScansCount(&matrix);
   rects = (RectF*)malloc(count*sizeof(RectF));
   pathRegion.GetRegionScans(&matrix, rects, &count);
    
   // Draw the rectangles.
   for(INT j = 0; j < count; ++j)
      graphics.DrawRectangle(&pen, rects[j]);

   free(rects);
}

要求

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

另请参阅

矩阵

Rect

区域

Region：：GetRegionScans 方法