PrintTaskOptions Classe

Definizione

Spazio dei nomi:

Windows.Graphics.Printing

Rappresenta una raccolta di metodi e proprietà per la gestione delle opzioni che definiscono la modalità di stampa del contenuto.

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

Ereditarietà

Object Platform::Object IInspectable PrintTaskOptions

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni

IPrintTaskOptionsCore IPrintTaskOptionsCoreProperties IPrintTaskOptionsCoreUIConfiguration

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

La classe PrintTaskOptions consente di accedere ai diversi valori che definiscono il modo in cui il contenuto dell'attività di stampa deve essere formattato durante la stampa. L'oggetto PrintTaskOptions può contenere informazioni come le dimensioni della pagina stampata, l'orientamento e il tipo di supporto in cui verrà stampato il contenuto. Oltre all'oggetto PrintTaskOptions, l'accesso all'elenco delle opzioni da visualizzare nella finestra di stampa.

Sebbene ogni opzione in PrintTaskOptions, ad esempio MediaSize o MediaType, abbia un set specifico di valori supportati, tutte le opzioni supportano lo stesso modello generale per rappresentare alcuni casi comuni. I valori di maiuscole e minuscole comuni sono Default, NotAvailable e PrinterCustom.

Ogni opzione contiene un valore predefinito ed è il valore assegnato all'opzione dalla destinazione di stampa. Quando questo valore viene recuperato tramite un accesso alle proprietà, è un'indicazione che la destinazione di stampa non ha ancora determinato il valore effettivo per questa opzione. Quando si imposta il valore predefinito per un'opzione specifica, indica alla destinazione di stampa che deve usare il valore predefinito che ha per tale opzione. Se non esiste alcun valore predefinito per tale opzione, il valore dell'opzione è invariato.

Un'opzione può anche segnalare un valore NotAvailable . Ciò indica che l'opzione specifica non è disponibile per la destinazione di stampa attualmente selezionata. Ad esempio, se la proprietà Duplex restituisce un valore NotAvailable , indica che la destinazione di stampa non supporta la funzionalità duplex. Non è possibile impostare un'opzione sul valore NotAvailable .

Il valore finale comune a tutte le opzioni è PrinterCustom. Ciò indica che la destinazione di stampa supporta la funzionalità, ma la selezione corrente è personalizzata per questa stampante. Ad esempio, una destinazione di stampa può supportare un metodo speciale per l'associazione del documento che non è uno dei valori standard. In questo caso, una query di proprietà sull'opzione Binding restituirà il valore PrinterCustom . Le dimensioni di output personalizzate verranno rappresentate anche come valori PrinterCustom , ma le dimensioni fisiche effettive saranno comunque disponibili tramite il metodo GetPageDescription .

Un'app può anche usare PrintTaskOptions per personalizzare le opzioni visualizzate nella finestra di stampa. La proprietà DisplayOptions restituisce un vettore contenente l'elenco di elementi dell'opzione che verranno visualizzati. Le modifiche apportate a questo elenco inserendo, accodando, rimuovendo o riordinando le opzioni verranno riflesse nella finestra di stampa. Se una determinata destinazione di stampa non supporta un'opzione, l'opzione non verrà visualizzata all'utente. Per i nomi delle opzioni standard, vedere StandardPrintTaskOptions.

Ecco un frammento di codice che è possibile usare, ad esempio, per impostare l'output stampato sul colore e anche per impostare le dimensioni del supporto su cui può essere stampato. L'oggetto PrintTaskOptions viene accessibile tramite la proprietà PrintTask.Options .

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

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

Per altre informazioni sui valori consentiti per queste opzioni di attività di stampa, vedere PrintColorMode e PrintMediaSize.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	Confinante con
1607	14393	GetPagePrintTicket
1803	17134	CustomPageRanges
1803	17134	PageRangeOptions

Proprietà

Binding	Ottiene o imposta l'opzione di associazione per l'attività di stampa.
Bordering	Ottiene o imposta l'opzione di bordo per l'attività di stampa.
Collation	Ottiene o imposta l'opzione di confronto delle attività di stampa.
ColorMode	Ottiene o imposta l'opzione modalità colore dell'attività di stampa.
CustomPageRanges	Ottiene le opzioni dell'intervallo di pagine personalizzate per l'attività di stampa.
DisplayedOptions	Ottiene l'elenco delle opzioni visualizzate per l'esperienza di stampa.
Duplex	Ottiene o imposta l'opzione duplex dell'attività di stampa.
HolePunch	Ottiene o imposta l'opzione di pugno del foro dell'attività di stampa.
MaxCopies	Ottiene il numero massimo di copie supportate per l'attività di stampa.
MediaSize	Ottiene o imposta l'opzione dimensioni supporti dell'attività di stampa.
MediaType	Ottiene o imposta l'opzione tipo di supporto per l'attività di stampa.
MinCopies	Ottiene il numero minimo di copie consentite per l'attività di stampa.
NumberOfCopies	Ottiene o imposta il valore per il numero di copie per l'attività di stampa.
Orientation	Ottiene o imposta l'opzione di orientamento per l'attività di stampa.
PageRangeOptions	Ottiene le opzioni dell'intervallo di pagine per l'attività di stampa.
PrintQuality	Ottiene o imposta l'opzione di qualità di stampa per l'attività di stampa.
Staple	Ottiene o imposta l'opzione di base per l'attività di stampa.

Metodi

GetPageDescription(UInt32)	Recupera le dimensioni fisiche della pagina stampata.
GetPagePrintTicket(PrintPageInfo)	Recupera le dimensioni fisiche e i dati di formattazione di una pagina stampata.

Vedi anche

• PrintColorMode
• PrintMediaSize
• StandardPrintTaskOptions