- Creates the preview canvas and control bar, and calls wxWindow::MakeModal(@true)
- to disable other top-level windows in the application.
+ Creates the preview canvas and control bar.
+
+ By default also disables the other existing top level windows to
+ prepare for showing the preview frame modally. Since wxWidgets 2.9.2
+ this can be changed by specifying either wxPreviewFrame_WindowModal --
+ to disable just the parent window -- or wxPreviewFrame_NonModal -- to
+ not disable any windows at all -- as @a kind parameter.
+
+ This function must be called by the application prior to showing the frame.