Strokes.Shear メソッド

2008-10-28

指定した水平方向および垂直方向のファクタで Strokes コレクションを傾斜させます。

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

構文

'宣言
Public Sub Shear ( _
    shearX As Single, _
    shearY As Single _
)
'使用
Dim instance As Strokes
Dim shearX As Single
Dim shearY As Single

instance.Shear(shearX, shearY)

public void Shear(
    float shearX,
    float shearY
)

public:
void Shear(
    float shearX, 
    float shearY
)

public void Shear(
    float shearX,
    float shearY
)

public function Shear(
    shearX : float, 
    shearY : float
)

パラメータ

shearX
型 : System.Single
傾斜の水平方向のファクタ。

shearY
型 : System.Single
傾斜の垂直方向のファクタ。

解説

このメソッドで適用される変換は、パラメータの 1 つが 0 の場合に限って純粋な傾斜になります。shearY 係数が 0 の場合は原点で四角形に適用され、四角形の高さの shearX 倍だけ底辺が水平方向に移動する変換になります。shearX 係数が 0 の場合は、四角形の幅の shearY 倍だけ右辺が垂直方向に移動されます。

メモ :
両方のパラメータが 0 以外の場合、結果が直感的にならないことがあります。

このメソッドは、傾斜が不可逆の場合は例外をスローします。shearX パラメータと shearY パラメータの積が 1 に等しい場合、傾斜は不可逆です。

例

この例では、InkOverlay オブジェクトの Strokes コレクションに対して、水平方向の傾斜 0.5 が適用されます。

' 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
    allStrokes.Shear(0.5F, 0.0F)
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)
{
    allStrokes.Shear(0.5f, 0.0f);
}