Region：：Translate (REAL，REAL) 方法 (gdiplusheaders.h)

發行項
08/24/2023

Region：：Translate方法會以水準和垂直方向的指定數量來位移此區域。

語法

Status Translate(
  REAL dx,
  REAL dy
);

參數

dx

整數，指定要以 x 方向移動區域的數量。

dy

整數，指定要以 Y 方向移動區域的數量。

傳回值

類型：狀態

如果方法成功，它會傳回 Ok，這是 Status 列舉的元素。

如果方法失敗，它會傳回 Status 列舉的其他其中一個專案。

備註

範例

下列範例會從路徑建立區域並填滿它。然後程式碼會轉譯區域並填入翻譯的區域，以顯示區域如何轉移。

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);
}