Graphics：：TransformPoints (CoordinateSpace，CoordinateSpace，Point*，INT) 方法 (gdiplusgraphics.h)

發行項
02/29/2024

Graphics：：TransformPoints 方法會將點陣列從一個座標空間轉換成另一個座標空間。轉換是以這個 Graphics 物件的目前世界和頁面轉換為基礎。

語法

Status TransformPoints(
  [in]      CoordinateSpace destSpace,
  [in]      CoordinateSpace srcSpace,
  [in, out] Point           *pts,
  [in]      INT             count
);

參數

[in] destSpace

類型： CoordinateSpace

指定目的地座標空間之 CoordinateSpace 列舉的元素。

[in] srcSpace

類型： CoordinateSpace

指定來源座標空間之 CoordinateSpace 列舉的專案。

[in, out] pts

類型：點*

陣列的指標，在輸入時保留要轉換的點，並在輸出上保存轉換的點。

[in] count

類型： INT

整數，指定 pts 陣列中的項目數目。

傳回值

類型：狀態

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

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

備註

世界轉換會將點從世界座標空間轉換成頁面座標空間。頁面轉換會將點從頁面座標空間轉換為裝置座標空間。如需座標空間的詳細資訊，請參閱座標系統的類型。

範例

下列範例會建立 Graphics 物件，並將其世界轉換設定為右移 40 單位和向下 30 個單位。然後程式代碼會建立點陣列，並將該數位的位址傳遞至相同 Graphics 物件的 Graphics：：TransformPoints 方法。陣列中的點會由 Graphics 物件的世界轉換來轉換。程序代碼會呼叫 Graphics：:D rawLine 方法兩次：一次是連接轉換前的兩個點，一次是連接轉換后的兩點。

VOID Example_TransformPoints(HDC hdc)
{
   Graphics graphics(hdc);
   Pen pen(Color(255, 0, 0, 255));

   // Create an array of two Point objects.
   Point points[2] = {Point(0, 0), Point(100, 50)};

   // Draw a line that connects the two points.
   // No transformation has been performed yet.
   graphics.DrawLine(&pen, points[0], points[1]);

   // Set the world transformation of the Graphics object.
   graphics.TranslateTransform(40.0f, 30.0f);

   // Transform the points in the array from world to page coordinates.
   graphics.TransformPoints(
      CoordinateSpacePage, 
      CoordinateSpaceWorld, 
      points, 
      2);

   // It is the world transformation that takes points from world
   // space to page space. Because the world transformation is a
   // translation 40 to the right and 30 down, the
   // points in the array are now (40, 30) and (140, 80).

   // Draw a line that connects the transformed points.
   graphics.ResetTransform();
   graphics.DrawLine(&pen, points[0], points[1]);
}

規格需求

需求	值
最低支援的用戶端	Windows XP、Windows 2000 Professional [僅限桌面應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	gdiplusgraphics.h (包含 Gdiplus.h)
程式庫	Gdiplus.lib
Dll	Gdiplus.dll