Printer.Copies-Eigenschaft

Článek
08/23/2008

Aktualisiert: November 2007

Ruft einen Wert ab bzw. legt einen Wert fest, der bestimmt, wie viele Exemplare gedruckt werden sollen.

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

Syntax

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

value = instance.Copies

instance.Copies = value

public short Copies { get; set; }

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

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

Eigenschaftenwert

Typ: System.Int16

Ein Short-Wert, der die Anzahl der zu druckenden Exemplare angibt.

Hinweise

Wird die PrintAction-Eigenschaft auf einen anderen Wert als PrintToPrinter festgelegt, wird diese Eigenschaft ignoriert.

Wenn die Copies-Eigenschaft auf einen Wert festgelegt wird, der kleiner als 1 ist, tritt eine Laufzeitausnahme auf.

Wenn diese Eigenschaft festgelegt wird, nachdem die Methode Print, Circle, Line oder PSet auf einer neuen Seite aufgerufen wurde, tritt eine Laufzeitausnahme auf.

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

Das folgende Beispiel veranschaulicht das Festlegen der Copies-Eigenschaft. Es wird vorausgesetzt, dass zur Laufzeit eine TextBox mit der Bezeichnung txtCopies verwendet wird, um die Anzahl der zu druckenden Exemplare festzulegen.

Dim pr As New Printer
Dim numCopies As Short
numCopies = CShort(txtCopies.Text)
pr.Copies = numCopies
pr.Print("Hello")
pr.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.