Método Region::GetRegionScansCount (gdiplusheaders.h)
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 |