PrintCapabilities-Klasse

Bei einem PrintCapabilities-Objekt handelt es sich um eine einfach zu handhabende Darstellung für XML-Dokumente des PrintCapabilities-Dokumenttyps. Letzterer stellt eine Momentaufnahme aller Fähigkeiten eines Druckers einschließlich der aktuellen Einstellungen dar. Wenn ein Drucker z. B. den Farbdruck unterstützt, enthält das Dokument für diesen Drucker ein <PageOutputColor … >-Element, in dem die Verarbeitung von Farbausgaben definiert wird. Das Element wiederum wird durch die OutputColorCapability-Eigenschaft des PrintCapabilities-Objekts dargestellt. Wenn der Drucker keinen Farbdruck unterstützt, ist kein <PageOutputColor … >-Element im Dokument vorhanden, und die OutputColorCapability-Eigenschaft hat den Wert null. Das PrintCapabilities-Dokument muss dem Druckschema entsprechen.

Mit der PrintCapabilities-Klasse kann eine Anwendung die Fähigkeiten eines Druckers abrufen, ohne dass direkte Zugriffe auf Stream-XML-Objekte erforderlich werden.

Alle gängigen Funktionen von Datei- und Fotodruckern für den privaten und geschäftlichen Einsatz sind in der PrintCapabilities-Klasse gekapselt. Doch das Druckschema definiert viele andere, weniger häufige, Funktionen und kann zum Behandeln von Funktionen spezieller Druckgeräte erweitert werden. Obwohl die Klassen PrintTicket und PrintCapabilities nicht geerbt werden können, können Sie trotzdem das Druckschema erweitern, dass Druckgeräteigenschaften erkannt werden, die in der PrintTicket-Klasse oder PrintCapabilities-Klasse nicht berücksichtigt werden.

Hinweis   Wenn das PrintCapabilities-Objekt mit dem Konstruktor erstellt wird, der ein PrintCapabilities-Dokument (als Stream) als Parameter erwartet, dann wird dieses gesamte Dokument in einem nicht öffentlichen Feld im Objekt gespeichert, einschließlich der enthaltenen XML-Elemente, die weniger häufige Funktionen darstellen und nicht durch öffentliche Eigenschaften der PrintCapabilities-Klasse abgebildet werden. Auch privat definiertes Markup, das von einem spezifischen Treiber in einem erstellten PrintCapabilities-Dokument verwendet wurde und somit private Erweiterungen des Druckschemas darstellt, wird als Teil des nicht öffentlichen PrintCapabilities-Dokuments gespeichert.

Im folgenden Beispiel wird veranschaulicht, wie die Fähigkeiten eines bestimmten Druckers ermittelt werden können und wie diese Fähigkeiten in einem Druckauftrag verwendet werden.

// ---------------------- 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

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz

Weitere Ressourcen