WtPreview Function

Handles utility functions for the preview widget (XvnPreview).

Usage

status = WtPreview(action, widget)

Input Parameters

action — A 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