Printer.ScaleWidth-Eigenschaft

Artikel
05/16/2015

Ruft bei Verwendung von Grafikmethoden die Anzahl der Einheiten für die horizontale Messung der Seite ab oder legt diese fest.

Namespace: Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

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

Eigenschaftswert

Typ: Single
Gibt eine Single zurück.

Hinweise

Sie können die Eigenschaften ScaleHeight und ScaleWidth verwenden, um eine benutzerdefinierte die Skalierung für das Zeichnen oder Drucken zu erstellen. Beispielsweise ändert die Anweisung ScaleHeight = 100 die Maßeinheiten Höhe der Seite. Anstelle der Höhe dass eine beliebige Anzahl Stromeinheiten (oder Twipien Pixel, beispielsweise), ist die benutzerdefinierte Höhe 100 Einheiten. Daher ist ein Abstand von 50 Einheiten Hälfte Höhe der Seite, und ein Abstand von 101 Einheiten überschreitet die Grenzen der Seite von 1 Einheiten.

Verwenden Sie die Eigenschaft ScaleMode, um eine Skalierung auf Grundlage einer Standardmaßeinheit, wie Twipien, Punkte, Pixel, Zeichen, Zoll, mm oder Zentimeter zu definieren.

Das Festlegen der Eigenschaften ScaleHeight und ScaleWidth für positive Werte macht Koordinatenzunahme von oben nach unten und von links nach rechts. Das Festlegen sie für negative Werte können Koordinatenzunahme von unten überschreiten und von rechts nach links.

Indem Sie diese Eigenschaften und verwandte ScaleLeft und die Eigenschaften ScaleTop verwenden, können Sie ein Koordinatensystem mit positiven und Negativkoordinaten erstellen. Alle vier dieser Skalaeigenschaften interagieren mit der ScaleMode-Eigenschaft folgendermaßen:

Das Festlegen einer anderen Skalaeigenschaft auf Wert wird automatisch ScaleMode auf 0 fest. ScaleMode von 0 ist benutzerdefiniert.
Wird ScaleMode auf eine Zahl als 0 ändert ScaleHeight und ScaleWidth zur neuen Maßeinheit und ScaleLeft und ScaleTop auf 0 fest. Außerdem ändern die Einstellungen CurrentX und CurrentY, um die neuen Koordinaten des aktuellen Zeitraums wiederzugeben.

Sie können die Scale-Methode auch verwenden, um ScaleHeight, ScaleWidth, ScaleLeft und ScaleTop-Eigenschaften in einer Anweisung festzulegen.

Hinweis

Funktionen und Objekte im Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6-Namespace werden den Tools zur Aktualisierung von Visual Basic 6.0 auf Visual Basic bereitgestellt.In den meisten Fällen duplizieren diese Funktionen und Objekte Funktionen aus anderen Namespaces in .NET Framework.Sie sind nur notwendig, wenn sich das Visual Basic 6.0-Codemodell erheblich von der .NET Framework-Implementierung unterscheidet.

Beispiele

Das folgende Beispiel zeigt, wie die Eigenschaften ScaleHeight und ScaleWidth festlegen.

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()

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.