Método Region::IsVisible(INT,INT,INT,INT,constGraphics*) (gdiplusheaders.h)

O método Region::IsVisible determina se um retângulo cruza essa região.

Sintaxe

BOOL IsVisible(
  [in] INT            x,
  [in] INT            y,
  [in] INT            width,
  [in] INT            height,
  [in] const Graphics *g
);

Parâmetros

[in] x

Tipo: INT

Inteiro que especifica a coordenada x do canto superior esquerdo do retângulo a ser testado.

[in] y

Tipo: INT

Inteiro que especifica a coordenada y do canto superior esquerdo do retângulo a ser testado.

[in] width

Tipo: INT

Inteiro que especifica a largura do retângulo a ser testado.

[in] height

Tipo: INT

Inteiro que especifica a altura do retângulo a ser testado.

[in] g

Tipo: const Graphics*

Opcional. 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. O valor padrão é NULL.

Retornar valor

Tipo: BOOL

Se o retângulo cruzar essa região, o método retornará TRUE; caso contrário, retornará FALSE.

Comentários

Nota Uma região contém sua borda.

 

Exemplos

O exemplo a seguir cria uma região de um caminho e, em seguida, testa para determinar se um retângulo cruza a região.

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

   path.AddClosedCurve(points, 6);

   // Create a region from a path.
   Region pathRegion(&path);
   graphics.FillRegion(&solidBrush, &pathRegion);

   // Check to see whether the rectangle intersects the region.
   // The rectangle has upper-left corner (65, 25), width 70, and height 30.
   if(pathRegion.IsVisible(65, 25, 70, 30, &graphics))
   {
      // All or part of the rectangle is in the region.
   }

   // Draw the rectangle.
   Pen pen(Color(255, 0, 0, 0));
   graphics.DrawRectangle(&pen, 65, 25, 70, 30);
}

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

Confira também

Elementos gráficos

Rect

Região