Renderer.Scale-Methode (Single, Single, Boolean)

Artikel
11/26/2008

Skaliert GetViewTransform in der X-Dimension und der Y-Dimension. Wenn die Skalierungsfaktoren (durch Übergabe von false an den applyOnPenWidth-Parameter) nicht auf die Breite der Zeichnungsattribute der Freihandeingabe angewendet werden, wird die Skalierung stattdessen an GetObjectTransform vorgenommen.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Sub Scale ( _
    scaleX As Single, _
    scaleY As Single, _
    applyOnPenWidth As Boolean _
)
'Usage
Dim instance As Renderer
Dim scaleX As Single
Dim scaleY As Single
Dim applyOnPenWidth As Boolean

instance.Scale(scaleX, scaleY, applyOnPenWidth)

public void Scale(
    float scaleX,
    float scaleY,
    bool applyOnPenWidth
)

public:
void Scale(
    float scaleX, 
    float scaleY, 
    bool applyOnPenWidth
)

public void Scale(
    float scaleX,
    float scaleY,
    boolean applyOnPenWidth
)

public function Scale(
    scaleX : float, 
    scaleY : float, 
    applyOnPenWidth : boolean
)

Parameter

scaleX
Typ: System.Single
Der Faktor, um die X-Dimension der Freihandeingaben in der Ansichtstransformation zu skalieren.

scaleY
Typ: System.Single
Der Faktor, um die Y-Dimension der Freihandeingaben in der Ansichtstransformation zu skalieren.

applyOnPenWidth
Typ: System.Boolean
Ein Wert, der angibt, ob – zusätzlich zu den Gesamtabmessungen der Freihandeingabe – die Skalierungsfaktoren auf die Breite der Zeichnungsattribute der Freihandeingabe angewendet werden sollen.

Wert

Bedeutung

true

Diese Methode wendet die Skalierungsfaktoren auf die Stiftbreite an.

false

Diese Methode nimmt keine Skalierung der Stiftbreite vor.

Wert	Bedeutung
true	Diese Methode wendet die Skalierungsfaktoren auf die Stiftbreite an.
false	Diese Methode nimmt keine Skalierung der Stiftbreite vor.

Hinweise

Wenn Sie true an den applyOnPenWidth-Parameter übergeben, wird die Skalierung bei der Ansichtstransformation vorgenommen. Wenn Sie false an den applyOnPenWidth-Parameter übergeben, wird die Skalierung bei der Objekttransformation vorgenommen.

Beispiele

In diesem Beispiel wird die aktuelle Objekttransformationsmatrix mit GetObjectTransform aus dem Renderer-Objekt in einem InkOverlay-Objekt abgerufen. Anschließend wird in der x-Dimension und y-Dimension der Skalierungsfaktor 2 angewendet. Da false an den applyOnPenWidth-Parameter übergeben wird, wird die Breite der Freihand nicht skaliert. Schließlich wird mithilfe der SetObjectTransform-Methode die ursprüngliche Objekttransformation wiederhergestellt.

' create a Matrix object and obtain the current object transform
Dim origObjectTransform As Matrix = New Matrix()
mInkOverlay.Renderer.GetObjectTransform(origObjectTransform)
' scale the ink (without scaling the ink width)- this affects the object transform
mInkOverlay.Renderer.Scale(2.0F, 2.0F, False)
' later, you can restore the object transform back to the original
mInkOverlay.Renderer.SetObjectTransform(origObjectTransform)

// create a Matrix object and obtain the current object transform
Matrix origObjectTransform = new Matrix();
mInkOverlay.Renderer.GetObjectTransform(ref origObjectTransform);
// scale the ink (without scaling the ink width)- this affects the object transform
mInkOverlay.Renderer.Scale(2.0f, 2.0f, false);
// later, you can restore the object transform back to the original
mInkOverlay.Renderer.SetObjectTransform(origObjectTransform);

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.