OutputQuality Énumération

Définition

Espace de noms:

System.Printing

Assembly:

ReachFramework.dll

Spécifie les types de qualité de sortie d'un périphérique d'impression.

C#

public enum OutputQuality

Héritage

Object

ValueType

Enum

OutputQuality

Champs

Nom	Valeur	Description
Automatic	1	Sélectionne automatiquement un type de qualité en fonction du contenu d'un travail d'impression.
Draft	2	Qualité brouillon.
Fax	3	Qualité télécopie.
High	4	Meilleure qualité.
Normal	5	Qualité normale.
Photographic	6	Qualité photographique. Pour plus d’informations, consultez Remarque sur OutputQuality.Photographic dans la section Notes.
Text	7	Qualité texte.
Unknown	0	La fonctionnalité (dont les options sont représentées par cette énumération) est définie avec une option non définie dans le Schéma d’impression.

Exemples

L’exemple suivant montre comment tester les fonctionnalités d’une imprimante et configurer le travail d’impression pour en tirer parti. .

C#

// ---------------------- 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 printCapabilities = printQueue.GetPrintCapabilities();

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

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

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

    return printTicket;
}// end:GetPrintTicketFromPrinter()

Remarques

Utilisez les valeurs de ce type principalement à ces fins :

• En tant que membres de la OutputQualityCapability collection, qui est une propriété de PrintCapabilities, ces valeurs indiquent les types de qualité de sortie pris en charge par une imprimante.

• En tant que valeur de la OutputQuality propriété d’un PrintTicket, ils dirigent une imprimante pour produire une qualité particulière.

La Unknown valeur n’est jamais utilisée dans les propriétés des PrintCapabilities objets.

Vous ne devez jamais définir une PrintTicket propriété sur Unknown. Si une autre PrintTicket application productrice a créé un document PrintTicket qui définit la fonctionnalité de qualité de sortie sur une option non reconnue (c’est-à-dire une option qui n’est pas définie dans le schéma d’impression), un PrintTicket objet de votre application construit avec ce document aura Unknown comme valeur de la OutputQuality propriété.

Bien que les PrintTicket classes et PrintCapabilities ne puissent pas être héritées, vous pouvez étendre le schéma d’impression pour reconnaître les fonctionnalités d’appareil d’impression qui ne sont pas prises en compte dans les PrintTicket classes ou PrintCapabilities . Pour plus d’informations , consultez Guide pratique pour étendre le schéma d’impression et créer de nouvelles classes système d’impression.

Notes on OutputQuality.Photographic

La valeur photographique produit des documents avec une qualité de sortie élevée. La production de documents avec une meilleure qualité de sortie nécessite des fichiers spouleur d’impression plus volumineux et des temps d’attente plus longs. Si ces effets secondaires sont indésirables, vous pouvez utiliser la valeur High à la place.

S’applique à

Voir aussi

• PrintCapabilities
• PrintTicket