PrintTicketConverter.ConvertPrintTicketToDevMode Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Converts the specified PrintTicket to an unmanaged DEVMODE structure.
Overloads
| ConvertPrintTicketToDevMode(PrintTicket, BaseDevModeType) |
Converts the specified managed PrintTicket to an unmanaged DEVMODE structure that is based on the DEVMODE structure identified by the BaseDevModeType. |
| ConvertPrintTicketToDevMode(PrintTicket, BaseDevModeType, PrintTicketScope) |
Converts the specified managed code PrintTicket with the specified scope, into an unmanaged DEVMODE structure that is based on the DEVMODE structure identified by the BaseDevModeType. |
ConvertPrintTicketToDevMode(PrintTicket, BaseDevModeType)
Converts the specified managed PrintTicket to an unmanaged DEVMODE structure that is based on the DEVMODE structure identified by the BaseDevModeType.
public:
cli::array <System::Byte> ^ ConvertPrintTicketToDevMode(System::Printing::PrintTicket ^ printTicket, System::Printing::Interop::BaseDevModeType baseType);public byte[] ConvertPrintTicketToDevMode (System.Printing.PrintTicket printTicket, System.Printing.Interop.BaseDevModeType baseType);member this.ConvertPrintTicketToDevMode : System.Printing.PrintTicket * System.Printing.Interop.BaseDevModeType -> byte[]Public Function ConvertPrintTicketToDevMode (printTicket As PrintTicket, baseType As BaseDevModeType) As Byte()Parameters
- printTicket
- PrintTicket
The PrintTicket to convert.
- baseType
- BaseDevModeType
A value that identifies whether to use the user default or printer default DEVMODE as the base DEVMODE.
Returns
A Byte array that contains the new DEVMODE structure.
Exceptions
This PrintTicketConverter is already disposed.
The value of printTicket is null (Nothing in Visual Basic).
The content of printTicket is not well-formed.
The conversion failed.
The baseType is not a valid BaseDevModeType value.
Remarks
The scope of the PrintTicket parameter must be the entire print job.
This method does not validate the PrintTicket. To validate it, use MergeAndValidatePrintTicket.
For more information on the DEVMODE structure, see DEVMODE.
Applies to
ConvertPrintTicketToDevMode(PrintTicket, BaseDevModeType, PrintTicketScope)
Converts the specified managed code PrintTicket with the specified scope, into an unmanaged DEVMODE structure that is based on the DEVMODE structure identified by the BaseDevModeType.
public:
cli::array <System::Byte> ^ ConvertPrintTicketToDevMode(System::Printing::PrintTicket ^ printTicket, System::Printing::Interop::BaseDevModeType baseType, System::Printing::PrintTicketScope scope);public byte[] ConvertPrintTicketToDevMode (System.Printing.PrintTicket printTicket, System.Printing.Interop.BaseDevModeType baseType, System.Printing.PrintTicketScope scope);member this.ConvertPrintTicketToDevMode : System.Printing.PrintTicket * System.Printing.Interop.BaseDevModeType * System.Printing.PrintTicketScope -> byte[]Public Function ConvertPrintTicketToDevMode (printTicket As PrintTicket, baseType As BaseDevModeType, scope As PrintTicketScope) As Byte()Parameters
- printTicket
- PrintTicket
The PrintTicket to convert.
- baseType
- BaseDevModeType
A value that identifies whether to use the user default or printer default DEVMODE as the base DEVMODE.
- scope
- PrintTicketScope
A PrintTicketScope value that specifies whether the conversion of the PrintTicket should be done at the scope of a page, a document, or an entire print job.
Returns
A Byte buffer that represents the new DEVMODE structure.
Exceptions
This PrintTicketConverter is already disposed.
The value of printTicket is null (Nothing in Visual Basic).
The content of printTicket is not well-formed.
The conversion failed.
The baseType is not a valid BaseDevModeType value.
-or-
The scope is not a valid PrintTicketScope value.
Remarks
This method does not validate the PrintTicket. To validate it, use MergeAndValidatePrintTicket.
For more information on the DEVMODE structure, see DEVMODE.
