|
129 | 129 | ## Remarks |
130 | 130 | <xref:System.Printing.PrintQueue> constructors that do not include a <xref:System.Printing.PrintSystemDesiredAccess> parameter default to <xref:System.Printing.PrintSystemDesiredAccess.UsePrinter> access. |
131 | 131 |
|
132 | | - The [Print Schema](/windows/win32/printdocs/printschema) version released with Windows Vista is "1". |
| 132 | + The [Print Schema](https://learn.microsoft.com/windows/win32/printdocs/printschema) version released with Windows Vista is "1". |
133 | 133 |
|
134 | 134 | ]]></format> |
135 | 135 | </remarks> |
|
306 | 306 | <format type="text/markdown">< version released with Windows Vista is "1". |
| 309 | + The [Print Schema](https://learn.microsoft.com/windows/win32/printdocs/printschema) version released with Windows Vista is "1". |
310 | 310 |
|
311 | 311 | ]]></format> |
312 | 312 | </remarks> |
|
634 | 634 | <format type="text/markdown"><. If it is not, the <xref:System.Printing.PrintQueue.AddJob%28System.String%2CSystem.String%2CSystem.Boolean%29> method throws an exception. |
| 637 | + If `fastCopy` is `true`, then the printer must be an [Printing Overview](https://learn.microsoft.com/dotnet/framework/wpf/advanced/printing-overview). If it is not, the <xref:System.Printing.PrintQueue.AddJob%28System.String%2CSystem.String%2CSystem.Boolean%29> method throws an exception. |
638 | 638 |
|
639 | 639 | If `fastCopy` is `false`, then it is not necessary to use an XPSDrv printer. The XPS file being added to the queue is converted to the printer's page description language, such as PCL or Postscript. However, this kind of printing makes a call to Component Object Model (COM). The call to COM requires that the calling thread have a single-threaded apartment (<xref:System.Threading.ApartmentState.STA>) instead of multiple-threaded apartment (<xref:System.Threading.ApartmentState.MTA>) which is the default in Microsoft .NET 2.0 and later. (For more on threading and apartment states, see [Managed and Unmanaged Threading](https://msdn.microsoft.com/library/db425c20-4b2f-4433-bf96-76071c7881e5), and <xref:System.Threading.ApartmentState>.) There are two ways of doing this: |
640 | 640 |
|
|
768 | 768 | <format type="text/markdown">< version released with Windows Vista is 1. |
| 771 | + The [Print Schema](https://learn.microsoft.com/windows/win32/printdocs/printschema) version released with Windows Vista is 1. |
772 | 772 |
|
773 | 773 | ]]></format> |
774 | 774 | </remarks> |
|
1528 | 1528 | <format type="text/markdown">< for more information on constraints. |
| 1531 | + The <xref:System.Printing.PrintTicket> parameter is used as the basis on which to construct the <xref:System.Printing.PrintCapabilities> object. For example, suppose the printer supported only media types A and B from input bin 1 and it only supported media type C from input bin 2. If the `printTicket` parameter specified input bin 1, then the <xref:System.Printing.PrintCapabilities> object that is returned would include all three media types, but it would report type C as "constrained." If the `printTicket` parameter specified input bin 2, then the <xref:System.Printing.PrintCapabilities> object that is returned would include all three media types, but it would report types A and B as "constrained." See the [Print Schema](https://learn.microsoft.com/windows/win32/printdocs/printschema) for more information on constraints. |
1532 | 1532 |
|
1533 | 1533 | If `printTicket` is `null`, the <xref:System.Printing.PrintQueue.UserPrintTicket%2A> is used. |
1534 | 1534 |
|
|
1550 | 1550 | <format type="text/markdown">< system. |
| 1553 | + The XML schema used is called "PrintCapabilities," a part of the [Print Schema](https://learn.microsoft.com/windows/win32/printdocs/printschema) system. |
1554 | 1554 |
|
1555 | 1555 | ]]></format> |
1556 | 1556 | </remarks> |
|
1629 | 1629 | <format type="text/markdown">< for more information on constraints. |
| 1632 | + The <xref:System.Printing.PrintTicket> parameter is used as the basis on which to construct the print capabilities XML. For example, suppose the printer supported only media types A and B from input bin 1 and it only supported media type C from input bin 2. If the `printTicket` parameter specified input bin 1, then the print capabilities XML that is returned would include all three media types, but it would report type C as "constrained." If the `printTicket` parameter specified input bin 2, then the print capabilities XML that is returned would include all three media types, but it would report types A and B as "constrained." See the [Print Schema](https://learn.microsoft.com/windows/win32/printdocs/printschema) for more information on constraints. |
1633 | 1633 |
|
1634 | 1634 | If `printTicket` is `null`, the <xref:System.Printing.PrintQueue.UserPrintTicket%2A> is used. |
1635 | 1635 |
|
|
3120 | 3120 | <format type="text/markdown">< released with Windows Vista is 1. |
| 3123 | + The version of the [Print Schema](https://learn.microsoft.com/windows/win32/printdocs/printschema) released with Windows Vista is 1. |
3124 | 3124 |
|
3125 | 3125 | ]]></format> |
3126 | 3126 | </remarks> |
|
3176 | 3176 | <format type="text/markdown"><. If either is invalid, an exception is thrown. |
| 3179 | + The method produces a viable print ticket; that is, a ticket that does not request printing features that the printer does not support. The method first validates the two input print tickets against the [Print Schema](https://learn.microsoft.com/windows/win32/printdocs/printschema). If either is invalid, an exception is thrown. |
3180 | 3180 |
|
3181 | 3181 | The two tickets are then merged. If they have different values for a particular property then the resulting merged ticket initially uses the value of the delta ticket. |
3182 | 3182 |
|
|
3245 | 3245 | <format type="text/markdown"><. If either is invalid, an exception is thrown. |
| 3248 | + The method produces a viable print ticket; that is, a ticket that does not request printing features that the printer does not support. The method first validates the two input print tickets against the [Print Schema](https://learn.microsoft.com/windows/win32/printdocs/printschema). If either is invalid, an exception is thrown. |
3249 | 3249 |
|
3250 | 3250 | The two tickets are then merged. If they have different values for a particular property then the resulting merged ticket initially uses the value of the delta ticket. |
3251 | 3251 |
|
|
3255 | 3255 |
|
3256 | 3256 | The `deltaPrintTicket` parameter can be `null`, in which case the `basePrintTicket` is validated, checked for viability, and returned, possibly with changes. |
3257 | 3257 |
|
3258 | | - If the `scope` is a job, then the print ticket returned in the <xref:System.Printing.ValidationResult> can include [Print Schema](/windows/win32/printdocs/printschema) parameters with Job, Document, and Page prefixes. If the `scope` is a document, then per-job settings in `deltaPrintTicket` are ignored, and the returned ticket can include parameters with Document and Page prefixes. If the `scope` is a page, then the per-job settings and the per-document settings in `deltaPrintTicket` are ignored, and the returned ticket can include parameters with only the Page prefix. |
| 3258 | + If the `scope` is a job, then the print ticket returned in the <xref:System.Printing.ValidationResult> can include [Print Schema](https://learn.microsoft.com/windows/win32/printdocs/printschema) parameters with Job, Document, and Page prefixes. If the `scope` is a document, then per-job settings in `deltaPrintTicket` are ignored, and the returned ticket can include parameters with Document and Page prefixes. If the `scope` is a page, then the per-job settings and the per-document settings in `deltaPrintTicket` are ignored, and the returned ticket can include parameters with only the Page prefix. |
3259 | 3259 |
|
3260 | 3260 | ]]></format> |
3261 | 3261 | </remarks> |
|
0 commit comments