Region::GetRegionScansCount メソッド (gdiplusheaders.h)

Region::GetRegionScansCount メソッドは、この領域に近似する四角形の数を取得します。 領域は、四角形が計算される前に、指定したマトリックスによって変換されます。

構文

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

パラメーター

[in] matrix

型: const Matrix*

領域の変換に使用されるマトリックスへのポインター。

戻り値

型: UINT

このメソッドは、この領域に近似する四角形の数を示す整数を返します。

注釈

Region::GetRegionScansCount メソッドは、GetRegionScans メソッドの前に使用して、四角形の数を決定できます。 次に、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 メソッド