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

Artículo
02/26/2024

El método Region::IsVisible determina si un punto está dentro de esta región.

Sintaxis

BOOL IsVisible(
  [in, ref] const Point &  point,
  [in]      const Graphics *g
);

Parámetros

[in, ref] point

Tipo: const Point

Referencia a un punto que se va a probar.

[in] g

Tipo: gráficos* const

Opcional. Puntero a un objeto Graphics que contiene las transformaciones de página y mundo necesarias para calcular las coordenadas del dispositivo de esta región y el punto. El valor predeterminado es NULL.

Valor devuelto

Tipo: BOOL

Si el punto está dentro de esta región, este método devuelve TRUE; de lo contrario, devuelve FALSE.

Comentarios

Nota Una región contiene su borde.

Ejemplos

En el ejemplo siguiente se crea una región a partir de una ruta de acceso y, a continuación, se prueba para determinar si un punto está en la región.

VOID Example_IsVisiblePoint(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 a point is in the region.
   Point testPoint(125, 30);

   if(pathRegion.IsVisible(testPoint, &graphics))
   {
      // The test point is in the region.
   }

   // Fill a small circle centered at the test point.
   SolidBrush brush(Color(255, 0, 0, 0));
   graphics.FillEllipse(&brush, testPoint.X - 4, testPoint.Y - 4, 8, 8);
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusheaders.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll