Region ::GetRegionScansCount, méthode (gdiplusheaders.h)

La méthode Region ::GetRegionScansCount obtient le nombre de rectangles qui se rapprochent de cette région. La région est transformée par une matrice spécifiée avant le calcul des rectangles.

Syntaxe

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

Paramètres

[in] matrix

Type : const Matrix*

Pointeur vers une matrice utilisée pour transformer la région.

Valeur retournée

Type : UINT

Cette méthode retourne un entier qui indique le nombre de rectangles qui se rapprochent de cette région.

Remarques

La méthode Region ::GetRegionScansCount peut être utilisée avant la méthode GetRegionScans pour déterminer le nombre de rectangles. Ensuite, vous pouvez allouer une mémoire tampon de la taille appropriée pour stocker les rectangles obtenus avec la méthode GetRegionScans.

Exemples

L’exemple suivant crée une région à partir d’un chemin et obtient un ensemble de rectangles qui se rapprochent de la région. Le code dessine ensuite chacun des rectangles.

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);
}

Configuration requise

Voir aussi

Matrice

Rect

Région

Region ::GetRegionScans, méthodes