Metodo GraphicsPath::IsOutlineVisible(constPointF&,constPen,constGraphics) (gdipluspath.h)

Articolo
08/24/2023

Il metodo GraphicsPath::IsOutlineVisible determina se un punto specificato tocca la struttura di questo percorso quando il percorso viene disegnato da un oggetto Graphics specificato e da una penna specificata.

Sintassi

BOOL IsOutlineVisible(
  const PointF & point,
  const Pen      *pen,
  const Graphics *g
);

Parametri

point

Riferimento al punto da testare.

pen

Puntatore a un oggetto Pen . Questo metodo determina se il punto di test tocca la struttura del percorso che verrà disegnata da questa penna. Più punti toccano un contorno disegnato da una penna larga che tocca un contorno disegnato da una penna stretta.

g

facoltativo. Puntatore a un oggetto Graphics che specifica una trasformazione da mondo a dispositivo. Se il valore di questo parametro è NULL, il test viene eseguito nelle coordinate mondiali; in caso contrario, il test viene eseguito nelle coordinate del dispositivo. Il valore predefinito è NULL.

Valore restituito

Se il punto di test tocca la struttura di questo percorso, questo metodo restituisce TRUE; in caso contrario, restituisce FALSE.

Commenti

Esempi

L'esempio seguente crea un percorso ellittico e disegna il percorso con una penna gialla ampia. Il codice verifica quindi ogni punto in una matrice per verificare se il punto tocca la struttura (come sarebbe disegnata dalla penna gialla ampia) del percorso. I punti che toccano la struttura sono dipinti verdi e punti che non toccano la struttura sono dipinti rosso.

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

   INT j;
   Pen yellowPen(Color(255, 255, 255, 0), 20);
   SolidBrush brush(Color(255, 255, 0,  0));

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

   // Create an array of three 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(230, 138),
      PointF(100, 120),
      PointF(150, 170)};

   for(j = 0; j <= 2; ++j)
   {
      if(path.IsOutlineVisible(points[j], &yellowPen, NULL))
         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);
   }
}

Color(255, 255, 0,  0)Color(255, 255, 0,  0)