Método GraphicsPath::IsVisible(constPointF&,constGraphics*) (gdipluspath.h)

Artigo
01/10/2024

O método GraphicsPath::IsVisible determina se um ponto especificado está na área preenchida quando esse caminho é preenchido por um objeto Graphics especificado.

Sintaxe

BOOL IsVisible(
  const PointF & point,
  const Graphics *g
);

Parâmetros

point

Referência ao ponto a ser testado.

g

Opcional. Ponteiro para um objeto Graphics que especifica uma transformação de mundo para dispositivo. Se o valor desse parâmetro for NULL, o teste será feito em coordenadas mundiais; caso contrário, o teste será feito nas coordenadas do dispositivo. O valor padrão é NULL.

Retornar valor

Se o ponto de teste estiver no interior desse caminho, esse método retornará TRUE; caso contrário, retornará FALSE.

Comentários

Exemplos

O exemplo a seguir cria um caminho elíptico e desenha esse caminho com uma caneta preta estreita. Em seguida, o código testa cada ponto em uma matriz para ver se o ponto está no interior do caminho. Os pontos que estão no interior são pintados de verde, e os pontos que não estão no interior são pintados de vermelho.

VOID IsVisibleExample(HDC hdc)
{
   Graphics graphics(hdc);

   INT j;
   Pen blackPen(Color(255, 0, 0, 0), 1);
   SolidBrush brush(Color(255, 255, 0,  0));

   // Create and draw a path.
   GraphicsPath path;
   path.AddEllipse(50, 50, 200, 100);
   graphics.DrawPath(&blackPen, &path);

   // Create an array of four points, and determine whether each
   // point in the array touches the outline of the path.
   // If a point touches the outline, paint it green.
   // If a point does not touch the outline, paint it red.
   PointF[] = {
      PointF(50, 100),
      PointF(250, 100),
      PointF(150, 170),
      PointF(180, 60)};

   for(j = 0; j <= 3; ++j)
   {
      if(path.IsVisible(points[j], &graphics))
         brush.SetColor(Color(255, 0, 255,  0));
      else
         brush.SetColor(Color(255, 255, 0,  0));

      graphics.FillEllipse(&brush, points[j].X - 3.0f, points[j].Y - 3.0f, 6.0f, 6.0f);
   }
}