map_use()

Purpose

Sets up the missing inpm() fields

Old name

#define use_map map_use

Syntax

void map_use(mapnr, fieldnr)

Parameters

int mapnr

Number of map to set as default

int* fieldnr

Pointer to a variable to use as current field number

Description

The map_use() function is called by the inpm_x() functions to specify the map and field numbers from which to obtain input. It does this by setting the global variables input_map and input_field to the corresponding parameter values.

Normally, the field number passed to the function map_use() is the address of a local variable set to the initial data entry field. It is automatically changed with subsequent user input.

The function map_use() is usually called just once at the beginning of each data entry function.

If you use the map_get_inputs() function, the function map_use() is automatically called for you.

If you do not use this function before calling an inpm_x() function, the "map not on screen" error message is displayed.

See also

inpm_x(), inpm()

Example

See the example on inpm_x()