SYSgetCoordinate

Co-ordinates fetch.

With this routine the co-ordinates and the key code are fetched at Digitizer or mouse. To the routine can be handed over still constants which steer the other action, e.g., the point in which the cursor is can be marked.

Parametre

root (PROOT) [IN]

Act on the open data bank.

feels (int *) [IN / OUT]

In feels becomes the key code zurückgeliefert, e.g., LINK_P or LINK_L. If the value is not used ZERO can be also handed over.

x (STANDS IN *) [IN / OUT]

y (STANDS IN *) [IN / OUT]

The co-ordinates are data bank co-ordinates, i.e. these are the co-ordinates of the nächstliegenden point. If these co-ordinates are not necessary, both worth ZEROS can also include here. If one wants to have the original co-ordinates, must be given with the Flags SYS_COORD_RETURN_ORIGINAL_COORDS and, in addition, two parametres for the original co-ordinates.

flags (ULONG) [IN]

The constants described below can be given geodert here to steer the evaluation of the following parametre.

... [IN]

Here the parametres must be given how they have been given by the constants in the parametre before.

Result

(int) [OUT]

By perfect implementation the constant SYS_COORD_VALID_IDENTIFY is delivered.

Declaration

#include "system.h"

int DLLENTRY SYSgetCoordinate (

PROOT root,

int * feels,

STAND-IN * x,

STAND-IN * y,

ULONG flags,

...

);

Constants

The parametres must be performed in this order if they are put.

SYS_COORD_RETURN_TEXT

Delivers the text back which stands in the command line. The following parametres must be given with char* text, int textlen. In text the sign chain is delivered and in textlen the maximum number stands after text is copied. text should have so much storage space freely like in textlen given.

SYS_COORD_MSGTEXT

Before the key click should occur, an additional text can be given. In addition a sign chain with must be handed over.

SYS_COORD_MSGTEXT_CLS

Special text, is given if on base should be integrated. In addition a sign chain with must be handed over.

SYS_COORD_MSGTEXT_EBD

Special text, is given if point should be constructed. In addition a sign chain with must be handed over.

SYS_COORD_MSGTEXT_RPT

Special text, is given if point from the construction buffer is identified. In addition a sign chain with must be handed over.

SYS_COORD_HAS_IDENTIFY_FLAGS

Herewith additional Flags are given, in addition must be given long int which can contain other geoderte constants.

SYS_COORD_MARK

The identified point can be provided with a marker, e.g., green triangle. Then must be given int and, e.g., the constant DCgreenTriangle

SYS_COORD_MAKE_PSY_PCL

With this Flag the symbol and the point class can be determined by the identified point. In addition two pointers on int must be handed over, first for the symbolic number and second for the point class.

SYS_COORD_RETURN_ORIGINAL_COORDS

It are delivered on top with the parametres ordinarily the co-ordinates of the nearest base. Should the co-ordinates be delivered, however where became in the plan really hingeklickt, this Flag must be put. In addition two pointers on must be handed over stands in, first for the X axis and second for the Y axis.

Related functions

SYSidentifyCoordinate