IOgetCoordinates

Input convert into co-ordinates.

IOgetCoordinates reads an input line and tries to interpret this as a co-ordinate position. The result is stored in the variable for x and y, the key becomes as a result value of the procedure zurückgeliefert. If a mistake has appeared, it is delivered to 0 as a result. If the parametre doEcho TRUE (is not 0), the input line is repeated, otherwise the input is carried out without echo. Co-ordinate lines have one of the following forms:

<CR> It is looked as a CON.

#<Key> <x> <y> The line shows a Digitalisiereingabe with the key "key" and the position (x, y). Key can be a value from L, P, C, R, CON, RPT, IBID. and CLS.

Parametre

root (PROOT) [IN]

Act on the open data bank.

x (stands in *) [OUT]

The x co-ordinate of the digitized position is stored in this variable.

y (stands in *) [OUT]

The Y co-ordinate of the digitized position is stored in this variable.

doEcho (int) [IN]

If this value 0 is, the co-ordinate change occurs silently, the input string does not become visible if this value of 0 has passed away, the input line is repeated in the issue window, the digitized co-ordinate is visible. This can lead to confusion if the co-ordinate is used for identifying, because the indicated co-ordinate is the position while digitizing, not, nevertheless, the co-ordinate of the identified point.

cp (PCOORDINATE_PARAMETER) [IN / OUT]

The structure COORDINATE_PARAMETER contains, in addition, still the co-ordinate for the z axis. If a valid z co-ordinate exists, stands in the Flag valid the constant COORDINATE_PARAMETER_VALID_Z. The structure is described in the Include file basic.h.

Result

(int) [OUT]

A value greater than 0 gives the key code, so LINK_P, etc.

The value 0 gives that no co-ordinates exist.

Declaration

#include "ausgabe.h"

int DLLENTRY IOgetCoordinates (

PROOT root,

stand in * x,

stand in * y,

int doEcho

PCOORDINATE_PARAMETER cp

);

Remarks

The difference to the routine DBgetCoordinates if that is that with DBgetCoordinates the co-ordinates on an available grid are rounded.