Metodo PathGradientBrush::SetSurroundColors (gdipluspath.h)

Articolo
03/14/2023

Il metodo PathGradientBrush::SetSurroundColors imposta i colori circondati del pennello sfumatura del percorso. I colori circondati sono colori specificati per punti discreti sul percorso limite del pennello.

Sintassi

Status SetSurroundColors(
  [in]      const Color *colors,
  [in, out] INT         *count
);

Parametri

[in] colors

Tipo: colore* const

Puntatore a una matrice di oggetti Color che specificano i colori circondati.

[in, out] count

Tipo: INT*

Puntatore a un intero che, in input, specifica il numero di oggetti Color nella matrice di colori . Se il metodo ha esito positivo, questo parametro, nell'output, riceve il numero di colori surround impostati. Se il metodo ha esito negativo, questo parametro non riceve un valore.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Un pennello sfumatura percorso ha un percorso limite e un punto centrale. Il punto centrale è impostato su un singolo colore, ma è possibile specificare colori diversi per diversi punti al limite. Si supponga, ad esempio, di specificare il rosso per il colore centrale e si specifica blu, verde e giallo per punti distinti sul limite. Poi quando si sposta lungo il limite, il colore cambierà gradualmente dal blu al verde al giallo e tornare al blu. Quando si sposta lungo una linea dritta da qualsiasi punto del limite al punto centrale, il colore cambierà dal colore del punto limite al rosso.

Esempio

Nell'esempio seguente viene creato un oggetto PathGradientBrush basato su una matrice di tre punti che definisce un percorso triangolare. Il codice inizializza anche una matrice di tre oggetti Color . La chiamata al metodo PathGradientBrush::SetSurroundColors associa ogni colore nella matrice di colori con il punto corrispondente (stesso indice) nella matrice di punti. Dopo aver impostato i colori circondati del pennello sfumatura del percorso, il metodo Graphics::FillRectangle usa il pennello sfumatura del percorso per disegnare un rettangolo che include il percorso triangolare.

Un bordo del triangolo sottoposto a rendering cambia gradualmente dal rosso al verde. Il bordo successivo cambia gradualmente dal verde al nero e il terzo bordo cambia gradualmente dal nero al rosso. Il codice non imposta il colore centrale, quindi il colore centrale ha il valore predefinito di nero. Quando si sposta lungo una linea dritta da qualsiasi punto sul percorso limite (triangolo) al punto centrale, il colore cambia gradualmente dal colore del punto limite al nero.

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

   Point pts[] = {
      Point(20, 20), 
      Point(100, 20), 
      Point(100, 100)};

   Color cols[] = {
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 255, 0),  // green
      Color(255, 0, 0, 0)};   // black

   INT count = 3;
   PathGradientBrush pthGrBrush(pts, 3);
   pthGrBrush.SetSurroundColors(cols, &count);
   
   graphics.FillRectangle(&pthGrBrush, 0, 0, 200, 200);
}

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdipluspath.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll