Strokes.Transform メソッド (Matrix)

[アーティクル]
10/28/2008

ペンの幅に影響を与えずに Strokes コレクションに線形変換を適用します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public Sub Transform ( _
    inkTransform As Matrix _
)
'使用
Dim instance As Strokes
Dim inkTransform As Matrix

instance.Transform(inkTransform)

public void Transform(
    Matrix inkTransform
)

public:
void Transform(
    Matrix^ inkTransform
)

public void Transform(
    Matrix inkTransform
)

public function Transform(
    inkTransform : Matrix
)

パラメータ

inkTransform
型 : System.Drawing.Drawing2D.Matrix
Strokes コレクションで使用する System.Drawing.Drawing2D.Matrix 変換。

解説

変換がポイントに適用されますが、ペンの幅には適用されません。変換にペンの幅を含める値を設定するには、このメソッドの Transform(Matrix, Boolean) オーバーロードを使用します。

線形変換は、スケーリング、回転、変換、および変換の組み合わせを表現できます。

例

この例では、InkOverlay オブジェクトにアタッチされている Strokes コレクションが、180 度回転されます。回転は、Strokes コレクションの境界ボックスの中心を基準に行われます。

' Access to the Strokes property returns a copy of the Strokes object.
' This copy must be implicitly (via using statement) or explicitly
' disposed of in order to avoid a memory leak.
Using allStrokes As Strokes = mInkOverlay.Ink.Strokes

    Dim inkTransform As Matrix = New Matrix()
    Dim bounds As Rectangle = allStrokes.GetBoundingBox()
    Dim center As PointF = _
        New PointF(0.5F * (bounds.Left + bounds.Right), _
                   0.5F * (bounds.Top + bounds.Bottom))
    ' Translate to center of bounding box
    inkTransform.Translate(center.X, center.Y)
    ' Rotate by 180 degrees
    inkTransform.Rotate(180.0F)
    ' Translate back
    inkTransform.Translate(-center.X, -center.Y)
    ' Transform strokes
    allStrokes.Transform(inkTransform)
End Using

// Access to the Strokes property returns a copy of the Strokes object.
// This copy must be implicitly (via using statement) or explicitly
// disposed of in order to avoid a memory leak.
using (Strokes allStrokes = mInkOverlay.Ink.Strokes)
{
    Matrix inkTransform = new Matrix();
    Rectangle bounds = allStrokes.GetBoundingBox();
    PointF center = new PointF(0.5f * (bounds.Left + bounds.Right),
                               0.5f * (bounds.Top + bounds.Bottom));
    // Translate to center of bounding box
    inkTransform.Translate(center.X, center.Y);
    // Rotate by 180 degrees
    inkTransform.Rotate(180f);
    // Translate back
    inkTransform.Translate(-center.X, -center.Y);
    // Transform strokes
    allStrokes.Transform(inkTransform);
}