Collation Перечисление

Определение

Пространство имен:

System.Printing

Сборка:

ReachFramework.dll

Указывает, разбирает ли принтер печатаемые листы по копиям, если он печатает несколько копий многостраничного задания печати.

C#

public enum Collation

Наследование

Object

ValueType

Enum

Collation

Поля

Имя	Значение	Описание
Collated	1	Вывод разбирается по копиям.
Uncollated	2	Вывод не разбирается по копиям.
Unknown	0	Функции (параметры которой представлены этим перечислением) присвоен параметр, который не определен в схеме печати.

Примеры

В следующем примере показано, как протестировать возможности принтера и настроить задание печати, чтобы воспользоваться ими. .

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()

Комментарии

Стандартный принтер обычно выполняет сортировку выходных данных, печатая каждую страницу первой копии, затем каждую страницу второй копии и т. д. Если стандартный принтер не выполняет сортировку, он печатает каждую копию первой страницы, затем каждую копию второй страницы и т. д.

Некоторые принтеры специально оснащены параметров сортировки. Последовательность печати для этих специально оснащенных принтеров может отличаться от стандартной печати; однако результат будет одинаковым: каждая копия многостраничного задания печати содержит все свои страницы в правильной последовательности без сортировки вручную.

Используйте значения этого типа в первую очередь для следующих целей.

• Как члены CollationCapability коллекции, которая является свойством PrintCapabilities, эти значения указывают тип выходных данных, поддерживаемых принтером. (Многие принтеры поддерживают оба типа.)

• В качестве значения Collation свойства PrintTicketобъекта значение указывает принтеру, следует ли выполнять сортировку.

Значение Unknown никогда не используется в свойствах PrintCapabilities объектов .

Никогда не следует присваивать свойству PrintTicket значение Unknown. Если какое-то другое PrintTicket создающее приложение создало документ PrintTicket , который задает для функции сортировки нераспознанный параметр сортировки, то PrintTicket объект в приложении, созданный с помощью этого документа, будет иметь значение Unknown в качестве значения Collation свойства .

Несмотря на PrintTicket то, что классы и PrintCapabilities нельзя наследовать, схему печати можно расширить для распознавания функций устройств печати, которые не учитываются в классах PrintTicket или PrintCapabilities . Дополнительные сведения см. в разделах Практическое руководство. Расширение схемы печати и Создание новых системных классов печати.

Применяется к

См. также раздел

• PrintCapabilities
• PrintTicket