PrintTaskOptions Classe

Référence

Définition

Espace de noms:: Windows.Graphics.Printing

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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: ContractVersionAttribute MarshalingBehaviorAttribute

Implémente: IPrintTaskOptionsCore IPrintTaskOptionsCoreProperties IPrintTaskOptionsCoreUIConfiguration

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 à

Share via