PrintTaskOptions, classe

PrintTaskOptions Class

Représente une collection de méthodes et propriétés pour gérer les options qui définissent la façon dont le contenu doit être imprimé.

Syntaxe


/* Pour plus d'informations sur la création ou l'accès à cet objet, consultez les notes. */

Attributs

[MarshalingBehavior(Agile)]
[Muse()]
[Version(0x06020000)]

Membres

PrintTaskOptionsClasse possède ces types de membres :

Méthodes

The PrintTaskOptions Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
GetPageDescription Retrieves the physical dimensions of the printed page.

 

Propriétés

Le PrintTaskOptionsClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

Binding

Lecture/écritureGets or sets the binding option for the print task.

Collation

Lecture/écritureGets or sets the collation option of the print tasks.

ColorMode

Lecture/écritureGets or sets the color mode option of the print task.

DisplayedOptions

En lecture seuleGets the list of options displayed for the print experience.

Duplex

Lecture/écritureGets or sets the duplex option of the print task.

HolePunch

Lecture/écritureGets or sets the hole punch option of the print task.

MaxCopies

En lecture seuleGets the maximum number of copies supported for the print task.

MediaSize

Lecture/écritureGets or sets the media size option of the print task.

MediaType

Lecture/écritureGets or sets the media type option for the print task.

MinCopies

En lecture seuleGets the minimum number of copies allowed for the print task.

NumberOfCopies

Lecture/écritureGets or sets the value for the number of copies for the print task.

Orientation

Lecture/écritureGets or sets the orientation option for the print task.

PrintQuality

Lecture/écritureGets or sets the print quality option for the print task.

Staple

Lecture/écritureGets or sets the staple option for the print task.

 

Remarques

La classe PrintTaskOptions permet d'accéder aux différentes valeurs qui définissent la manière dont le contenu est mis en forme dans la tâche d'impression pendant l'impression. L'objet PrintTaskOptions peut contenir des informations telles que la taille de la page imprimée, son orientation et le type de média sur lequel le contenu sera imprimé. En outre, l'objet PrintTaskOptions permet d'accéder à la liste d'options à afficher dans la fenêtre d'impression.

Alors que chaque option de PrintTaskOptions, par exemple MediaSize ou MediaType, possède un ensemble spécifique de valeurs prises en charge, toutes les options prennent en charge le même modèle général pour représenter certains cas courants. Les valeurs de cas courantes sont Default, NotAvailable et PrinterCustom.

Chaque option contient une valeur par défaut, et il s'agit de la valeur assignée à l'option par la cible d'impression. Lorsque cette valeur est récupérée via un accès à la propriété, ceci indique que la cible d'impression n'a pas encore déterminé la valeur réelle de cette option. Lorsque vous affectez la valeur par défaut à une option particulière, elle indique à la cible d'impression qu'elle doit utiliser la valeur par défaut de cette option. Si cette option ne possède pas de valeur par défaut, la valeur de l'option reste inchangée.

Une option peut également reporter une valeur NotAvailable. Cela indique que l'option spécifique n'est pas disponible pour la cible d'impression actuellement sélectionnée. Par exemple, si la propriété Duplex retourne une valeur NotAvailable, cela indique que la cible d'impression ne prend pas en charge la fonctionnalité recto verso. Il n'est pas possible d'affecter à une option la valeur NotAvailable.

La valeur finale commune à toutes les options est PrinterCustom. Cela indique que la cible d'impression prend en charge la fonctionnalité mais la sélection actuelle est personnalisée pour cette imprimante. Par exemple, une cible d'impression peut prendre en charge une méthode spéciale de liaison de document dont les valeurs ne sont pas standard. Dans ce cas, une requête de propriété sur l'option de liaison retourne la valeur PrinterCustom. Les tailles de sortie personnalisées sont également représentées comme des valeurs PrinterCustom mais les tailles physiques réelles sont toujours disponibles via la méthode GetPageDescription.

Une application peut également utiliser PrintTaskOptions pour personnaliser les options qui s'affichent dans la fenêtre d'impression. La propriété DisplayedOptions retourne un vecteur qui contient la liste des éléments d'option qui seront affichés. Les modifications apportées à cette liste par l'insertion, l'ajout, la suppression ou la réorganisation des options sont répercutées dans la fenêtre d'impression. Si une cible particulière d'impression ne prend pas en charge une option, l'option ne sera pas présentée à l'utilisateur. Pour les noms des options standard, consultez StandardPrintTaskOptions.

Voici un extrait de code JavaScript que vous pouvez utiliser, par exemple, pour définir la sortie imprimée en couleurs, et pour définir également la taille du support sur lequel elle peut être imprimée :


// Set output to color
printTaskOptions.colorMode = colorMode;

// Set the media size for printing
printTaskOptions.mediaSize = mediaSize;


Pour plus d'informations sur les valeurs autorisées pour ces options de travail d'impression, consultez PrintColorMode et PrintMediaSize.

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

Windows.Graphics.Printing
Windows::Graphics::Printing [C++]

Métadonnées

Windows.winmd

Voir aussi

PrintColorMode
PrintMediaSize
StandardPrintTaskOptions
Énumérations Windows.Graphics.Printing

 

 

Afficher:
© 2017 Microsoft