gtk-file-chooser-preview-widget (object)

object -- a gtk-file-chooser widget
preview-widget -- a gtk-widget for displaying preview

Accessor of the preview-widget slot of the gtk-file-chooser interface.

The slot access function gtk-file-chooser-preview-widget gets the current preview widget. The slot access function (setf gtk-file-chooser-preview-widget) sets an application-supplied widget to use to display a custom preview of the currently selected file.

To implement a preview, after setting the preview widget, you connect to the "update-preview" signal, and call the functions gtk-file-chooser-preview-filename or gtk-file-chooser-preview-uri on each change. If you can display a preview of the new file, update your widget and set the preview active using the function gtk-file-chooser-preview-widget-active. Otherwise, set the preview inactive.

When there is no application-supplied preview widget, or the application-supplied preview widget is not active, the file chooser may display an internally generated preview of the current file or it may display no preview at all.