Region::GetRegionScans(constMatrix,RectF,INT*) メソッド (gdiplusheaders.h)

[アーティクル]
02/29/2024

Region::GetRegionScans メソッドは、この領域に近似する四角形の配列を取得します。領域は、四角形が計算される前に、指定された行列によって変換されます。

構文

Status GetRegionScans(
  const Matrix *matrix,
  RectF        *rects,
  INT          *count
);

パラメーター

matrix

領域の変換に使用される Matrix オブジェクトへのポインター。

rects

四角形を受け取る RectF オブジェクトの配列へのポインター。

count

この領域に近似する四角形の数を示す値を受け取る INT へのポインター。値は、 rects が NULL ポインターの場合でも有効です。

戻り値

種類: 状態

メソッドが成功した場合は、 Status 列挙の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

注釈

Region::GetRegionScansCount メソッドを最初に使用して、四角形の数を決定できます。次に、正しいサイズのバッファーを割り当て、バッファーを指す rects パラメーターを設定できます。

例

次の例では、パスから領域を作成し、その領域に近似する一連の四角形を取得します。次に、各四角形を描画します。

VOID Example_GetRegionScansRectF(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);
}