Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
Original file line number Diff line number Diff line change
Expand Up @@ -179,7 +179,7 @@
## Remarks
The <xref:System.Printing.IndexedProperties.PrintProperty.Name> property of `attributeValue` becomes the <xref:System.Collections.DictionaryEntry.Key> property of the new <xref:System.Collections.DictionaryEntry>. The <xref:System.Printing.IndexedProperties.PrintProperty> as a whole becomes the <xref:System.Collections.DictionaryEntry.Value> property of the new <xref:System.Collections.DictionaryEntry>.

For another way to add an entry to the dictionary, see <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.SetProperty%2A>.
For another way to add an entry to the dictionary, see <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.SetProperty*>.



Expand Down Expand Up @@ -243,7 +243,7 @@
Call <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.Dispose> when you are finished using the <xref:System.Printing.IndexedProperties.PrintPropertyDictionary>. The <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.Dispose> method leaves the <xref:System.Printing.IndexedProperties.PrintPropertyDictionary> in an unusable state. After calling <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.Dispose>, you must release all references to the <xref:System.Printing.IndexedProperties.PrintPropertyDictionary> so that the garbage collector can reclaim the memory that the <xref:System.Printing.IndexedProperties.PrintPropertyDictionary> was occupying. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged) and [Implementing a Dispose Method](/dotnet/standard/garbage-collection/implementing-dispose).

