Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

PrintTicket-Klasse

 

Veröffentlicht: Oktober 2016

Definiert die Einstellungen eines Druckauftrags.

Namespace:   System.Printing
Assembly:  ReachFramework (in ReachFramework.dll)

System.Object
  System.Printing.PrintTicket

public sealed class PrintTicket : INotifyPropertyChanged

NameBeschreibung
System_CAPS_pubmethodPrintTicket()

Initialisiert eine neue Instanz der PrintTicket-Klasse.

System_CAPS_pubmethodPrintTicket(Stream)

Initialisiert eine neue Instanz der der PrintTicket Klasse, indem Sie einen XML-Stream (der ein PrintTicket-Dokument enthält), die kompatibel ist mit dem XML- Print Schema.

NameBeschreibung
System_CAPS_pubpropertyCollation

Ruft ab oder legt einen Wert, der angibt, ob der Drucker die Ausgabe sortiert.

System_CAPS_pubpropertyCopyCount

Ruft ab oder legt die Anzahl der Kopien, die für den Auftrag.

System_CAPS_pubpropertyDeviceFontSubstitution

Ruft ab oder legt einen Wert, der angibt, ob der Drucker gerätebasierte computerbasierte Schriftarten auf der Druckauftrag durch geräteseitige Schriftarten ersetzt.

System_CAPS_pubpropertyDuplexing

Ruft ab oder legt einen Wert, der angibt, welche Art von zweiseitigen drucken, ggf. für den Auftrag werden verwendet.

System_CAPS_pubpropertyInputBin

Ruft ab oder legt einen Wert, der angibt, welche Eingabe Bin (Papierschacht) verwenden.

System_CAPS_pubpropertyOutputColor

Ruft ab oder legt einen Wert, der angibt, wie der Drucker verarbeitet, die Farbe oder Graustufen verfügt.

System_CAPS_pubpropertyOutputQuality

Ruft ab oder legt einen Wert, der angibt, der Qualität der Ausgabe für den Auftrag fest.

System_CAPS_pubpropertyPageBorderless

Ruft ab oder legt einen Wert, der angibt, ob das Gerät bis zum Rand des Mediums druckt oder einen äußeren Rand bleibt.

System_CAPS_pubpropertyPageMediaSize

Ruft ab oder legt die Seitengröße für das Papier (oder ein anderes Medium), die ein Drucker für einen Druckauftrag verwendet.

System_CAPS_pubpropertyPageMediaType

Ruft ab oder legt einen Wert, der angibt, welche Art von Papier oder Medien, die für den Auftrag werden verwendet.

System_CAPS_pubpropertyPageOrder

Ruft ab oder legt einen Wert, der angibt, ob der Drucker mehrere Seiten Back Vordergrund oder vorne nach hinten druckt.

System_CAPS_pubpropertyPageOrientation

Ruft ab oder legt einen Wert, der angibt, wie der Inhalt der Seite für den Druck ausgerichtet ist.

System_CAPS_pubpropertyPageResolution

Ruft ab oder legt die Ebene der Seite Auflösung, die für einen Druckauftrag werden verwendet.

System_CAPS_pubpropertyPageScalingFactor

Ruft ab oder legt den Prozentsatz, der Drucker vergrößert oder verringert das gedruckte Bild auf einer Seite.

System_CAPS_pubpropertyPagesPerSheet

Ruft ab oder legt die Anzahl der Seiten, die auf jeder gedruckten Seite des Papiers zu drucken.

System_CAPS_pubpropertyPagesPerSheetDirection

Ruft ab oder legt einen Wert, der angibt, wie ein Drucker mehrere Seiten angeordnet, die auf jeder Seite des Papiers zu drucken.

System_CAPS_pubpropertyPhotoPrintingIntent

Ruft ab oder legt einen Wert, der die Ebene der Qualität, der Drucker verwendet wird, um ein Foto drucken, qualitativen Ausdruck.

System_CAPS_pubpropertyStapling

Ruft ab oder legt einen Wert, der angibt, ob und wo ein Drucker mehrere Seiten heftet fest.

System_CAPS_pubpropertyTrueTypeFontMode

Ruft ab oder legt einen Wert, der angibt, wie der Drucker Text verarbeitet, der TrueType-Schriftarten verwendet.

NameBeschreibung
System_CAPS_pubmethodClone()

Erstellt einen änderbaren Klon dieser PrintTicket, indem tiefe Kopien der Werte dieses Objekts erzeugt werden.

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodGetXmlStream()

Gibt ein MemoryStream -Objekt, das die Eigenschaftswerte eine PrintTicket als XML-Stream, der entspricht der Print Schema.

System_CAPS_pubmethodSaveTo(Stream)

Speichert die PrintTicket Einstellungen ein Stream -Objekt mit einem XML-Format, das entspricht, der Print Schema.

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

NameBeschreibung
System_CAPS_pubeventPropertyChanged

