ui/recent_utils.h

   1 /** @file
   2  *
   3  * Routines called to write stuff to the recent file; their implementations
   4  * are GUI-dependent, but the API's aren't
   5  *
   6  * Wireshark - Network traffic analyzer
   7  * By Gerald Combs <gerald@wireshark.org>
   8  * Copyright 1998 Gerald Combs
   9  *
  10  * SPDX-License-Identifier: GPL-2.0-or-later
  11  */
  12
  13 #ifndef __UI_RECENT_UTILS_H__
  14 #define __UI_RECENT_UTILS_H__
  15
  16 #ifdef __cplusplus
  17 extern "C" {
  18 #endif /* __cplusplus */
  19
  20 /** Add a new recent capture filename to the "Recent Files" submenu
  21  *  (duplicates will be ignored)
  22  *
  23  * @param cf_name  Capture filename to add
  24  * @param force  If true, then prefs.gui_recent_file_count_max will be
  25  * ignored when adding the file. This is for startup, when the recent_common
  26  * file is read before the prefs file. (It will be corrected later when
  27  * prefs are read.)
  28  */
  29 extern void add_menu_recent_capture_file(const char *cf_name, bool force);
  30
  31 /** Write all recent capture filenames to the user's recent file.
  32  * @param rf recent file
  33  */
  34 extern void menu_recent_file_write_all(FILE *rf);
  35
  36 /** Write all non-empty capture filters (until maximum count)
  37  *  of the combo box GList to the user's recent file.
  38  *
  39  * @param rf the recent file
  40  */
  41 extern void cfilter_combo_recent_write_all(FILE *rf);
  42
  43 /** Add a display filter coming from the user's recent file to the dfilter combo box.
  44  *
  45  * @param dftext the filter string
  46  */
  47 extern bool dfilter_combo_add_recent(const char *dftext);
  48
  49 /** Write all non-empty display filters (until maximum count)
  50  *  of the combo box GList to the user's recent file.
  51  *
  52  * @param rf the recent file
  53  */
  54 extern void dfilter_recent_combo_write_all(FILE *rf);
  55
  56 #ifdef __cplusplus
  57 }
  58 #endif /* __cplusplus */
  59
  60 #endif /* __UI_RECENT_UTILS_H__ */