Partager via


PrintTaskOptions Classe

Définition

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

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
Héritage
Object Platform::Object IInspectable PrintTaskOptions
Attributs
Implémente

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

La classe PrintTaskOptions permet d’accéder aux différentes valeurs qui définissent la façon dont le contenu de la tâche d’impression doit être mis en forme 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 des options à afficher dans la fenêtre d’impression.

Bien que chaque option dans PrintTaskOptions, par exemple MediaSize ou MediaType, ait 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 qui est affectée à l’option par la cible d’impression. Lorsque cette valeur est récupérée via un accès à une propriété, cela indique que la cible d’impression n’a pas encore déterminé la valeur réelle de cette option. Lorsque vous définissez la valeur par défaut d’une option particulière, elle indique à la cible d’impression qu’elle doit utiliser la valeur par défaut qu’elle a pour cette option. S’il n’existe aucune valeur par défaut pour cette option, la valeur de l’option est inchangée.

Une option peut également signaler 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 renvoie une valeur NotAvailable , cela indique que la cible d’impression ne prend pas en charge la fonctionnalité duplex. Il n’est pas possible de définir une option sur 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 que 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 pour lier le document qui n’est pas l’une des valeurs standard. Dans ce cas, une requête de propriété sur l’option Binding retourne la valeur PrinterCustom . Les tailles de sortie personnalisées sont également représentées sous forme de 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 renvoie un vecteur contenant 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 le réorganisation des options sont répercutées dans la fenêtre d’impression. Si une cible d’impression particulière ne prend pas en charge une option, l’option ne s’affiche pas pour l’utilisateur. Pour connaître les noms des options standard, consultez StandardPrintTaskOptions.

Voici un extrait de code que vous pouvez utiliser, par exemple, pour définir la sortie imprimée en couleur, ainsi que pour définir la taille du média sur lequel elle peut être imprimée. L’objet PrintTaskOptions est accessible via la propriété PrintTask.Options .

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

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

Pour plus d’informations sur les valeurs autorisées pour ces options de tâche d’impression, consultez PrintColorMode et PrintMediaSize.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1607 14393 Limitrophes
1607 14393 GetPagePrintTicket
1803 17134 CustomPageRanges
1803 17134 PageRangeOptions

Propriétés

Binding

Obtient ou définit l’option de liaison pour la tâche d’impression.

Bordering

Obtient ou définit l’option de bordure pour la tâche d’impression.

Collation

Obtient ou définit l’option de classement des tâches d’impression.

ColorMode

Obtient ou définit l’option de mode de couleur de la tâche d’impression.

CustomPageRanges

Obtient les options de plage de pages personnalisées pour la tâche d’impression.

DisplayedOptions

Obtient la liste des options affichées pour l’expérience d’impression.

Duplex

Obtient ou définit l’option duplex de la tâche d’impression.

HolePunch

Obtient ou définit l’option de perforateur de trou de la tâche d’impression.

MaxCopies

Obtient le nombre maximal de copies prises en charge pour la tâche d’impression.

MediaSize

Obtient ou définit l’option de taille du média de la tâche d’impression.

MediaType

Obtient ou définit l’option de type de média pour la tâche d’impression.

MinCopies

Obtient le nombre minimal de copies autorisées pour la tâche d’impression.

NumberOfCopies

Obtient ou définit la valeur du nombre de copies pour la tâche d’impression.

Orientation

Obtient ou définit l’option d’orientation pour la tâche d’impression.

PageRangeOptions

Obtient les options de plage de pages pour la tâche d’impression.

PrintQuality

Obtient ou définit l’option de qualité d’impression pour la tâche d’impression.

Staple

Obtient ou définit l’option d’agrafe pour la tâche d’impression.

Méthodes

GetPageDescription(UInt32)

Récupère les dimensions physiques de la page imprimée.

GetPagePrintTicket(PrintPageInfo)

Récupère les dimensions physiques et les données de mise en forme d’une page imprimée.

S’applique à

Voir aussi