PrintTaskOptions Classe
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.
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
- Attributs
- Implémente
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)
|
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.
Version de Windows | Version du SDK | Valeur ajoutée |
---|---|---|
1607 | 14393 | Limitrophes |
1607 | 14393 | GetPagePrintTicket |
1803 | 17134 | CustomPageRanges |
1803 | 17134 | PageRangeOptions |
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. |
Color |
Obtient ou définit l’option de mode de couleur de la tâche d’impression. |
Custom |
Obtient les options de plage de pages personnalisées pour la tâche d’impression. |
Displayed |
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. |
Hole |
Obtient ou définit l’option de perforateur de trou de la tâche d’impression. |
Max |
Obtient le nombre maximal de copies prises en charge pour la tâche d’impression. |
Media |
Obtient ou définit l’option de taille du média de la tâche d’impression. |
Media |
Obtient ou définit l’option de type de média pour la tâche d’impression. |
Min |
Obtient le nombre minimal de copies autorisées pour la tâche d’impression. |
Number |
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. |
Page |
Obtient les options de plage de pages pour la tâche d’impression. |
Print |
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. |
Get |
Récupère les dimensions physiques de la page imprimée. |
Get |
Récupère les dimensions physiques et les données de mise en forme d’une page imprimée. |