Collation 列挙型

リファレンス

定義

名前空間:: System.Printing

アセンブリ:: ReachFramework.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

プリンターで複数ページ印刷ジョブの複数コピーを印刷する場合に、部単位で印刷するかどうかを指定します。

public enum class Collation

public enum Collation

type Collation =

Public Enum Collation

継承: Object

ValueType

Enum
Collation

フィールド

Collated	1	部単位での印刷。
Uncollated	2	部単位でない印刷。
Unknown	0	機能 (オプションはこの列挙体によって表されます) が、印刷スキーマで定義されていないオプションに設定されます。

例

次の例は、プリンターの機能をテストし、それらを利用するように印刷ジョブを構成する方法を示しています。 .

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

   LocalPrintServer^ localPrintServer = gcnew 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
   {
      return nullptr;
   }
   // 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()

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

' ---------------------- GetPrintTicketFromPrinter -----------------------
''' <summary>
'''   Returns a PrintTicket based on the current default printer.</summary>
''' <returns>
'''   A PrintTicket for the current local default printer.</returns>
Private Function GetPrintTicketFromPrinter() As PrintTicket
    Dim printQueue As PrintQueue = Nothing

    Dim localPrintServer As New LocalPrintServer()

    ' Retrieving collection of local printer on user machine
    Dim localPrinterCollection As PrintQueueCollection = localPrintServer.GetPrintQueues()

    Dim localPrinterEnumerator As System.Collections.IEnumerator = localPrinterCollection.GetEnumerator()

    If localPrinterEnumerator.MoveNext() Then
        ' Get PrintQueue from first available printer
        printQueue = CType(localPrinterEnumerator.Current, PrintQueue)
    Else
        ' No printer exist, return null PrintTicket
        Return Nothing
    End If

    ' Get default PrintTicket from printer
    Dim printTicket As PrintTicket = printQueue.DefaultPrintTicket

    Dim printCapabilities As PrintCapabilities = printQueue.GetPrintCapabilities()

    ' Modify PrintTicket
    If printCapabilities.CollationCapability.Contains(Collation.Collated) Then
        printTicket.Collation = Collation.Collated
    End If

    If printCapabilities.DuplexingCapability.Contains(Duplexing.TwoSidedLongEdge) Then
        printTicket.Duplexing = Duplexing.TwoSidedLongEdge
    End If

    If printCapabilities.StaplingCapability.Contains(Stapling.StapleDualLeft) Then
        printTicket.Stapling = Stapling.StapleDualLeft
    End If

    Return printTicket
End Function ' end:GetPrintTicketFromPrinter()

注釈

標準プリンターでは、通常、最初のコピーのすべてのページ、2 番目のコピーのすべてのページなどを印刷して出力を照合します。標準プリンターが照合されない場合は、最初のページのすべてのコピー、2 番目のページのすべてのコピーなどが印刷されます。

一部のプリンターには、照合ビンが特別に装備されています。これらの特別に装備されたプリンタの印刷シーケンスは、標準プリンタのものと異なる場合があります。ただし、結果は同じです。複数ページ印刷ジョブの各コピーには、手動による並べ替えなしで適切な順序ですべてのページが含まれています。

この型の値は、主に次の目的で使用します。

プロパティPrintCapabilitiesであるコレクションのCollationCapabilityメンバーとして、これらの値はプリンターがサポートする出力の種類を示します。 (多くのプリンターでは両方の種類がサポートされています)。
この値は、a PrintTicketのCollationプロパティの値として、照合するかどうかをプリンターに指示します。

不明な 値は、オブジェクトのPrintCapabilitiesプロパティでは使用されません。

プロパティを [不明] に設定PrintTicketしないでください。照合順序機能を認識できない照合順序オプションに設定する PrintTicket ドキュメント を他PrintTicketの生成アプリケーションで作成した場合、PrintTicketそのドキュメントで構築されたアプリケーション内のオブジェクトは、プロパティのCollation値として Unknown になります。

クラスとPrintCapabilitiesクラスはPrintTicket継承できませんが、印刷スキーマを拡張して、クラスにPrintCapabilities含まれていない印刷デバイス機能をPrintTicket認識できます。詳細については、「方法: 印刷スキーマを拡張し、新しい印刷システムクラスを作成する」を参照してください。

適用対象

Collation 列挙型

定義

フィールド

例

注釈

適用対象

こちらもご覧ください

その他のリソース