1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
/*
* Copyright (C) Volition, Inc. 1999. All rights reserved.
*
* All source code herein is the property of Volition, Inc. You may not sell
* or otherwise commercially exploit the source or things you created based on the
* source.
*
*/
#ifndef __POPUP_H__
#define __POPUP_H__
// standardized text used for common buttons
// Special note (JH): The leading '&' is expected for these 4 defines in the code
#define POPUP_OK XSTR("&Ok", 503)
#define POPUP_CANCEL XSTR("&Cancel", 504)
#define POPUP_YES XSTR("&Yes", 505)
#define POPUP_NO XSTR("&No", 506)
///////////////////////////////////////////////////
// flags
///////////////////////////////////////////////////
// NEVER ADD FLAGS LESS THAN 10 here. there are some internal flags which use those
// font size
#define PF_TITLE (1<<10) // Draw title centered in regular font (title is first line)
#define PF_TITLE_BIG (1<<11) // Draw title centered in large font (title is first line)
#define PF_BODY_BIG (1<<12) // Draw message body in large font
// color
#define PF_TITLE_RED (1<<13) // Color to draw title, if different from default
#define PF_TITLE_GREEN (1<<14)
#define PF_TITLE_BLUE (1<<15)
#define PF_TITLE_WHITE (1<<16)
#define PF_BODY_RED (1<<17) // Color to draw body, if different from title
#define PF_BODY_GREEN (1<<18)
#define PF_BODY_BLUE (1<<19)
// icon choices
#define PF_USE_NEGATIVE_ICON (1<<20) // Always drawn as first icon if set
#define PF_USE_AFFIRMATIVE_ICON (1<<21) // Always drawn as second icon if two choices (if 1 choice, it is the only icon)
// misc
#define PF_RUN_STATE (1<<22) // call the do frame of the current state underneath the popup
#define PF_IGNORE_ESC (1<<23) // ignore the escape character
#define PF_ALLOW_DEAD_KEYS (1<<24) // Allow player to use keyset that exists when player dies
#define PF_NO_NETWORKING (1<<25) // don't do any networking
// no special buttons
#define PF_NO_SPECIAL_BUTTONS (1<<26)
// special web mouseover cursor flags
#define PF_WEB_CURSOR_1 (1<<27) // button 1 will get web cursor
#define PF_WEB_CURSOR_2 (1<<28) // button 2 will get web cursor
// input: flags => formatting specificatons (PF_... shown above)
// nchoices => number of choices popup has
// text_1 => text for first button
// ... =>
// text_n => text for last button
// msg text => text msg for popup (can be of form "%s",pl->text)
//
// exit: choice selected (0..nchoices-1)
// will return -1 if there was an error or popup was aborted
//
// typical usage:
//
// rval = popup(0, 2, POPUP_YES, POPUP_NO, "Hey %s, do you want to quit", pl->callsign);
int popup(int flags, int nchoices, ... );
// popup with cancel button and conditional funcrion.
// input: condition => function to call every frame, if condition() returns FALSE, the popup
// continues waiting. If condition() returns anything else, the popup will
// return that value.
// text_1 => text for cancel button
// msg text => text msg for popup (can be of form "%s",pl->text)
//
// exit: condition occured (return value of condition)
// will return 0 if cancel was pressed or popup was aborted
// will return -1 if there was an error
//
// typical usage:
//
// int condition_function() {
// if (blah) return 1;
// return 0;
// }
// .
// .
// .
// rval = popup_till_condition( condition_function, "Cancel", "Checking to see if %s is an idiot.", pl->callsign);
int popup_till_condition( int(*condition)() , ...);
// popup to return the value from an input box
char *popup_input(int flags, char *caption, int max_output_len = -1);
int popup_active();
int popup_running_state();
// kill any active popup, forcing it to return -1 (similar to ESC)
void popup_kill_any_active();
// change the text inside of the popup
void popup_change_text(char *new_text);
#endif
|
