Método Region::GetRegionScansCount (gdiplusheaders.h)

Artigo
02/29/2024

O método Region::GetRegionScansCount obtém o número de retângulos que se aproximam dessa região. A região é transformada por uma matriz especificada antes que os retângulos sejam calculados.

Sintaxe

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

Parâmetros

[in] matrix

Tipo: const Matrix*

Ponteiro para uma matriz usada para transformar a região.

Retornar valor

Tipo: UINT

Esse método retorna um inteiro que indica o número de retângulos que se aproximam dessa região.

Comentários

O método Region::GetRegionScansCount pode ser usado antes do método GetRegionScans para determinar o número de retângulos. Em seguida, você pode alocar um buffer com o tamanho correto para armazenar os retângulos obtidos com o método GetRegionScans.

Exemplos

O exemplo a seguir cria uma região de um caminho e obtém um conjunto de retângulos que se aproximam da região. Em seguida, o código desenha cada um dos retângulos.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusheaders.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll