Stroke.Transform メソッド (Matrix, Boolean)

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

線形変換を Stroke オブジェクトに適用します。また、変換をペンの幅に適用するかどうかを指定できます。

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

構文

'宣言
Public Sub Transform ( _
    inkTransform As Matrix, _
    applyOnPenWidth As Boolean _
)
'使用
Dim instance As Stroke
Dim inkTransform As Matrix
Dim applyOnPenWidth As Boolean

instance.Transform(inkTransform, applyOnPenWidth)

public void Transform(
    Matrix inkTransform,
    bool applyOnPenWidth
)

public:
void Transform(
    Matrix^ inkTransform, 
    bool applyOnPenWidth
)

public void Transform(
    Matrix inkTransform,
    boolean applyOnPenWidth
)

public function Transform(
    inkTransform : Matrix, 
    applyOnPenWidth : boolean
)

パラメータ

inkTransform
型 : System.Drawing.Drawing2D.Matrix
Stroke オブジェクトで使用する System.Drawing.Drawing2D.Matrix 変換。

applyOnPenWidth
型 : System.Boolean
Stroke オブジェクトの DrawingAttributes のインクの幅に変換を適用するかどうかを示すブール値。

値

説明

true

変換が、ポイントとペンの幅の両方に適用されます。

false

変換がポイントにのみ適用されます。

値	説明
true	変換が、ポイントとペンの幅の両方に適用されます。
false	変換がポイントにのみ適用されます。

解説

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

ペンの幅が変換に合わせて適切にスケーリングされる場合、描画されるペンの幅は、指定したペンの幅 (指定がない場合は既定値の 53) を変換の行列式の平方根で乗算することにより計算されます。

例

この C# の例では、ストロークの境界ボックスの中心を基準としてファクタ 2 で Stroke オブジェクト theStroke をスケーリングします。インクの幅も、ファクタ 2 でスケーリングされます。

using System.Drawing.Drawing2D;
//...
Matrix inkTransform = new Matrix();
Rectangle inkBounds = theStroke.GetBoundingBox();
PointF center = new PointF(0.5f * (inkBounds.Left + inkBounds.Right),
                           0.5f * (inkBounds.Top + inkBounds.Bottom));
// Translate to center of bounding box
inkTransform.Translate(center.X, center.Y);
// Scale by factor of 2
inkTransform.Scale(2.0F, 2.0F);
// Translate back
inkTransform.Translate(-center.X, -center.Y);
// Transform stroke
theStroke.Transform(inkTransform, true);

この Microsoft Visual Basic .NET の例では、ストロークの境界ボックスの中心を基準としてファクタ 2 で Stroke オブジェクト theStroke をスケーリングします。インクの幅も、ファクタ 2 でスケーリングされます。

Imports System.Drawing.Drawing2D
'...
Dim inkTransform As New Matrix()
Dim inkBounds As Rectangle = theStroke.GetBoundingBox()
Dim center As New PointF(0.5F * (inkBounds.Left + inkBounds.Right), _
                         0.5F * (inkBounds.Top + inkBounds.Bottom))
'Translate to center of bounding box
inkTransform.Translate(center.X, center.Y)
'Scale by a factor of 2
inkTransform.Scale(2.0F, 2.0F)
'Translate back
inkTransform.Translate(-center.X, -center.Y)
'Transform stroke
theStroke.Transform(inkTransform, True)