Renderer.Scale, méthode (Single, Single, Boolean)

Article
11/05/2008

Mise à jour : November 2007

Met à l'échelle le GetViewTransform dans les dimensions X et Y. Lorsque les facteurs d'échelle ne sont pas appliqués à la largeur des attributs de dessin de l'entrée manuscrite (en passant la valeur false au paramètre applyOnPenWidth), la mise à l'échelle se produit sur la méthode GetObjectTransform.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Sub Scale ( _
    scaleX As Single, _
    scaleY As Single, _
    applyOnPenWidth As Boolean _
)
'Utilisation
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
)

Paramètres

scaleX
Type : System.Single
Facteur de mise à l'échelle de la dimension X de l'entrée manuscrite dans la transformation d'affichage.

scaleY
Type : System.Single
Facteur de mise à l'échelle de la dimension Y de l'entrée manuscrite dans la transformation d'affichage.

applyOnPenWidth
Type : System.Boolean
Valeur qui indique s'il faut appliquer les facteurs de mise l'échelle à la largeur des attributs de dessin de l'entrée manuscrite en plus des dimensions générales de l'entrée manuscrite.

Valeur	Signification
true	Cette méthode applique les facteurs de mise à l'échelle à la largeur du stylet.
false	Cette méthode n'applique pas la mise à l'échelle à la largeur du stylet.

Notes

Lorsque vous passez la valeur true au paramètre applyOnPenWidth, la mise à l'échelle s'effectue sur la transformation d'affichage. Lorsque vous passez la valeur false au paramètre applyOnPenWidth, la mise à l'échelle s'effectue sur la transformation d'objet.

Exemples

Dans cet exemple, GetObjectTransform est utilisé pour obtenir la matrice de transformation de l'objet actuel à partir de l'objet Renderer dans un objet InkOverlay. Un facteur d'échelle de 2 est ensuite appliqué à la fois aux dimensions X et Y. Étant donné que la valeur false a été passée au paramètre applyOnPenWidth, la largeur de l'entrée manuscrite n'est pas mise à l'échelle. Enfin, la méthode SetObjectTransform est utilisée pour restaurer l'objet d'origine.

' 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);

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.