show_attach()

Purpose

Shows the contents of one map over the field of another

Old name

#define show_attach_map show_attach

Syntax

void show_attach(mapnr, fieldnr, newmap, flags)

Parameters

int mapnr

Number of map on screen

 

int fieldnr

Number of field over which to display

 

int newmap

Number of new map to display

 

int flags

Parameter specifying display attributes (for example, colour)

 

The parameter flags may take any combination of the following values:

 

Value

Meaning

 

SKIP_MISSING_FIELD

Stops program from terminating if the field to attach to does not exist

 

SYSTEM_MAP

Indicates that the new map comes from the SYSTEM mapset on the SYSTEM database

 

USE_FIELD_LENGTH

This makes the new map contract or expand to the size given by the field to which the new map is attached

 

INPUT_COLOUR

The text is displayed using the input colour rather than the output colour

Description

The function show_attach() displays text from the second map specified on the screen. The position of the second map is determined by the position of the specified field.

The pick_record() function calls the function show_more() to display the 'More available' messages. The show_more() function is in turn implemented with the function show_attach().

See also

show_over()