> [!NOTE]
> Always call <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.Dispose> before you release your last reference to the <xref:System.Printing.IndexedProperties.PrintPropertyDictionary>. Otherwise, the resources that it is using will not be freed until the garbage collector calls the <xref:System.Object.Finalize%2A> method of the <xref:System.Printing.IndexedProperties.PrintPropertyDictionary> object.
> Always call <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.Dispose> before you release your last reference to the <xref:System.Printing.IndexedProperties.PrintPropertyDictionary>. Otherwise, the resources that it is using will not be freed until the garbage collector calls the <xref:System.Object.Finalize*> method of the <xref:System.Printing.IndexedProperties.PrintPropertyDictionary> object.

]]></format>
</remarks>
Expand Down Expand Up @@ -291,7 +291,7 @@
<format type="text/markdown"><![CDATA[

## Remarks
This method is called by the public <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.Dispose> method and the <xref:System.Object.Finalize> method, if it has been overridden. <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.Dispose> invokes the protected <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.Dispose%28System.Boolean%29> method with the unnamed Boolean parameter set to `true`. `Finalize` invokes <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.Dispose%28System.Boolean%29> with the parameter set to `false`.
This method is called by the public <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.Dispose> method and the <xref:System.Object.Finalize> method, if it has been overridden. <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.Dispose> invokes the protected <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.Dispose(System.Boolean)> method with the unnamed Boolean parameter set to `true`. `Finalize` invokes <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.Dispose(System.Boolean)> with the parameter set to `false`.

When the Boolean parameter is `true`, this method releases all the resources that are held by any managed objects that this <xref:System.Printing.IndexedProperties.PrintPropertyDictionary> references. This method invokes the `Dispose()` method of each referenced object.

Expand Down
10 changes: 5 additions & 5 deletions xml/System.Printing.Interop/BaseDevModeType.xml
Original file line number Diff line number Diff line change
Expand Up @@ -29,11 +29,11 @@
<Docs>
<summary>Specifies the type of default <see href="https://learn.microsoft.com/windows/win32/api/wingdi/ns-wingdi-devmodea">DEVMODE</see> structure to use as the base <see href="https://learn.microsoft.com/windows/win32/api/wingdi/ns-wingdi-devmodea">DEVMODE</see> for conversions of managed <see cref="T:System.Printing.PrintTicket" /> objects to unmanaged <see href="https://learn.microsoft.com/windows/win32/api/wingdi/ns-wingdi-devmodea">DEVMODE</see> structures.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
Use a value of this enumeration primarily as a parameter in the <xref:System.Printing.Interop.PrintTicketConverter.ConvertPrintTicketToDevMode%2A> method.
<format type="text/markdown"><![CDATA[

## Remarks
Use a value of this enumeration primarily as a parameter in the <xref:System.Printing.Interop.PrintTicketConverter.ConvertPrintTicketToDevMode*> method.

]]></format>
</remarks>
</Docs>
Expand Down
10 changes: 5 additions & 5 deletions xml/System.Printing.Interop/PrintTicketConverter.xml
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@
<format type="text/markdown"><![CDATA[

## Remarks
None of the methods of this class will validate the <xref:System.Printing.PrintTicket>. To validate it, use <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket%2A>.
None of the methods of this class will validate the <xref:System.Printing.PrintTicket>. To validate it, use <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket*>.

]]></format>
</remarks>
Expand Down Expand Up @@ -140,7 +140,7 @@

The scope of the returned <xref:System.Printing.PrintTicket> is the entire print job.

This method does not validate the <xref:System.Printing.PrintTicket>. To validate it, use <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket%2A>.
This method does not validate the <xref:System.Printing.PrintTicket>. To validate it, use <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket*>.

]]></format>
</remarks>
Expand Down Expand Up @@ -186,7 +186,7 @@
<format type="text/markdown"><![CDATA[

## Remarks
This method does not validate the <xref:System.Printing.PrintTicket>. To validate it, use <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket%2A>.
This method does not validate the <xref:System.Printing.PrintTicket>. To validate it, use <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket*>.

For more information on the DEVMODE structure, see [DEVMODE](/windows/win32/api/wingdi/ns-wingdi-devmodea).

Expand Down Expand Up @@ -252,7 +252,7 @@
## Remarks
The scope of the <xref:System.Printing.PrintTicket> parameter must be the entire print job.

This method does not validate the <xref:System.Printing.PrintTicket>. To validate it, use <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket%2A>.
This method does not validate the <xref:System.Printing.PrintTicket>. To validate it, use <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket*>.

For more information on the DEVMODE structure, see [DEVMODE](/windows/win32/api/wingdi/ns-wingdi-devmodea).

Expand Down Expand Up @@ -303,7 +303,7 @@
<format type="text/markdown"><![CDATA[

## Remarks
This method does not validate the <xref:System.Printing.PrintTicket>. To validate it, use <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket%2A>.
This method does not validate the <xref:System.Printing.PrintTicket>. To validate it, use <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket*>.

For more information on the DEVMODE structure, see [DEVMODE](/windows/win32/api/wingdi/ns-wingdi-devmodea).

Expand Down
2 changes: 1 addition & 1 deletion xml/System.Printing/Collation.xml
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@

Use the values of this type primarily for the following purposes.

- As members of the <xref:System.Printing.PrintCapabilities.CollationCapability%2A> collection, which is a property of <xref:System.Printing.PrintCapabilities>, these values indicate the type of output that the printer supports. (Many printers support both types.)
- As members of the <xref:System.Printing.PrintCapabilities.CollationCapability*> collection, which is a property of <xref:System.Printing.PrintCapabilities>, these values indicate the type of output that the printer supports. (Many printers support both types.)

- As the value of the <xref:System.Printing.PrintTicket.Collation> property of a <xref:System.Printing.PrintTicket>, the value instructs the printer whether to collate.

Expand Down
10 changes: 5 additions & 5 deletions xml/System.Printing/ConflictStatus.xml
Original file line number Diff line number Diff line change
Expand Up @@ -29,11 +29,11 @@
<Docs>
<summary>Specifies whether any changes were made to a merged <see cref="T:System.Printing.PrintTicket" /> to ensure a viable <see cref="T:System.Printing.PrintTicket" />.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
When the <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket%2A> method merges two <xref:System.Printing.PrintTicket> objects, the initial print ticket may request printing functions that the printer does not support. In such cases, the printer driver changes the non-viable settings to ensure that the final print ticket is viable. The <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket%2A> method uses this enumeration to report whether it had to make changes to ensure a viable print ticket.
<format type="text/markdown"><![CDATA[

## Remarks
When the <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket*> method merges two <xref:System.Printing.PrintTicket> objects, the initial print ticket may request printing functions that the printer does not support. In such cases, the printer driver changes the non-viable settings to ensure that the final print ticket is viable. The <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket*> method uses this enumeration to report whether it had to make changes to ensure a viable print ticket.

]]></format>
</remarks>
</Docs>
Expand Down
2 changes: 1 addition & 1 deletion xml/System.Printing/DeviceFontSubstitution.xml
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@

The values of this type are used primarily for these purposes:

- As members of the <xref:System.Printing.PrintCapabilities.DeviceFontSubstitutionCapability%2A> collection, a property of <xref:System.Printing.PrintCapabilities>, they represent the printer capabilities.
- As members of the <xref:System.Printing.PrintCapabilities.DeviceFontSubstitutionCapability*> collection, a property of <xref:System.Printing.PrintCapabilities>, they represent the printer capabilities.

- As the value of the <xref:System.Printing.PrintTicket.DeviceFontSubstitution> property of a <xref:System.Printing.PrintTicket>, they instruct the printer to enable or disable device font substitution for the print job.

Expand Down
2 changes: 1 addition & 1 deletion xml/System.Printing/Duplexing.xml
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
## Remarks
Use the values of this type primarily for these purposes:

- As members of the <xref:System.Printing.PrintCapabilities.DuplexingCapability%2A> collection, which is a property of <xref:System.Printing.PrintCapabilities>, these values indicate the kinds of one-sided and two-sided printing that the printer supports.
- As members of the <xref:System.Printing.PrintCapabilities.DuplexingCapability*> collection, which is a property of <xref:System.Printing.PrintCapabilities>, these values indicate the kinds of one-sided and two-sided printing that the printer supports.

- As the value of the <xref:System.Printing.PrintTicket.Duplexing> property of a <xref:System.Printing.PrintTicket>, they direct the printer to use one-sided printing or some kind of two-sided printing.

Expand Down
2 changes: 1 addition & 1 deletion xml/System.Printing/EnumeratedPrintQueueTypes.xml
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@
<format type="text/markdown"><![CDATA[

## Remarks
Use these values with the <xref:System.Printing.PrintServer.GetPrintQueues%2A> method to list subsets of available print queues.
Use these values with the <xref:System.Printing.PrintServer.GetPrintQueues*> method to list subsets of available print queues.

`PushedMachineConnection` and `PushedUserConnection` refer to policies that enable automated connection of machines and users to printers. See the section ["Deploying Printers to Users or Computers by Using Group Policy"](https://learn.microsoft.com/previous-versions/windows/it-pro/windows-server-2008-r2-and-2008/cc753109(v=ws.10)#to-deploy-printers-to-users-or-computers-by-using-group-policy) in the [Step-by-Step Guide for Print Management](https://learn.microsoft.com/previous-versions/windows/it-pro/windows-server-2008-r2-and-2008/cc753109(v=ws.10)).

Expand Down
2 changes: 1 addition & 1 deletion xml/System.Printing/InputBin.xml
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
## Remarks
The values of this type are used primarily for these purposes:

- As members of the <xref:System.Printing.PrintCapabilities.InputBinCapability%2A> collection, a property of <xref:System.Printing.PrintCapabilities>, they indicate the types of input bins that the printer supports.
- As members of the <xref:System.Printing.PrintCapabilities.InputBinCapability*> collection, a property of <xref:System.Printing.PrintCapabilities>, they indicate the types of input bins that the printer supports.

- As the value of the <xref:System.Printing.PrintTicket.InputBin> property of a <xref:System.Printing.PrintTicket>, they instruct the printer to use the specified bin.

Expand Down
Loading
Loading