Printer.ScaleWidth (Propiedad)

Artículo
11/02/2012

Obtiene o establece el número de unidades de medida horizontal de la página al utilizar métodos gráficos.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
Public Property ScaleWidth As Single

public float ScaleWidth { get; set; }

public:
property float ScaleWidth {
    float get ();
    void set (float value);
}

member ScaleWidth : float32 with get, set

function get ScaleWidth () : float
function set ScaleWidth (value : float)

Valor de propiedad

Tipo: System.Single
Devuelve Single.

Comentarios

Puede utilizar las propiedades de ScaleHeight y de ScaleWidth para crear una escala coordinada personalizada para dibujar o imprimir.Por ejemplo, la instrucción ScaleHeight = 100 cambian las unidades de medida del alto de la página.En lugar de alto que es un número de unidades actuales (los twips o píxeles, por ejemplo), el alto será 100 unidades definido por el usuario.Por consiguiente, una distancia de 50 unidades es la mitad del alto de la página, y una distancia de 101 unidades superará los límites de la página por 1 unidad.

Utilice la propiedad de ScaleMode para definir una escala basada en una unidad de medida estándar, como twips, puntos, píxeles, caracteres, pulgadas, milímetros, o centímetros.

Estableciendo las propiedades de ScaleHeight y de ScaleWidth a valores positivos crea aumento de las coordenadas de arriba abajo y de izquierda a derecha.Estableciendolos a valores negativos crea aumento de las coordenadas de abajo arriba y de derecha a izquierda.

Mediante estas propiedades y ScaleLeft y las propiedades relacionadas de ScaleTop , puede crear un sistema de coordenadas con coordenadas positivas y negativas.Los cuatro de estas propiedades de escala interactúan con la propiedad de ScaleMode de las maneras siguientes:

Establecer otra propiedad de la escala en cualquier valor establece automáticamente ScaleMode a 0.ScaleMode de 0 es definido por el usuario.
El valor ScaleMode un número a mayor de 0 cambia ScaleHeight y ScaleWidth a la nueva unidad de medida y establece ScaleLeft y ScaleTop a 0.Además, CurrentX y los valores de CurrentY para reflejar las nuevas coordenadas de punto actual.

También puede utilizar el método de Scale para establecer ScaleHeight, ScaleWidth, ScaleLeft, y las propiedades de ScaleTop en una instrucción.

[!NOTA]

Las funciones y los objetos del espacio de nombres Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 se proporcionan para que se utilicen con las herramientas de actualización de Visual Basic 6.0 a Visual Basic.En la mayoría de los casos, estos objetos y funciones proporcionan la misma funcionalidad que otros espacios de nombres de .NET Framework.Únicamente son necesarios cuando el modelo de código de Visual Basic 6.0 difiere notablemente de la implementación de .NET Framework.

Ejemplos

El ejemplo siguiente se muestra cómo establecer las propiedades de ScaleHeight y de ScaleWidth .

Dim Printer As New Printer
Dim Radius As Integer
Printer.ScaleHeight = 100
Printer.ScaleWidth = 100
Printer.FillStyle = 1
For Radius = 5 To 50 Step 5
    Printer.Circle(50, 50, Radius)
Next Radius
Printer.EndDoc()

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.