DevMode Structure

Contains information about the initialization and environment of a display device or a printer.

Definition

Namespace: DevCase.Win32.Structures
Assembly: DevCase.net48 (in DevCase.net48.dll) Version: 6.0.0.0 (6.0)
XMLNS for XAML: Not mapped to an xmlns.
public struct DevMode
Inheritance
Object    ValueType    DevMode

Remarks

Constructors

DevMode Initializes a new instance of the DevMode structure.

Methods

Equals Indicates whether this instance and a specified object are equal.
(Inherited from ValueType)
GetHashCode Returns the hash code for this instance.
(Inherited from ValueType)
GetType Gets the Type of the current instance.
(Inherited from Object)
ToString Returns the fully qualified type name of this instance.
(Inherited from ValueType)

Fields

BitsPerPixel Specifies the color resolution, in bits per pixel, of the display device (for example: 4 bits for 16 colors, 8 bits for 256 colors, or 16 bits for 65,536 colors).

Display drivers use this member, for example, in the ChangeDisplaySettings function.

Printer drivers do not use this member.

Collate Specifies whether collation should be used when printing multiple copies.

This member is ignored unless the printer driver indicates support for collation by setting the Fields member to Collate.

Color Switches between color and monochrome on color printers.
DeviceName A zero-terminated character array that specifies the "friendly" name of the printer or display; for example, "PCL/HP LaserJet" in the case of PCL/HP LaserJet. This string is unique among device drivers.

Note that this name may be truncated to fit in the DeviceName array.

DisplayFrequency Only for Display drivers, specifies the frequency, in hertz (cycles per second), of the display device in a particular mode.

This value is also known as the display device's vertical refresh rate.

It is used, for example, in the ChangeDisplaySettings function.

DitherType Specifies how dithering is to be done.

The member can be one of the following predefined values, or a driver-defined value greater than or equal to the value of DMDITHER_USER.

DriverExtra Contains the number of bytes of private driver-data that follow this structure.

If a device driver does not use device-specific information, set this member to zero.

DriverVersion The driver version number assigned by the driver developer.
Duplex Selects duplex or double-sided printing for printers capable of duplex printing.
Fields Specifies whether certain members of the DevMode structure have been initialized.

If a member is initialized, its corresponding bit is set, otherwise the bit is clear.

A driver supports only those DevMode members that are appropriate for the printer or display technology.

Flags Specifies the device's flags.
FormName A zero-terminated character array that specifies the name of the form to use; for example, "Letter" or "Legal". A complete set of names can be retrieved by using the EnumForms function.
IcmIntent Specifies which color matching method, or intent, should be used by default.

This member is primarily for non-ICM applications.

ICM applications can establish intents by using the ICM functions.

This member can be one of the following predefined values, or a driver defined value greater than or equal to the value of DMICM_USER.

IcmMethod Specifies how ICM is handled.

For a non-ICM application, this member determines if ICM is enabled or disabled.

For ICM applications, the system examines this member to determine how to handle ICM support.

This member can be one of the following predefined values, or a driver-defined value greater than or equal to the value of DMICMMETHOD_USER.

LogPixels The number of pixels per logical inch. Printer drivers do not use this member.
MediaType Specifies the type of media being printed on.

The member can be one of the following predefined values, or a driver-defined value greater than or equal to the value of DMMEDIA_USER.

Mode Contains information about a device.
PanningHeight This member must be zero.
PanningWidth This member must be zero.
PixelsHeight Specifies the height, in pixels, of the visible device surface.

Display drivers use this member, for example, in the ChangeDisplaySettings function.

Printer drivers do not use this member.

PixelsWidth Specifies the width, in pixels, of the visible device surface.

Display drivers use this member, for example, in the ChangeDisplaySettings function.

Printer drivers do not use this member.

Reserved1 Not used; must be zero.
Reserved2 Not used; must be zero.
SizeOfStruct Specifies the size, in bytes, of the DevMode structure, not including any private driver-specific data that might follow the structure's public members.

This member must be set to Marshal.SizeOf(Of DevMode) before calling any function, to indicate the version of the DevMode structure being used.

SpecVersion The version number of the initialization data specification on which the structure is based.

To ensure the correct version is used for any operating system, use DM_SPECVERSION.

TTOption Specifies how TrueType fonts should be printed.
YResolution Specifies the y-resolution, in dots per inch, of the printer.

If the printer initializes this member, the PrintQuality member specifies the x-resolution, in dots per inch, of the printer.

Extension Methods

CanConvertTo Determines whether the source object can be converted to the specified target type.
(Defined by ObjectExtensions)
CanConvertToT Determines whether the source object can be converted to the specified target type.
(Defined by ObjectExtensions)
ConvertToT Converts an object to the specified target type.

If the conversion fails, an exception is thrown.
(Defined by ObjectExtensions)

ConvertToT Converts an object to the specified target type.

If the conversion fails, returns the specified default value.
(Defined by ObjectExtensions)

IsDisposable Determines whether the specified object is a disposable type (i.e., it implements IDisposable interface).
(Defined by ObjectExtensions)
Speak Speaks the string representation of the source object by using the operating system integrated text-to-speech synthesizer.
(Defined by ObjectExtensions)
Speak Speaks the string representation of the source object by using the operating system integrated text-to-speech synthesizer.
(Defined by ObjectExtensions)
ThrowIfNullTException Throws the specified exception if the source object is null.
(Defined by ObjectExtensions)

See Also