OutputQuality 列挙型

定義

名前空間:

System.Printing

アセンブリ:

ReachFramework.dll

印刷デバイス用の出力品質の種類を指定します。

C#

public enum OutputQuality

継承

Object

ValueType

Enum

OutputQuality

フィールド

名前	値	説明
Automatic	1	印刷ジョブの内容に基づく品質の種類を自動的に選択します。
Draft	2	下書き品質。
Fax	3	FAX 品質。
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()

注釈

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

• のプロパティである コレクションのOutputQualityCapabilityPrintCapabilitiesメンバーとして、これらの値はプリンターがサポートする出力品質の種類を示します。

• の プロパティの OutputQuality 値として、特定の PrintTicket品質を生成するようにプリンターに指示します。

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

プロパティを にUnknown設定PrintTicketしないでください。 出力品質機能を認識できないオプション (つまり、印刷スキーマPrintTicketで定義されていないオプション) に設定する PrintTicket ドキュメントを他PrintTicketの生成アプリケーションで作成した場合、そのドキュメントで構築されたアプリケーション内のオブジェクトは、 プロパティのOutputQuality値としてを持ちますUnknown。

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

Notes on OutputQuality.Photographic

写真の値は、高い出力品質のドキュメントを生成します。 より優れた出力品質のドキュメントを作成するには、より大きな印刷スプーラー ファイルと長い待機時間が必要です。 これらの副作用が望ましくない場合は、代わりに High 値を使用できます。

適用対象

こちらもご覧ください

• PrintCapabilities
• PrintTicket