Tritt auf, wenn eine Eigenschaft der PrintTicket ändert.

Ein PrintTicket -Objekt ist eine einfache-zu-Darstellung eines bestimmten Typs von XML-Dokument mit dem Namen einer PrintTicket-Dokument. Letzteres ist ein Satz von Anweisungen, die einem Drucker auf die einzelnen Funktionen (z. B. Duplex, Sortieren und Heften) angezeigt. Z. B. um anzuweisen, den Drucker Hefteinheit und Heften von Druckaufträgen in der oberen linken Ecke, das Dokument müsste ein <JobStapleAllDocuments … > -Element, das gibt Wert StapleTopLeft. Das Element, dargestellt durch die Stapling Eigenschaft der PrintTicket Objekt. Das PrintTicket-Dokument entsprechen den Print Schema.

Die PrintTicket -Klasse kann eine Anwendung die Features eines Druckers konfigurieren, ohne direkte Schreibzugriffe auf XML erforderlich Stream Objekte.

Alle gängigen Funktionen von Datei- und Foto für den privaten und geschäftlichen Einsatz werden durch Eigenschaften dargestellt PrintTicket der-Klasse. Die Print Schema definiert viele andere, weniger gebräuchlich, Funktionen und können erweitert werden, um Funktionen von Specialty-Druckern zu behandeln. Also auch die PrintTicket und PrintCapabilities Klassen können nicht vererbt werden, können Sie erweitern die Print Schema Druckgerät Funktionen zu erkennen, die nicht unterstützt werden die PrintTicket oder PrintCapabilities Klassen. Weitere Informationen finden Sie unter NOTINBUILD: Gewusst wie: Erweitern der Druckschema und Erstellen von neuen drucken Systemklassen.

Hinweis   bei der PrintTicket -Objekt mit dem Konstruktor, ein PrintTicket-Dokument erstellt wird (als ein Stream) Parameter, das gesamte Dokument befindet sich in einem nicht öffentlichen Feld im Objekt, einschließlich der XML-Elemente, die weniger häufige Funktionen, die nicht von der öffentlichen Eigenschaften der dargestellt werden die PrintTicket Klasse. Denn wenn der Treiber, der das PrintTicket-Dokument produziert eine private Erweiterung verwendet das Print Schema, das privat definierte Markup wird auch als Teil der nicht öffentliche PrintTicket-Dokument gespeichert.

System_CAPS_cautionAchtung

Klassen, die innerhalb der System.Printing Namespace werden für die Verwendung in einen Windows-Dienst oder der ASP.NET-Anwendung oder der Dienst nicht unterstützt. Versucht, diese Klassen innerhalb eines dieser Anwendung verwenden kann unerwartete Probleme führen, service-Beispiel durch eine verminderte Leistung und Laufzeit-Ausnahmen.

Wenn Sie aus einer Windows Forms-Anwendung drucken möchten, finden Sie unter der System.Drawing.Printing Namespace.

Das folgende Beispiel zeigt, wie die Funktionen eines bestimmten Druckers zu ermitteln und konfigurieren ein Druckauftrags, um sie nutzen.

// ---------------------- GetPrintTicketFromPrinter -----------------------
/// <summary>
///   Returns a PrintTicket based on the current default printer.</summary>
/// <returns>
///   A PrintTicket for the current local default printer.</returns>
private PrintTicket GetPrintTicketFromPrinter()
{
    PrintQueue printQueue = null;

    LocalPrintServer localPrintServer = new LocalPrintServer();

    // Retrieving collection of local printer on user machine
    PrintQueueCollection localPrinterCollection =
        localPrintServer.GetPrintQueues();

    System.Collections.IEnumerator localPrinterEnumerator =
        localPrinterCollection.GetEnumerator();

    if (localPrinterEnumerator.MoveNext())
    {
        // Get PrintQueue from first available printer
        printQueue = (PrintQueue)localPrinterEnumerator.Current;
    }
    else
    {
        // No printer exist, return null PrintTicket
        return null;
    }

    // Get default PrintTicket from printer
    PrintTicket printTicket = printQueue.DefaultPrintTicket;

    PrintCapabilities printCapabilites = printQueue.GetPrintCapabilities();

    // Modify PrintTicket
    if (printCapabilites.CollationCapability.Contains(Collation.Collated))
    {
        printTicket.Collation = Collation.Collated;
    }

    if ( printCapabilites.DuplexingCapability.Contains(
            Duplexing.TwoSidedLongEdge) )
    {
        printTicket.Duplexing = Duplexing.TwoSidedLongEdge;
    }

    if (printCapabilites.StaplingCapability.Contains(Stapling.StapleDualLeft))
    {
        printTicket.Stapling = Stapling.StapleDualLeft;
    }

    return printTicket;
}// end:GetPrintTicketFromPrinter()

.NET Framework
Verfügbar seit 3.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: