Método Region::GetBounds(RectF*,constGraphics*) (gdiplusheaders.h)
O método Region::GetBounds obtém um retângulo que inclui essa região.
Sintaxe
Status GetBounds(
[out] RectF *rect,
[in] const Graphics *g
);
Parâmetros
[out] rect
Tipo: RectF*
Ponteiro para um objeto RectF que recebe o retângulo delimitador.
[in] g
Tipo: const Graphics*
Ponteiro para um objeto Graphics que contém o mundo e as transformações de página necessárias para calcular as coordenadas do dispositivo dessa região e do retângulo.
Retornar valor
Tipo: Status
Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .
Se o método falhar, ele retornará um dos outros elementos da enumeração Status .
Comentários
O mundo atual e as transformações de página do objeto gráfico são usados para calcular a região e o retângulo conforme são desenhados no dispositivo de exibição. O retângulo retornado por Region::GetBounds nem sempre é o menor retângulo possível.
Exemplos
O exemplo a seguir cria uma região de um caminho, obtém o retângulo delimitador da região e exibe ambos.
VOID Example_GetBoundsRectF(HDC hdc)
{
Graphics graphics(hdc);
Point points[] = {
Point(110, 20),
Point(120, 30),
Point(100, 60),
Point(120, 70),
Point(150, 60),
Point(140, 10)};
GraphicsPath path;
SolidBrush solidBrush(Color(255, 255, 0, 0));
Pen pen(Color(255, 0, 0, 0));
RectF rect;
path.AddClosedCurve(points, 6);
// Create a region from a path.
Region pathRegion(&path);
// Get the region's enclosing rectangle.
pathRegion.GetBounds(&rect, &graphics);
// Show the region and the enclosing rectangle.
graphics.FillRegion(&solidBrush, &pathRegion);
graphics.DrawRectangle(&pen, rect);
}
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 |