OutputQuality Wyliczenie

Odwołanie

Definicja

Przestrzeń nazw:: System.Printing

Zestaw:: ReachFramework.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Określa typy jakości danych wyjściowych dla urządzenia wydruku.

public enum class OutputQuality

public enum OutputQuality

type OutputQuality =

Public Enum OutputQuality

Dziedziczenie: Object

ValueType

Enum
OutputQuality

Pola

Nazwa	Wartość	Opis
Automatic	1	Automatycznie wybiera typ jakości oparty na zawartości zadania drukowania.
Draft	2	Jakość wersji roboczej.
Fax	3	Jakość faksu.
High	4	Wyższa niż normalna jakość.
Normal	5	Normalna jakość.
Photographic	6	Jakość fotograficzna. Aby uzyskać więcej informacji, zobacz Uwagi dotyczące wartości OutputQuality.Photographic w sekcji Uwagi.
Text	7	Jakość tekstu.
Unknown	0	Funkcja (której opcje są reprezentowane przez tę wyliczenie) jest ustawiona na opcję niezdefiniową w schemacie wydruku.

Przykłady

W poniższym przykładzie pokazano, jak przetestować możliwości drukarki i skonfigurować zadanie drukowania w celu ich wykorzystania. .

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

Uwagi

Użyj wartości tego typu głównie w następujących celach:

Jako członkowie OutputQualityCapability kolekcji, która jest właściwością PrintCapabilities, te wartości wskazują typy jakości danych wyjściowych, które obsługuje drukarka.
Jako wartość OutputQuality właściwości elementu PrintTicket, kierują drukarkę do produkcji określonej jakości.

Wartość Unknown nigdy nie jest używana we właściwościach PrintCapabilities obiektów.

Nigdy nie należy ustawiać PrintTicket właściwości na Unknown. Jeśli inna PrintTicket aplikacja produkująca utworzyła dokument PrintTicket , który ustawia funkcję jakości danych wyjściowych na nierozpoznaną opcję (czyli opcję, która nie jest zdefiniowana w schemacie wydruku), to PrintTicket obiekt w aplikacji, który jest skonstruowany z tym dokumentem, będzie miał Unknown jako wartość OutputQuality właściwości.

PrintTicket Mimo że klasy i PrintCapabilities nie mogą być dziedziczone, można rozszerzyć schemat wydruku, aby rozpoznawać funkcje urządzeń wydruku, które nie są uwzględniane w PrintTicket klasach lubPrintCapabilities. Aby uzyskać więcej informacji, zobacz How to: Extend the Print Schema and Create New Print System Classes (Instrukcje: rozszerzanie schematu wydruku) i Create New Print System Classes (Tworzenie nowych klas systemu drukowania).

Uwagi dotyczące pliku OutputQuality.Photographic

Wartość fotograficzna generuje dokumenty o wysokiej jakości danych wyjściowych. Tworzenie dokumentów o lepszej jakości danych wyjściowych wymaga większych plików buforu wydruku i dłuższych czasów oczekiwania. Jeśli te działania niepożądane są niepożądane, możesz zamiast tego użyć wartości High.

Dotyczy

Produkt	Wersje
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Udostępnij za pośrednictwem