2 * Definitions for implementation of preference handling routines;
3 * used by "friends" of the preferences type.
7 * Wireshark - Network traffic analyzer
8 * By Gerald Combs <gerald@wireshark.org>
9 * Copyright 1998 Gerald Combs
11 * This program is free software; you can redistribute it and/or
12 * modify it under the terms of the GNU General Public License
13 * as published by the Free Software Foundation; either version 2
14 * of the License, or (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, write to the Free Software
23 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
26 #ifndef __PREFS_INT_H__
27 #define __PREFS_INT_H__
30 const char *name; /* name of module */
31 const char *title; /* title of module (displayed in preferences list) */
32 const char *description;/* Description of module (displayed in preferences notebook) */
33 gboolean is_subtree; /* if TRUE, this has other modules, not preferences, under it */
34 void (*apply_cb)(void); /* routine to call when preferences applied */
35 GList *prefs; /* list of its preferences or submodules */
36 int numprefs; /* number of non-obsolete preferences */
37 gboolean prefs_changed; /* if TRUE, a preference has changed since we last checked */
38 gboolean obsolete; /* if TRUE, this is a module that used to
39 exist but no longer does */
43 * Module used for protocol preferences.
44 * With MSVC and a libwireshark.dll, we need a special declaration.
46 WS_VAR_IMPORT module_t *protocols_module;
49 * PREF_OBSOLETE is used for preferences that a module used to support
50 * but no longer supports; we give different error messages for them.
63 const char *name; /* name of preference */
64 const char *title; /* title to use in GUI */
65 const char *description; /* human-readable description of preference */
66 int ordinal; /* ordinal number of this preference */
67 pref_type_t type; /* type of that preference */
74 } varp; /* pointer to variable storing the value */
81 } saved_val; /* original value, when editing from the GUI */
83 guint base; /* input/output base, for PREF_UINT */
84 guint32 max_value; /* maximum value of a range */
86 const enum_val_t *enumvals; /* list of name & values */
87 gboolean radio_buttons; /* TRUE if it should be shown as
88 radio buttons rather than as an
89 option menu or combo box in
90 the preferences tab */
91 } enum_info; /* for PREF_ENUM */
92 } info; /* display/text file information */
93 void *control; /* handle for GUI control for this preference */
96 gint find_val_for_string(const char *needle, const enum_val_t *haystack,
100 /* read_prefs_file: read in a generic config file and do a callback to */
101 /* pref_set_pair_fct() for every key/value pair found */
102 typedef prefs_set_pref_e (*pref_set_pair_cb) (gchar *key, gchar *value, void *private_data);
105 read_prefs_file(const char *pf_path, FILE *pf, pref_set_pair_cb pref_set_pair_fct, void *private_data);
109 #endif /* prefs-int.h */