Printer.ScaleMode-Eigenschaft

Článek
08/23/2008

Aktualisiert: November 2007

Ruft einen Wert ab oder legt einen Wert fest, der die Maßeinheit für die Koordinaten eines Objekts bei der Verwendung von Grafikmethoden angibt.

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

Syntax

'Declaration
Public Property ScaleMode As Short
'Usage
Dim instance As Printer
Dim value As Short

value = instance.ScaleMode

instance.ScaleMode = value

public short ScaleMode { get; set; }

public:
property short ScaleMode {
    short get ();
    void set (short value);
}

public function get ScaleMode () : short
public function set ScaleMode (value : short)

Eigenschaftenwert

Typ: System.Int16

Gibt Short zurück.

Hinweise

Mit den verwandten Eigenschaften ScaleHeight, ScaleWidth, ScaleLeft und ScaleTop können Sie ein benutzerdefiniertes 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 die ScaleMode-Eigenschaft 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. Die Einstellungen der CurrentX-Eigenschaft und der CurrentY-Eigenschaft ändern sich, sodass sie die neuen Koordinaten des aktuellen Punkts wiedergeben.

In der folgenden Tabelle werden die ScaleModeConstants-Werte aufgelistet, die für die ScaleMode-Eigenschaft gültig sind.

Konstante	Wert	Beschreibung
vbUser	0	Gibt an, dass mindestens eine der Eigenschaften ScaleHeight, ScaleWidth, ScaleLeft und ScaleTop auf benutzerdefinierte Werte festgelegt wurde.
vbTwips	1	Twip (1440 Twips pro Zoll; 567 Twips pro Zentimeter). (Das ist die Standardeinstellung.)
vbPoints	2	Punkt (72 Punkte pro logischen Zoll)
vbPixels	3	Pixel (kleinste Einheit der Bildschirm- oder Druckerauflösung)
vbCharacters	4	Zeichen (horizontal = 120 Twips pro Einheit; vertikal = 240 Twips pro Einheit)
vbInches	5	Zoll
vbMillimeters	6	Millimeter
vbCentimeters	7	Zentimeter

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 Eigenschaft ScaleMode veranschaulicht, indem für jeden ScaleMode-Wert ein Kreis gezeichnet wird.

Dim Printer As New Printer
Dim i As Integer
For i = 1 To 6
    Printer.ScaleMode = Printer.ScaleMode + 1
    Printer.Circle(Printer.ScaleWidth / 2, Printer.ScaleHeight / 2, 5)
Next i
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.