Condividi tramite


PrintTaskOptions Classe

Definizione

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
Implementazioni

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.

Si applica a

Vedi anche