SftPrintPreview.ContentProviderCallback Method	Softel vdm, Inc.

Defines the callback that provides printable content.

Syntax       

		VB.NET	object.ContentProviderCallback(ByVal Handle As Integer, ByVal CallbackPointer As VT_VOID, ByVal WorkAreaPointer As VT_VOID)
		VB	object.ContentProviderCallback(ByVal Handle As Long, CallbackPointer As VT_VOID, WorkAreaPointer As VT_VOID)
		C#.NET	void object.ContentProviderCallback(int Handle, void CallbackPointer, void WorkAreaPointer);
		VC++	HRESULT object->ContentProviderCallback(long Handle, void* CallbackPointer, void* WorkAreaPointer);
		C	HRESULT object->raw_ContentProviderCallback(long Handle, void* CallbackPointer, void* WorkAreaPointer);
		Delphi	procedure object.ContentProviderCallback(Handle : Integer, CallbackPointer : VT_VOID, WorkAreaPointer : VT_VOID);

object

A SftPrintPreview object.

Handle

A window handle describing the window to be printed or previewed.  This value can be 0 if application-generated output is rendered using the RenderContent event.

CallbackPointer

A callback routine.  This value can be 0 (NULL) if application-generated output is rendered using the RenderContent event.  When rendering a RichEdit control, Handle defines the RichEdit control and CallbackPointer is set to the RenderRichEdit or RenderRichEditX property value to print and preview the RichEdit control.  This CallbackPointer is of type SFTPRINTPREVIEW_DRAWINFOPROC, which is defined by SftPrintPreview/DLL and can be used to implement a callback function as required by SftPrintPreview/DLL (requires SftPrintPreview/DLL).

WorkAreaPointer

An application-defined value.  This value is available during the RenderContent event using the RenderingWorkArea property.

Comments

The ContentProviderCallback method defines the callback that provides printable content.

This method is not supported for use with Visual Basic 6.0

The use of the ContentProviderCallback or ContentProviderCallbackX methods override settings defined using a prior call to the ContentProvider property.

The ContentProviderCallback or ContentProviderCallbackX methods are functionally equivalent, but use different data types.

RichEdit controls require the use of the RenderRichEdit or RenderRichEditX functions as a CallbackPointer for the ContentProviderCallback or ContentProviderCallbackX methods.  The ContentProvider property is not used.  The RenderRichEdit function, provided by SftPrintPreview/OCX, provides all rendering support for RichEdit controls.  The RenderContent event is not used.

For application-generated output, the ContentProviderCallback or ContentProviderCallbackX methods are used with a CallbackPointer value of 0.  The RenderContent event is used to render pages.  The ContentProvider property is not used

SftTree/DLL and SftTree/OCX 5.0 (and up) are rendered by setting the ContentProvider property to the window handle of a SftTree/DLL or SftTree/OCX control.  The ContentProviderCallback or ContentProviderCallbackX methods are not used.  The DataProvider property is also supported for use with SftTree/DLL or SftTree/OCX controls.  All rendering is provided by SftTree/DLL or SftTree/OCX through the SFTPRINTPREVIEW_CONTENTWINDOWMESSAGE protocol.  The RenderContent event is not used.