Dialog windows

Popups that show or ask an information to the user. More...

Data Structures
struct	T_MultipleChoice

Functions
byte	Confirmation_box (const char *message)
	Window asking for confirmation before an action is performed. More...
void	Warning_message (const char *message)
	Window that shows a warning message and wait for a click on the OK button. More...
void	Warning_with_format (const char *message,...)
	Window that shows a warning message and waits for a click on the OK button. More...
void	Verbose_message (const char *caption, const char *message)
	Window that shows a big message (up to 35x13), and waits for a click on OK. More...
int	Requester_window (const char *message, int initial_value)
	Window that allows you to enter a single value. More...
int	Dialog_multiple_choice (const char *title, const T_MultipleChoice *choices, int initial_choice)
	Ask the user to choose between multiple choices. More...

Detailed Description

Popups that show or ask an information to the user.

Function Documentation

Confirmation_box()

byte Confirmation_box

(

const char *

message

)

Window asking for confirmation before an action is performed.

This function is able to display multi-line messages and center the lines, but the carriage returns have to be explicit. The function will clip the message in case of problem.

Returns

1 if user pressed OK, 0 if CANCEL

References Close_window(), Display_cursor(), Key, KEY_ESC, KEY_n, KEY_RETURN, KEY_y, Max(), MC_Black, MC_Light, NULL, Open_window(), Print_in_window(), Update_window_area, Window_clicked_button(), Window_height, Window_set_normal_button(), and Window_width.

Referenced by Button_Autosave(), Button_Kill(), Button_Load_or_Save(), Button_Quit_local_function(), Button_Reload(), Load_picture(), Main_handler(), Save_image(), and Save_picture().

Warning_message()

void Warning_message

(

const char *

message

)

Window that shows a warning message and wait for a click on the OK button.

References Close_window(), Display_cursor(), Key, KEY_ESC, KEY_o, KEY_RETURN, MC_Black, MC_Light, Open_window(), Print_in_window(), Update_window_area, Window_clicked_button(), and Window_set_normal_button().

Referenced by Button_Kill(), Encode_C64_hires(), Encode_C64_multicolor(), Save_C64(), Save_C64_fli(), Save_C64_fli_monolayer(), Save_C64_hires(), Save_C64_multi(), Save_HGR(), Save_MOTO(), Save_PRG(), Save_SGX(), and Window_Histogram().

Warning_with_format()

void Warning_with_format	(	const char *	template,
			...
	)

Window that shows a warning message and waits for a click on the OK button.

This has the added advantage of supporting the printf interface.

References Verbose_message().

Referenced by C64_pixels_to_FLI(), Encode_C64_hires(), Encode_C64_multicolor(), Load_Unicode_font(), and Save_MOTO().

Verbose_message()

void Verbose_message	(	const char *	caption,
		const char *	message
	)

Window that shows a big message (up to 35x13), and waits for a click on OK.

• On call: Cursor must be displayed
• On exit: Cursor is displayed

References Close_window(), Cursor_shape, CURSOR_SHAPE_ARROW, Display_cursor(), GFX2_INFO, GFX2_Log(), Key, KEY_ESC, KEY_o, KEY_RETURN, MC_Black, MC_Light, Open_window(), Print_in_window(), Update_window_area, Window_clicked_button(), Window_height, Window_set_normal_button(), and Window_width.

Referenced by Button_Brush_Factory(), Button_Constraint_mode(), Button_Skins(), Init_mode_video(), Init_program(), Render_text_SFont(), and Warning_with_format().

Requester_window()

int Requester_window	(	const char *	message,
		int	initial_value
	)

Window that allows you to enter a single value.

References Close_window(), Display_cursor(), INPUT_TYPE_INTEGER, Key, KEY_ESCAPE, KEY_n, KEY_y, MC_Black, MC_Light, Open_window(), Print_in_window(), Readline(), Update_window_area, Window_clicked_button(), Window_set_input_button(), and Window_set_normal_button().

Referenced by Button_Palette().

Dialog_multiple_choice()

int Dialog_multiple_choice	(	const char *	title,
		const T_MultipleChoice *	choices,
		int	initial_choice
	)

Ask the user to choose between multiple choices.

References Close_window(), Display_cursor(), GFX2_DEBUG, GFX2_Log(), Hide_cursor(), T_MultipleChoice::hint, Key, KEY_c, KEY_ESCAPE, KEY_o, KEY_RETURN, label, T_MultipleChoice::label, LEFT_SIDE, MC_Dark, MC_Light, MIN, NULL, Open_window(), Print_in_window(), RIGHT_SIDE, Update_window_area, Window_attribute2, Window_clicked_button(), Window_dropdown_add_item(), Window_set_dropdown_button(), and Window_set_normal_button().

Referenced by Button_Constraint_menu().