PrintTaskOptions 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
콘텐츠를 인쇄하는 방법을 정의하는 옵션을 관리하기 위한 메서드 및 속성의 컬렉션을 나타냅니다.
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, IPrintTaskOptionsCoreUIConfigurationPublic NotInheritable Class PrintTaskOptions
Implements 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) |
인쇄된 페이지의 실제 차원 및 서식 데이터를 검색합니다. |