OutputQuality 열거형

정의

네임스페이스:

System.Printing

어셈블리:

ReachFramework.dll

인쇄 디바이스의 출력 품질 형식을 지정합니다.

public enum class OutputQuality

public enum OutputQuality

type OutputQuality = 

Public Enum OutputQuality

상속

Object

ValueType

Enum

OutputQuality

필드

Automatic	1	인쇄할 내용에 따라 품질 형식을 자동으로 선택합니다.
Draft	2	초안 품질입니다.
Fax	3	팩스 품질입니다.
High	4	고급 품질입니다.
Normal	5	정상 품질입니다.
Photographic	6	사진 품질입니다. 자세한 내용은 설명 섹션의 Notes on OutputQuality.Photographic을 참조하세요.
Text	7	텍스트 품질입니다.
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()

설명

이러한 목적을 위해 기본적으로이 형식의 값을 사용 합니다.

• 멤버로 합니다 OutputQualityCapability 속성은 컬렉션의 PrintCapabilities, 이러한 값에는 프린터가 지 원하는 출력 품질 형식을 나타냅니다.

• 값으로는 OutputQuality 의 속성을 PrintTicket, 특정 품질을 생성 하는 프린터 직접 실행 합니다.

합니다 Unknown 의 속성에서 사용 되지 않았습니다. PrintCapabilities 개체입니다.

설정할 수 없습니다는 PrintTicket 속성을 Unknown입니다. 다른 경우 PrintTicket 생성을 PrintTicket 문서가 인식할 수 없는 옵션으로 출력 품질 기능을 설정 하는 (에 정의 되지 않은 옵션 이므로 Print Schema)에 PrintTicket 문서를 사용 하 여 생성 된 애플리케이션에서 개체에 포함 됩니다 Unknown 값으로는 OutputQuality 속성입니다.

하지만 합니다 PrintTicket 및 PrintCapabilities 클래스를 상속할 수 없습니다, 확장할 수 있습니다는 인쇄 스키마 에서 처리 하지 않은 인쇄 디바이스 기능을 인식 하는 PrintTicket 또는 PrintCapabilities 클래스. 자세한 내용은 방법: 인쇄 스키마 확장 및 새 인쇄 시스템 클래스 만들기를 참조하세요.

Notes on OutputQuality.Photographic

사진 값은 높은 출력 품질을 가진 문서를 생성합니다. 더 나은 출력 품질을 사용 하 여 문서를 생성 합니다. 더 큰 인쇄 스풀러 파일 및 긴 대기 시간이 필요 합니다. 이러한 부작용이 바람직하지 않은 경우 높은 값을 대신 사용할 수 있습니다.

추가 정보

• PrintCapabilities
• PrintTicket