Region::Translate(REAL,REAL)-Methode (gdiplusheaders.h)

Artikel
08/24/2023

Die Region::Translate-Methode versetzt diesen Bereich um angegebene Mengen in horizontaler und vertikaler Richtung.

Syntax

Status Translate(
  REAL dx,
  REAL dy
);

Parameter

dx

Ganzzahl, die den Betrag angibt, der die Region in x-Richtung verschieben soll.

dy

Ganzzahl, die den Betrag angibt, um den Bereich in y-Richtung zu verschieben.

Rückgabewert

Typ: Status

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

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Bemerkungen

Beispiele

Im folgenden Beispiel wird eine Region aus einem Pfad erstellt und ausgefüllt. Der Code übersetzt dann die Region und füllt die übersetzte Region aus, um zu zeigen, wie sich die Region verschoben hat.

VOID Example_Translate(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);

   // Translate the region.
   INT dx = 100;
   INT dy = 60;
   pathRegion.Translate(dx, dy);
   graphics.FillRegion(&solidBrush, &pathRegion);
}