map_draw_over()

Purpose

Replaces one map with another

Old name

#define mapover(old_map,new_map)
map_draw_over(old_map,new_map,DEFAULT)

Syntax

void map_draw_over(oldmap, newmap, NO_REARRANGE)

Parameters

int old_map

Number of map to be replaced

 

int new_map

Number of new map to display

 

int flags

Control the display characteristics

Description

This function replaces a displayed map with a new map. The text of the old map is overwritten and its fields are blanked out. If the new map is larger than the old map, it is truncated to fit in the space available. If it is smaller than the old map, some of the text of the old map may still be visible.

The only flag implemented at present is NO_REARRANGE. This keeps the map being replaced in its original position in the viewing order. If DEFAULT is passed, the replacement map is brought to the top of the viewing order. The NO_REARRANGE flag is useful if you wish to refresh a map which has other maps drawn on top.

The recommended use of this function is to call it with both parameters the same, for example:

map_draw_over(n, n, DEFAULT)

This is useful in pick lists.

See also

map_draw()