COleDocument::ApplyPrintDevice

BOOL ApplyPrintDevice( const DVTARGETDEVICE FAR* ptd );

BOOL ApplyPrintDevice( const PRINTDLG* ppd );

Return Value

Nonzero if the function was successful; otherwise 0.

Parameters

ptd

Pointer to a DVTARGETDEVICE data structure, which contains information about the new print-target device. Can be NULL.

ppd

Pointer to a PRINTDLG data structure, which contains information about the new print-target device. Can be NULL.

Remarks

Call this function to change the print-target device for all embedded COleClientItem items in your application’s container document. This function updates the print-target device for all items but does not refresh the presentation cache for those items. To update the presentation cache for an item, call COleClientItem::UpdateLink.

The arguments to this function contain information that OLE uses to identify the target device. The PRINTDLG structure contains information that Windows uses to initialize the common Print dialog box. After the user closes the dialog box, Windows returns information about the user’s selections in this structure. The m_pd member of a CPrintDialog object is a PRINTDLG structure.

For more information, see the PRINTDLG structure in the Win32 SDK documentation.

For more information, see the DVTARGETDEVICE structure in the OLE 2 Programmer’s Reference, Volume 1.

COleDocument OverviewClass MembersHierarchy Chart

See Also   CPrintDialog