WtPreview Function

Handles utility functions for the preview widget (XvnPreview).

Usage

status = WtPreview(action, widget)

Input Parameters

actionA string containing one of the following actions:

AutoDefine — Automatically define the data area.

ClearArea — Clear the given data area. If this action is specified, you must also provide the following input parameters:

type — The type of object to commit.

count — The number of areas to clear.

areas — The selected areas to clear.

ClearAll — Clear all of the selected areas.

CommitArea — Commit the selection of the given area. If this action is specified, you must also provide the following input parameters:

type — The type of object to commit.

count — The number of areas to commit.

areas — The selected areas to commit.

SelectArea — Select the given area. If this action is specified, you must also provide the following input parameters:

type — The type of object to select.

area — The area to select.

widget — The widget ID of the Preview widget (XvnPreview).

Discussion

XvnPreview is a widget class that allows you to preview column-oriented ASCII data. WtPreview allows the PV‑WAVE application programmer to interact with, and modify the preview widget. Specifically, WtPreview facilitates the selection and clearing of areas in a data file being displayed by the preview widget.

Note:

Rogue Wave has ported a subset of the Widget Toolbox (Wt) functionality that is available for Motif to Microsoft Windows. Because the Widget Toolbox under Windows is not a complete implementation, we recommend that Windows developers use the PV‑WAVE Widgets (Ww) layer or the VDA Tools when developing GUI applications.

See WwPreview Procedure for more detailed information on the preview widget and an example preview window application.

XvnPreview Widget Documentation

The XvnPreview widget class was developed by Rogue Wave Software, Inc.

Complete documentation for the XvnPreview widget, including information on the widget’s resources and callbacks, is available in the PostScript file preview_motif.ps, which you can print on any PostScript printer. This file is in:

WAVE_DIR/docs/widgets 
WAVE_DIR\docs\widgets 

Where WAVE_DIR is the main PV‑WAVE directory.

See also Appendix B: Motif Callback Parameters in the PV‑WAVE Application Developer’s Guide for information on the required parameters for all widget callbacks.

Example

See the example for the WtPreview Function.

See Also

WwPreview, WzPreview Procedure

For detailed information on GUI development, refer to the PV‑WAVE Application Developer’s Guide.

For more information about how to write an application program based on the PV‑WAVE Widget Toolbox, refer to Using the Widget Toolbox in the PV‑WAVE Application Developer’s Guide.