Renderer.Scale (Método) (Single, Single, Boolean)

Actualización: noviembre 2007

Ajusta la escala del método GetViewTransform en las dimensiones X e Y. Si no se aplican factores de escala al ancho de los atributos de dibujo de la entrada manuscrita (pasando false al parámetro applyOnPenWidth), el ajuste de escala se produce en el método GetObjectTransform en su lugar.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Sub Scale ( _
    scaleX As Single, _
    scaleY As Single, _
    applyOnPenWidth As Boolean _
)
'Uso
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
)

Parámetros

scaleX
Tipo: System.Single
Factor con que se ajusta la escala de la dimensión X de la entrada manuscrita en la transformación de vista.

scaleY
Tipo: System.Single
Factor con que se ajusta la escala de la dimensión Y de la entrada manuscrita en la transformación de vista.

applyOnPenWidth
Tipo: System.Boolean
Valor que indica si se deben aplicar los factores de escala al ancho de los atributos de dibujo de la entrada manuscrita además de a las dimensiones generales de ésta.

Valor

Significado

true

Este método aplica los factores de escala al ancho de la pluma.

false

Este método no ajusta la escala del ancho de la pluma.

Valor	Significado
true	Este método aplica los factores de escala al ancho de la pluma.
false	Este método no ajusta la escala del ancho de la pluma.

Comentarios

Si se pasa true al parámetro applyOnPenWidth, el ajuste de escala se produce en la transformación de vista. Si se pasa false al parámetro applyOnPenWidth, el ajuste de escala se produce en la transformación de objeto.

Ejemplos

En este ejemplo, se utiliza el método GetObjectTransform para obtener la matriz de transformación de objeto actual del objeto Renderer en un objeto InkOverlay. A continuación, se aplica un factor de escala de 2 en las dimensiones X e Y. Como se pasa false al parámetro applyOnPenWidth, no se ajusta la escala del ancho de la entrada manuscrita. Finalmente, se utiliza el método SetObjectTransform para restaurar la transformación de objeto original.

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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.