pltICursor Find

Sets the cursor’s position to find the closest value to the input arguments.

Syntax

pulICursor_handle Find args

Application

Tcl Query

Description

This command sets the cursor’s position to find the closest value to the input arguments. The command returns true.

Note: To find the coordinates or index of the point that is closest to the input arguments, you must call GetX, GetY, or GetI after calling the Find command.

Inputs

args: A list of coordinates to match. The coordinates must begin with the coordinate axis (“x”, “y”, or “z”), followed by the coordinate number (“0123456789.+-“) with a space between the two values. The list must be within “”. If the list only has one coordinate, such as “x 9”, the command finds the first point with a value above the input coordinate. If the list has two of the coordinates, such as “x 3 x 2”, it finds the closet point on the curve to the input coordinates.

Example

hwi GetSessionHandle sess;
sess GetProjectHandle proj;
proj GetPageHandle p1 1;
p1 GetWindowHandle w1 1;
w1 GetClientHandle plot;
plot GetCurveHandle c1 1;
c1 GetCursorHandle cur 1;
cur Find "x2 y3";
cur GetX;
cur GetY;

Errors

Success (true) or an error message is returned.

Keywords

Tcl

Cursor

Query