System.Drawing.Printing.PrinterSettings.GetHdevmode Method

Creates a handle to a DEVMODE structure that corresponds to the printer and the page settings specified through the pageSettings parameter.

Syntax

public IntPtr GetHdevmode (PageSettings pageSettings)

Parameters

pageSettings
The System.Drawing.Printing.PageSettings object that the DEVMODE structure's handle corresponds to.

Returns

A handle to a DEVMODE structure.

Remarks

DEVMODE structures are device specific. Copying a DEVMODE structure from one System.Drawing.Printing.PrinterSettings to a System.Drawing.Printing.PrinterSettings for a different printer is not supported.

When you are done with the handle that is created through this method, you must deallocate it yourself by calling the native Win32 GlobalFree method. When you call this method, you pass as a parameter the return value from the PrinterSettings.GetHdevmode method.

Requirements

Namespace: System.Drawing.Printing
Assembly: System.Drawing (in System.Drawing.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0