次の方法で共有

Graphics.TranslateTransform メソッド (Single, Single, MatrixOrder)

  • [アーティクル]

この Graphics オブジェクトの変換行列に、指定した平行移動を指定した順序で適用します。

Overloads Public Sub TranslateTransform( _
   ByVal dx As Single, _   ByVal dy As Single, _   ByVal order As MatrixOrder _)
[C#]
public void TranslateTransform(floatdx,floatdy,MatrixOrderorder);
[C++]
public: void TranslateTransform(floatdx,floatdy,MatrixOrderorder);
[JScript]
public function TranslateTransform(
   dx : float,dy : float,order : MatrixOrder);

パラメータ

  • dx
    平行移動の x 成分。
  • dy
    平行移動の y 成分。
  • order
    平行移動が変換行列の前に付加されるか後に追加されるかを指定する MatrixOrder 列挙体のメンバ。

戻り値

このメソッドは値を返しません。

解説

平行移動操作では、変換行列と平行移動部が dx パラメータおよび dy パラメータである行列を乗算します。このメソッドは、order パラメータに従って、 Graphics オブジェクトの変換行列と平行移動行列を前乗算 (前に付加) または後乗算 (後に追加) します。

使用例

[Visual Basic, C#] 次の例は、Windows フォームでの使用を意図してデザインされており、 Paint イベント ハンドラのパラメータである PaintEventArgs e が必要です。このコードは次のアクションを実行します。

  • Windows フォームのワールド変換行列を 30.0F 度回転します。
  • ベクタ (100.0F, 0.0F) でワールド変換を平行移動して、 MatrixOrder.Append でその平行移動を追加します。
  • 回転して平行移動した楕円を青のペンで描画します。
 
Public Sub TranslateTransformAngleMatrixOrder(e As PaintEventArgs)
' Set world transform of graphics object to rotate.
e.Graphics.RotateTransform(30F)
' Then to translate, appending to world transform.
e.Graphics.TranslateTransform(100F, 0F, MatrixOrder.Append)
' Draw rotated, translated ellipse to screen.
e.Graphics.DrawEllipse(New Pen(Color.Blue, 3), 0, 0, 200, 80)
End Sub
        
[C#] 
public void TranslateTransformAngleMatrixOrder(PaintEventArgs e)
{
// Set world transform of graphics object to rotate.
e.Graphics.RotateTransform(30.0F);
// Then to translate, appending to world transform.
e.Graphics.TranslateTransform(100.0F, 0.0F, MatrixOrder.Append);
// Draw rotated, translated ellipse to screen.
e.Graphics.DrawEllipse(new Pen(Color.Blue, 3), 0, 0, 200, 80);
}

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

Graphics クラス | Graphics メンバ | System.Drawing 名前空間 | Graphics.TranslateTransform オーバーロードの一覧