CreateStopSkipButtons()

Summary

Adds stop and skip buttons to the status bar for use in interrupting map drawing.

Syntax

CreateStopSkipButtons(array stop_button_names, array skip_button_names)

Argument Contents
stop_button_names An array of three bitmap names for the stop button in different states: default, pressed, and disabled
skip_button_names An array of three bitmap names for the skip button in different states: default, pressed, and disabled

Notes

  • The buttons are only available in the map window during drawing. They are disabled at all other times.

  • The buttons are inserted to the right of the first section of the status bar, shifting other sections as necessary.

Example

// Add the stop/skip buttons in the interface macro so that they will be available at all times
CreateStopSkipButtons({"bmp\\stop.bmp", "bmp\\stop2.bmp", "bmp\\stop1.bmp"},
{"bmp\\skip.bmp", "bmp\\skip2.bmp", "bmp\\skip1.bmp"})

Error Codes

Error Type Meaning
Error The input arrays are invalid

See Also

Function Summary
SetStatusBar() Sets the number and size of sections in the status bar