Printer.ScaleWidth-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft die Anzahl der Einheiten für die horizontale Abmessung der Seite beim Verwenden von Grafikmethoden ab bzw. legt sie fest.

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

Syntax

Public Property ScaleWidth As Single

Dim instance As Printer
Dim value As Single

value = instance.ScaleWidth

instance.ScaleWidth = value

public float ScaleWidth { get; set; }

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

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

Eigenschaftenwert

Typ: System.Single

Gibt Single zurück.

Hinweise

Sie können die Eigenschaften ScaleHeight und ScaleWidth verwenden, um eine benutzerdefinierte Koordinatenskalierung zum Zeichnen oder Drucken zu erstellen. Die Anweisung ScaleHeight = 100 ändert beispielsweise die Maßeinheiten für die Seitenhöhe. Statt für die Höhe einen Wert einer aktuellen Einheit (beispielsweise Twips oder Pixel) zu verwenden, werden 100 benutzerdefinierte Einheiten verwendet. Eine Entfernung von 50 Einheiten entspricht daher der halben Seitenhöhe. Eine Entfernung von 101 Einheiten überschreitet die Seitenbegrenzung um eine Einheit.

Verwenden Sie die ScaleMode-Eigenschaft, um eine Skalierung auf der Grundlage einer Standardmaßeinheit zu definieren, wie z. B. Twips, Punkte, Pixel, Zeichen, Zoll, Millimeter oder Zentimeter.

Werden für die Eigenschaften ScaleHeight und ScaleWidth positive Werte festgelegt, werden die Koordinaten von oben nach unten und von links nach rechts größer. Werden negative Werte festgelegt, werden die Koordinaten von unten nach oben und von rechts nach links größer.

Mit diesen Eigenschaften sowie den verwandten Eigenschaften ScaleLeft und ScaleTop können Sie ein Koordinatensystem mit positiven und negativen Koordinaten erstellen. Diese vier Skaliereigenschaften interagieren auf folgende Art und Weise mit der ScaleMode-Eigenschaft:

Durch das Festlegen einer anderen Skaliereigenschaft auf einen beliebigen Wert wird ScaleMode automatisch auf 0 festgelegt. Ein ScaleMode von 0 ist benutzerdefiniert.
Wenn Sie ScaleMode auf eine Zahl größer als 0 festlegen, werden ScaleHeight und ScaleWidth in die neue Maßeinheit geändert sowie ScaleLeft und ScaleTop auf 0 festgelegt. Zusätzlich ändern sich die Einstellungen von CurrentX und CurrentY, sodass sie die neuen Koordinaten des aktuellen Punkts wiedergeben.

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

Hinweis:
Funktionen und Objekte im Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6-Namespace werden für die Tools zur Aktualisierung von Visual Basic 6.0 auf Visual Basic 2008 bereitgestellt. In den meisten Fällen duplizieren diese Funktionen und Objekte Funktionalitäten, die Sie in anderen Namespaces in .NET Framework finden können. Sie sind nur notwendig, wenn sich das Visual Basic 6.0-Codemodell erheblich von der .NET Framework-Implementierung unterscheidet.

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

Beispiele

Im folgenden Beispiel wird das Festlegen der Eigenschaften ScaleHeight und ScaleWidth veranschaulicht.

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

Berechtigungen

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.