PrintTicket.Stapling Propriété

Définition

Espace de noms:

System.Printing

Assembly:

ReachFramework.dll

Obtient ou définit une valeur qui indique si, et où, une imprimante agrafe plusieurs pages.

C#

public System.Printing.Stapling? Stapling { get; set; }

Valeur de propriété

Nullable<Stapling>

Une valeur Stapling qui spécifie comment une imprimante agrafe la sortie.

Exceptions

ArgumentOutOfRangeException

Le code appelant a tenté d'affecter à la propriété une valeur qui n'est pas répertoriée dans l'énumération Stapling.

Exemples

L’exemple suivant montre comment utiliser cette propriété lors du test des fonctionnalités d’une imprimante et de la configuration d’un 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

Par exemple, une imprimante peut placer deux agrafes sur le bord gauche d’une feuille de papier, ou une agrafe dans le coin supérieur gauche.

Une null valeur pour cette propriété signifie que ce paramètre de fonctionnalité n’est pas spécifié. En outre, lorsque la valeur est null, les versions XML de ( PrintTicket voir SaveTo et GetXmlStream) ne contiennent aucun balisage pour cette fonctionnalité.

Cette propriété correspond au mot clé du JobStapleAllDocumentsschéma d’impression, et non à la DocumentStaple mot clé.

Vous pouvez tester les options que l’imprimante prend en charge à l’aide de la StaplingCapability propriété .

S’applique à