| 353 /** |
353 /** |
| 354 * Add autocompletion of screenames to an entry, supporting a filtering function. |
354 * Add autocompletion of screenames to an entry, supporting a filtering function. |
| 355 * |
355 * |
| 356 * @param entry The GtkEntry on which to setup autocomplete. |
356 * @param entry The GtkEntry on which to setup autocomplete. |
| 357 * @param optmenu A menu for accounts, returned by gaim_gtk_account_option_menu_new(). |
357 * @param optmenu A menu for accounts, returned by gaim_gtk_account_option_menu_new(). |
| 358 * If @a optmenu is not @c NULL, it'll be updated when a screenname is chosen |
358 * If @a optmenu is not @c NULL, it'll be updated when a username is chosen |
| 359 * from the autocomplete list. |
359 * from the autocomplete list. |
| 360 * @param filter_func A function for checking if an autocomplete entry |
360 * @param filter_func A function for checking if an autocomplete entry |
| 361 * should be shown. This can be @c NULL. |
361 * should be shown. This can be @c NULL. |
| 362 * @param user_data The data to be passed to the filter_func function. |
362 * @param user_data The data to be passed to the filter_func function. |
| 363 */ |
363 */ |
| 364 void pidgin_setup_screenname_autocomplete_with_filter(GtkWidget *entry, GtkWidget *optmenu, PidginFilterBuddyCompletionEntryFunc filter_func, gpointer user_data); |
364 void pidgin_setup_screenname_autocomplete_with_filter(GtkWidget *entry, GtkWidget *optmenu, PidginFilterBuddyCompletionEntryFunc filter_func, gpointer user_data); |
| 365 |
365 |
| 366 /** |
366 /** |
| 367 * The default filter function for screenname autocomplete. |
367 * The default filter function for username autocomplete. |
| 368 * |
368 * |
| 369 * @param completion_entry The completion entry to filter. |
369 * @param completion_entry The completion entry to filter. |
| 370 * @param all_accounts If this is @c FALSE, only the autocompletion entries |
370 * @param all_accounts If this is @c FALSE, only the autocompletion entries |
| 371 * which belong to an online account will be filtered. |
371 * which belong to an online account will be filtered. |
| 372 * @return Returns @c TRUE if the autocompletion entry is filtered. |
372 * @return Returns @c TRUE if the autocompletion entry is filtered. |
| 383 * all)</tt>) |
383 * all)</tt>) |
| 384 * |
384 * |
| 385 * @param entry The GtkEntry on which to setup autocomplete. |
385 * @param entry The GtkEntry on which to setup autocomplete. |
| 386 * @param optmenu A menu for accounts, returned by |
386 * @param optmenu A menu for accounts, returned by |
| 387 * pidgin_account_option_menu_new(). If @a optmenu is not @c |
387 * pidgin_account_option_menu_new(). If @a optmenu is not @c |
| 388 * NULL, it'll be updated when a screenname is chosen from the |
388 * NULL, it'll be updated when a username is chosen from the |
| 389 * autocomplete list. |
389 * autocomplete list. |
| 390 * @param all Whether to include screennames from disconnected accounts. |
390 * @param all Whether to include usernames from disconnected accounts. |
| 391 */ |
391 */ |
| 392 void pidgin_setup_screenname_autocomplete(GtkWidget *entry, GtkWidget *optmenu, gboolean all); |
392 void pidgin_setup_screenname_autocomplete(GtkWidget *entry, GtkWidget *optmenu, gboolean all); |
| 393 |
393 |
| 394 /** |
394 /** |
| 395 * Check if the given path is a directory or not. If it is, then modify |
395 * Check if the given path is a directory or not. If it is, then modify |