PrintTaskOptions 클래스

정의

네임스페이스:

Windows.Graphics.Printing

콘텐츠를 인쇄하는 방법을 정의하는 옵션을 관리하기 위한 메서드 및 속성의 컬렉션을 나타냅니다.

public ref class PrintTaskOptions sealed : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PrintTaskOptions final : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PrintTaskOptions : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration

Public NotInheritable Class PrintTaskOptions
Implements IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration

상속

Object Platform::Object IInspectable PrintTaskOptions

특성

ContractVersionAttribute MarshalingBehaviorAttribute

구현

IPrintTaskOptionsCore IPrintTaskOptionsCoreProperties IPrintTaskOptionsCoreUIConfiguration

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

PrintTaskOptions 클래스는 인쇄 중에 인쇄 작업의 콘텐츠 형식을 지정하는 방법을 정의하는 다양한 값에 액세스할 수 있습니다. PrintTaskOptions 개체에는 인쇄된 페이지의 크기, 방향 및 콘텐츠가 인쇄될 미디어 유형과 같은 정보가 포함될 수 있습니다. 또한 PrintTaskOptions 개체는 인쇄 창에 표시할 옵션 목록에 액세스할 수 있습니다.

PrintTaskOptions의 각 옵션(예: MediaSize 또는 MediaType)에는 지원되는 특정 값 집합이 있지만 모든 옵션은 몇 가지 일반적인 사례를 나타내는 동일한 일반 패턴을 지원합니다. 일반적인 사례 값은 Default, NotAvailable 및 PrinterCustom입니다.

각 옵션은 기본값을 포함하며 인쇄 대상에 의해 옵션에 할당된 값입니다. 속성 액세스를 통해 이 값을 검색할 때 인쇄 대상에서 이 옵션의 실제 값을 아직 결정하지 못했음을 나타냅니다. 특정 옵션의 기본값을 설정하면 인쇄 대상에 해당 옵션에 대해 기본값을 사용해야 했음을 나타냅니다. 해당 옵션에 대한 기본값이 없으면 옵션 값이 변경되지 않습니다.

옵션은 NotAvailable 값을 보고할 수도 있습니다. 이는 현재 선택한 인쇄 대상에 대해 특정 옵션을 사용할 수 없음을 나타냅니다. 예를 들어 Duplex 속성이 NotAvailable 값을 반환하는 경우 인쇄 대상이 이중 기능을 지원하지 않음을 나타냅니다. 옵션을 NotAvailable 값으로 설정할 수 없습니다.

모든 옵션에 공통적인 최종 값은 PrinterCustom입니다. 이는 인쇄 대상이 기능을 지원하지만 현재 선택 영역이 이 프린터에 대한 사용자 지정임을 나타냅니다. 예를 들어 인쇄 대상은 표준 값 중 하나가 아닌 문서를 바인딩하는 특수 메서드를 지원할 수 있습니다. 이 경우 바인딩 옵션의 속성 쿼리는 PrinterCustom 값을 반환합니다. 사용자 지정 출력 크기도 PrinterCustom 값으로 표시되지만 실제 실제 크기는 GetPageDescription 메서드를 통해 계속 사용할 수 있습니다.

또한 앱은 PrintTaskOptions를 사용하여 인쇄 창에 표시되는 옵션을 사용자 지정할 수도 있습니다. DisplayedOptions 속성은 표시될 옵션 항목 목록이 포함된 벡터를 반환합니다. 옵션을 삽입, 추가, 제거 또는 다시 정렬하여 이 목록을 수정하면 인쇄 창에 반영됩니다. 특정 인쇄 대상에서 옵션을 지원하지 않는 경우 옵션이 사용자에게 표시되지 않습니다. 표준 옵션의 이름은 StandardPrintTaskOptions를 참조하세요.

다음은 인쇄된 출력을 색으로 설정하고 인쇄할 수 있는 미디어의 크기를 설정하는 데 사용할 수 있는 코드 조각입니다. 개체는 PrintTaskOptionsPrintTask.Options 속성을 통해 액세스됩니다.

// Set output to color
printTask.Options.ColorMode = PrintColorMode.Color;

// Set the media size for printing
printTask.Options.MediaSize = PrintMediaSize.NorthAmericaLegal;

이러한 인쇄 작업 옵션에 허용되는 값에 대한 자세한 내용은 PrintColorMode 및 PrintMediaSize를 참조하세요.

버전 기록

Windows 버전	SDK 버전	추가된 값
1607	14393	접경
1607	14393	GetPagePrintTicket
1803	17134	CustomPageRanges
1803	17134	PageRangeOptions

속성

Binding	인쇄 작업에 대한 바인딩 옵션을 가져오거나 설정합니다.
Bordering	인쇄 작업에 대한 테두리 옵션을 가져오거나 설정합니다.
Collation	인쇄 작업의 데이터 정렬 옵션을 가져오거나 설정합니다.
ColorMode	인쇄 작업의 색 모드 옵션을 가져오거나 설정합니다.
CustomPageRanges	인쇄 작업에 대한 사용자 지정 페이지 범위 옵션을 가져옵니다.
DisplayedOptions	인쇄 환경에 대해 표시되는 옵션 목록을 가져옵니다.
Duplex	인쇄 작업의 이중 옵션을 가져오거나 설정합니다.
HolePunch	인쇄 작업의 구멍 펀치 옵션을 가져오거나 설정합니다.
MaxCopies	인쇄 작업에 지원되는 최대 복사본 수를 가져옵니다.
MediaSize	인쇄 작업의 미디어 크기 옵션을 가져오거나 설정합니다.
MediaType	인쇄 작업에 대한 미디어 유형 옵션을 가져오거나 설정합니다.
MinCopies	인쇄 작업에 허용되는 최소 복사본 수를 가져옵니다.
NumberOfCopies	인쇄 작업의 복사본 수 값을 가져오거나 설정합니다.
Orientation	인쇄 작업의 방향 옵션을 가져오거나 설정합니다.
PageRangeOptions	인쇄 작업에 대한 페이지 범위 옵션을 가져옵니다.
PrintQuality	인쇄 작업의 인쇄 품질 옵션을 가져오거나 설정합니다.
Staple	인쇄 작업의 스테이플 옵션을 가져오거나 설정합니다.

메서드

GetPageDescription(UInt32)	인쇄된 페이지의 실제 크기를 검색합니다.
GetPagePrintTicket(PrintPageInfo)	인쇄된 페이지의 실제 차원 및 서식 데이터를 검색합니다.

추가 정보

• PrintColorMode
• PrintMediaSize
• StandardPrintTaskOptions