OutputQuality 列舉

定義

命名空間:

System.Printing

組件:

ReachFramework.dll

指定列印裝置的輸出品質類型。

C#

public enum OutputQuality

繼承

Object

ValueType

Enum

OutputQuality

欄位

名稱	值	Description
Automatic	1	自動根據列印工作的內容選取品質類型。
Draft	2	草稿品質。
Fax	3	傳真品質。
High	4	高於普通品質。
Normal	5	普通品質。
Photographic	6	相片品質。 如需詳細資訊，請參閱＜備註＞一節中的 OutputQuality.Photographic 注意事項。
Text	7	文字品質。
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()

備註

針對下列用途，請使用此類型的值：

• 做為 集合的成員 OutputQualityCapability ，這是的 PrintCapabilities屬性，這些值表示列印機支援的輸出質量類型。

• 做為 的 OutputQualityPrintTicket屬性值，它們會引導印表機產生特定品質。

值 Unknown 永遠不會用在 對象的屬性 PrintCapabilities 中。

您不應該將 PrintTicket 屬性設定為 Unknown。 如果某些其他 PrintTicket 產生應用程式已建立 PrintTicket 檔案 ，將輸出品質功能設定為無法辨識的選項 (，也就是在 列印架構) 中未定義的選項，則 PrintTicket 以該檔建構的應用程式中的物件將會具有 Unknown 屬性的值 OutputQuality 。

PrintTicket雖然 無法繼承 和 PrintCapabilities 類別，但您可以擴充列印架構，以辨識未在 或 PrintCapabilities 類別中考慮的PrintTicket列印裝置功能。 如需詳細資訊，請參閱 如何：擴充列印架構和建立新的列印系統類別。

Notes on OutputQuality.Photographic

相片值會產生高輸出品質的檔。 產生具有較佳輸出品質的檔需要較大的列印多任務緩衝處理程式檔案和較長的等候時間。 如果不需要這些副作用，您可以改用 High 值。

適用於

另請參閱

• PrintCapabilities
• PrintTicket