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。 這表示列印目標支援功能，但目前的選取範圍是此印表機的自訂專案。 例如，列印目標可能支援一種特殊方法來系結不是其中一個標準值的檔。 在此情況下，Binding 選項上的屬性查詢會傳回 PrinterCustom 值。 自訂輸出大小也會以 PrinterCustom 值表示，但實際實體大小仍可透過 GetPageDescription 方法使用。
應用程式也可以使用 PrintTaskOptions 來自訂出現在列印視窗中的選項。 DisplayedOptions屬性會傳回一個向量，其中包含將顯示的選項專案清單。 藉由插入、附加、移除或重新排序選項來修改此清單，將會反映在列印視窗中。 如果特定列印目標不支援選項，則不會向使用者顯示此選項。 如需標準選項的名稱，請參閱 StandardPrintTaskOptions。
以下是您可以使用的程式碼片段，例如，將列印的輸出設定為色彩，以及設定可列印的媒體大小。 物件 PrintTaskOptions 是透過 PrintTask.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) |
擷取列印頁面的實體維度和格式化資料。 |