SftPrintPreview/DLL 2.0 - Print Preview Control for C/C++

SFTPRINTPREVIEW_PRINTERINFORESULT Structure

The SFTPRINTPREVIEW_PRINTERINFORESULT structure is used with the GetPrinterInfo and SetPrinterInfo functions to define printer settings.

typedef struct tagSftPrintPreviewPrinterInfoResult {
    TCHAR szName[256];
    TCHAR szPort[64];
    TCHAR szDriver[1024];
    BOOL fDefault; // True if default printer
    HGLOBAL hDevMode; // Devmode for selected printer
    HGLOBAL hDevNames; // Devnames for selected printer
    DEVMODE DevMode; // copy of DEVMODE structure
} SFTPRINTPREVIEW_PRINTERINFORESULT;
typedef const SFTPRINTPREVIEW_PRINTERINFORESULT * LPCSFTPRINTPREVIEW_PRINTERINFORESULT;

Members

szName

The name of the current printer.

szPort

The name of the current output port.

szDriver

The name of the current printer driver.

fDefault

TRUE if the current printer is the system default printer, FALSE otherwise.

hDevMode

DEVMODE handle for the currently selected printer.

hDevNames

DEVNAMES handle for the currently selected printer.

DevMode

DEVMODE structure describing the current printer.

Comments

The SFTPRINTPREVIEW_PRINTERINFORESULT structure is used with the GetPrinterInfo and SetPrinterInfo functions to define printer settings.

After retrieving the current printer settings using GetPrinterInfo, certain members of the DevMode structure can be modified to change the settings with a subsequent SetPrinterInfo function call.

Modifiable members: dmOrientation, dmPaperSize, dmPaperLength, dmPaperWidth, dmCopies, dmPrintQuality, dmYResolution, dmCollate, dmMediaType, dmDuplex. Please note that not all printer drivers support all members.

Example

C

SFTPRINTPREVIEW_PRINTERINFORESULT Info;
SftPrintPreview_GetPrinterInfo(hwndPreview, &Info);
Info.DevMode.dmOrientation = DMORIENT_LANDSCAPE;
SftPrintPreview_SetPrinterInfo(hwndPreview, &Info);

C++

SFTPRINTPREVIEW_PRINTERINFORESULT Info;
m_Preview.GetPrinterInfo(&Info);
Info.DevMode.dmOrientation = DMORIENT_LANDSCAPE;
m_Preview.SetPrinterInfo(&Info);

See Also C/C++ API | C++ Classes | Notifications