PrintTaskOptions Classe

Définition

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

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

Propriétés

Méthodes

S’applique à

Voir aussi

• PrintColorMode
• PrintMediaSize
• StandardPrintTaskOptions