Mercurial > pidgin.yaz
comparison src/request.h @ 11201:07dc8c6a359f
[gaim-migrate @ 13329]
This hopefully fixes a lot of potential crashes in the SILC PRPL.
Possible things to do:
-Backport these changes to oldstatus
-Ask the SILC guy to make sure all of these make sense. It's
likely there are better things that could be used as handles
-Check for other places in Gaim that don't give handles when
they should
committer: Tailor Script <tailor@pidgin.im>
author | Mark Doliner <mark@kingant.net> |
---|---|
date | Mon, 08 Aug 2005 02:18:16 +0000 |
parents | 2ab4b5acc8d1 |
children | f0bc5f121684 |
comparison
equal
deleted
inserted
replaced
11200:4295083cf489 | 11201:07dc8c6a359f |
---|---|
1066 /*@{*/ | 1066 /*@{*/ |
1067 | 1067 |
1068 /** | 1068 /** |
1069 * Prompts the user for text input. | 1069 * Prompts the user for text input. |
1070 * | 1070 * |
1071 * @param handle The plugin or connection handle. | 1071 * @param handle The plugin or connection handle. For some |
1072 * things this is EXTREMELY important. The | |
1073 * handle is used to programmatically close | |
1074 * the request dialog when it is no longer | |
1075 * needed. For PRPLs this is often a pointer | |
1076 * to the GaimConnection instance. For plugins | |
1077 * this should be a similar, unique memory | |
1078 * location. This value is important because | |
1079 * it allows a request to be closed, say, when | |
1080 * you sign offline. If the request is NOT | |
1081 * closed it is VERY likely to cause a crash | |
1082 * whenever the callback handler functions are | |
1083 * triggered. | |
1072 * @param title The title of the message. | 1084 * @param title The title of the message. |
1073 * @param primary The main point of the message. | 1085 * @param primary The main point of the message. |
1074 * @param secondary The secondary information. | 1086 * @param secondary The secondary information. |
1075 * @param default_value The default value. | 1087 * @param default_value The default value. |
1076 * @param multiline TRUE if the inputted text can span multiple lines. | 1088 * @param multiline TRUE if the inputted text can span multiple lines. |
1095 void *user_data); | 1107 void *user_data); |
1096 | 1108 |
1097 /** | 1109 /** |
1098 * Prompts the user for multiple-choice input. | 1110 * Prompts the user for multiple-choice input. |
1099 * | 1111 * |
1100 * @param handle The plugin or connection handle. | 1112 * @param handle The plugin or connection handle. For some |
1113 * things this is EXTREMELY important. See | |
1114 * the comments on gaim_request_input. | |
1101 * @param title The title of the message. | 1115 * @param title The title of the message. |
1102 * @param primary The main point of the message. | 1116 * @param primary The main point of the message. |
1103 * @param secondary The secondary information. | 1117 * @param secondary The secondary information. |
1104 * @param default_value The default value. | 1118 * @param default_value The default value. |
1105 * @param ok_text The text for the OK button. | 1119 * @param ok_text The text for the OK button. |
1120 void *user_data, ...); | 1134 void *user_data, ...); |
1121 | 1135 |
1122 /** | 1136 /** |
1123 * Prompts the user for multiple-choice input. | 1137 * Prompts the user for multiple-choice input. |
1124 * | 1138 * |
1125 * @param handle The plugin or connection handle. | 1139 * @param handle The plugin or connection handle. For some |
1140 * things this is EXTREMELY important. See | |
1141 * the comments on gaim_request_input. | |
1126 * @param title The title of the message. | 1142 * @param title The title of the message. |
1127 * @param primary The main point of the message. | 1143 * @param primary The main point of the message. |
1128 * @param secondary The secondary information. | 1144 * @param secondary The secondary information. |
1129 * @param default_value The default value. | 1145 * @param default_value The default value. |
1130 * @param ok_text The text for the OK button. | 1146 * @param ok_text The text for the OK button. |
1147 /** | 1163 /** |
1148 * Prompts the user for an action. | 1164 * Prompts the user for an action. |
1149 * | 1165 * |
1150 * This is often represented as a dialog with a button for each action. | 1166 * This is often represented as a dialog with a button for each action. |
1151 * | 1167 * |
1152 * @param handle The plugin or connection handle. | 1168 * @param handle The plugin or connection handle. For some |
1169 * things this is EXTREMELY important. See | |
1170 * the comments on gaim_request_input. | |
1153 * @param title The title of the message. | 1171 * @param title The title of the message. |
1154 * @param primary The main point of the message. | 1172 * @param primary The main point of the message. |
1155 * @param secondary The secondary information. | 1173 * @param secondary The secondary information. |
1156 * @param default_action The default value. | 1174 * @param default_action The default value. |
1157 * @param user_data The data to pass to the callback. | 1175 * @param user_data The data to pass to the callback. |
1168 /** | 1186 /** |
1169 * Prompts the user for an action. | 1187 * Prompts the user for an action. |
1170 * | 1188 * |
1171 * This is often represented as a dialog with a button for each action. | 1189 * This is often represented as a dialog with a button for each action. |
1172 * | 1190 * |
1173 * @param handle The plugin or connection handle. | 1191 * @param handle The plugin or connection handle. For some |
1192 * things this is EXTREMELY important. See | |
1193 * the comments on gaim_request_input. | |
1174 * @param title The title of the message. | 1194 * @param title The title of the message. |
1175 * @param primary The main point of the message. | 1195 * @param primary The main point of the message. |
1176 * @param secondary The secondary information. | 1196 * @param secondary The secondary information. |
1177 * @param default_action The default value. | 1197 * @param default_action The default value. |
1178 * @param user_data The data to pass to the callback. | 1198 * @param user_data The data to pass to the callback. |
1188 va_list actions); | 1208 va_list actions); |
1189 | 1209 |
1190 /** | 1210 /** |
1191 * Displays groups of fields for the user to fill in. | 1211 * Displays groups of fields for the user to fill in. |
1192 * | 1212 * |
1193 * @param handle The plugin or connection handle. | 1213 * @param handle The plugin or connection handle. For some |
1214 * things this is EXTREMELY important. See | |
1215 * the comments on gaim_request_input. | |
1194 * @param title The title of the message. | 1216 * @param title The title of the message. |
1195 * @param primary The main point of the message. | 1217 * @param primary The main point of the message. |
1196 * @param secondary The secondary information. | 1218 * @param secondary The secondary information. |
1197 * @param fields The list of fields. | 1219 * @param fields The list of fields. |
1198 * @param ok_text The text for the OK button. | 1220 * @param ok_text The text for the OK button. |
1255 | 1277 |
1256 /** | 1278 /** |
1257 * Displays a file selector request dialog. Returns the selected filename into | 1279 * Displays a file selector request dialog. Returns the selected filename into |
1258 * the callback. Can be used for either opening a file or saving a file. | 1280 * the callback. Can be used for either opening a file or saving a file. |
1259 * | 1281 * |
1260 * @param handle The plugin or connection handle. | 1282 * @param handle The plugin or connection handle. For some |
1283 * things this is EXTREMELY important. See | |
1284 * the comments on gaim_request_input. | |
1261 * @param title The title for the dialog (may be NULL) | 1285 * @param title The title for the dialog (may be NULL) |
1262 * @param filename The default filename (may be NULL) | 1286 * @param filename The default filename (may be NULL) |
1263 * @param savedialog True if this dialog is being used to save a file. | 1287 * @param savedialog True if this dialog is being used to save a file. |
1264 * False if it is being used to open a file. | 1288 * False if it is being used to open a file. |
1265 * @param ok_cb The callback for the OK button. | 1289 * @param ok_cb The callback for the OK button. |