added a note about print preview inaccurancies and recommendation to use native previ...

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@54265 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

diff --git a/interface/print.h b/interface/print.h
index 0230bf3cf4523d83c679e3eca093ca6193129d4c..8ad4c4512b404b2c7a1c5a6a01df77a0dd5df0d0 100644 (file)
--- a/interface/print.h
+++ b/interface/print.h
@@ -199,6 +199,15 @@ public:
     the preview frame. Unlike wxPrinter::Print(), flow of control returns to the
     application immediately after the frame is shown.
 
+    @note
+    The preview shown is only exact on Windows. On other platforms, the wxDC
+    used for preview is different from what is used for printing and the
+    results may be significantly different, depending on how is the output
+    created. In particular, printing code relying on wxDC::GetTextExtent()
+    heavily (for example, wxHtmlEasyPrinting and other wxHTML classes do) is
+    affected. It is recommended to use native preview functionality on
+    platforms that offer it (OS X, GTK+).
+
     @library{wxbase}
     @category{printing}