PathGradientBrush::GetFocusScales-Methode (gdipluspath.h)

Artikel
08/24/2023

Die PathGradientBrush::GetFocusScales-Methode ruft die Fokusskalen dieses Pfadverlaufspinsels ab.

Syntax

Status GetFocusScales(
  [out] REAL *xScale,
  [out] REAL *yScale
);

Parameter

[out] xScale

Typ: REAL*

Zeiger auf einen REAL-Wert , der den x-Fokusskalierungswert empfängt.

[out] yScale

Typ: REAL*

Zeiger auf einen REAL-Wert , der den y-Fokusskalierungswert empfängt.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Standardmäßig befindet sich die Mittlere Farbe eines Pfadfarbverlaufs am Mittelpunkt. Durch Aufrufen von PathGradientBrush::SetFocusScales können Sie angeben, dass die mittlere Farbe entlang eines Pfads angezeigt werden soll, der den Mittelpunkt umgibt. Angenommen, der Begrenzungspfad ist ein Dreieck, und der Mittelpunkt befindet sich am Mittelpunkt dieses Dreiecks. Nehmen Sie außerdem an, dass die Begrenzungsfarbe rot und die Mittlere Farbe blau ist. Wenn Sie die Fokusskalierung auf (0,2, 0,2) festlegen, ist die Farbe entlang der Grenze eines kleinen Dreiecks, das den Mittelpunkt umgibt, blau. Dieses kleine Dreieck ist der Standard Begrenzungspfad, der um den Faktor 0,2 in x-Richtung und 0,2 in y-Richtung skaliert wird. Wenn Sie mit dem Pfadfarbverlaufpinsel malen, ändert sich die Farbe allmählich von Rot zu Blau, wenn Sie von der Grenze des großen Dreiecks zur Grenze des kleinen Dreiecks wechseln. Der Bereich innerhalb des kleinen Dreiecks wird mit Blau gefüllt.

Beispiele

Im folgenden Beispiel wird ein PathGradientBrush-Objekt basierend auf einem dreieckigen Pfad erstellt. Der Code legt die Fokusskalen des Pfadverlaufspinsels auf (0,2, 0,2) fest und verwendet dann den Pfadfarbverlaufpinsel, um einen Bereich zu füllen, der den dreieckigen Pfad enthält. Schließlich ruft der Code die PathGradientBrush::GetFocusScales-Methode des PathGradientBrush-Objekts auf, um die Werte der x-Fokusskalierung und der y-Fokusskalierung abzurufen.

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

   Point points[] = {Point(100, 0), Point(200, 200), Point(0, 200)};

   // No GraphicsPath object is created. The PathGradientBrush
   // object is constructed directly from the array of points.
   PathGradientBrush pthGrBrush(points, 3);

   Color colors[] = {
      Color(255, 255, 0, 0),    // red
      Color(255, 0, 0, 255)};   // blue

   REAL relativePositions[] = {
      0.0f,    // red at the boundary of the outer triangle
      1.0f};   // blue at the boundary of the inner triangle

   pthGrBrush.SetInterpolationColors(colors, relativePositions, 2);

   // The inner triangle is formed by scaling the outer triangle
   // about its centroid. The scaling factor is 0.2 in both
   // the x and y directions.
   pthGrBrush.SetFocusScales(0.2f, 0.2f);

   // Fill a rectangle that is larger than the triangle
   // specified in the Point array. The portion of the
   // rectangle outside the triangle will not be painted.
   graphics.FillRectangle(&pthGrBrush, 0, 0, 200, 200);

   // Obtain information about the path gradient brush.
   REAL xScale = 0.0f;
   REAL yScale = 0.0f;
   pthGrBrush.GetFocusScales(&xScale, &yScale);

   // The value of xScale is now 0.2.
   // The value of yScale is now 0.2. 
}

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdipluspath.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll