Graphics::TransformPoints(CoordinateSpace,CoordinateSpace,PointF*,INT) メソッド (gdiplusgraphics.h)

[アーティクル]
08/24/2023

Graphics::TransformPoints メソッドは、ある座標空間から別の座標空間にポイントの配列を変換します。変換は、この Graphics オブジェクトの現在のワールド変換とページ変換に基づいています。

構文

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

パラメーター

[in] destSpace

種類: CoordinateSpace

変換先の座標空間を指定する CoordinateSpace 列挙体の要素。

[in] srcSpace

種類: CoordinateSpace

ソース座標空間を指定する CoordinateSpace 列挙体の要素。

[in, out] pts

種類: ポイント*

入力時に変換するポイントを保持し、出力時に変換されたポイントを保持する配列へのポインター。

[in] count

型: INT

pts 配列内の要素の数を指定する整数。

戻り値

種類: 状態

メソッドが成功した場合は、 Status 列挙の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

解説

ワールド変換は、ワールド座標空間からページ座標空間にポイントを変換します。ページ変換は、ポイントをページ座標空間からデバイス座標空間に変換します。座標空間の詳細については、「座標系の種類」を参照してください。

例

次の例では、Graphics オブジェクトを作成し、そのワールド変換を右に 40 単位、30 単位下に設定します。次に、ポイントの配列を作成し、その配列のアドレスを同じ Graphics オブジェクトの Graphics::TransformPoints メソッドに渡します。配列内のポイントは、 Graphics オブジェクトのワールド変換によって変換されます。このコードでは、Graphics::D rawLine メソッドを 2 回呼び出します。1 回は変換前の 2 つのポイントを接続し、1 回は変換後に 2 つのポイントを接続します。

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 を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll

Graphics::TransformPoints(CoordinateSpace,CoordinateSpace,PointF*,INT) メソッド (gdiplusgraphics.h)

構文

パラメーター

戻り値

解説

例

要件

関連項目

フィードバック

フィードバック

その他のリソース