2 * Definitions for implementation of preference handling routines;
3 * used by "friends" of the preferences type.
7 * Ethereal - Network traffic analyzer
8 * By Gerald Combs <gerald@ethereal.com>
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 notebook) */
32 gboolean is_subtree; /* if TRUE, this has other modules, not preferences, under it */
33 void (*apply_cb)(void); /* routine to call when preferences applied */
34 GList *prefs; /* list of its preferences or submodules */
35 int numprefs; /* number of non-obsolete preferences */
36 gboolean prefs_changed; /* if TRUE, a preference has changed since we last checked */
37 gboolean obsolete; /* if TRUE, this is a module that used to
38 exist but no longer does */
42 * Module used for protocol preferences. With MSVC and a
43 * libethereal.dll, we need a special declaration.
45 ETH_VAR_IMPORT module_t *protocols_module;
48 * PREF_OBSOLETE is used for preferences that a module used to support
49 * but no longer supports; we give different error messages for them.
60 const char *name; /* name of preference */
61 const char *title; /* title to use in GUI */
62 const char *description; /* human-readable description of preference */
63 int ordinal; /* ordinal number of this preference */
64 pref_type_t type; /* type of that preference */
70 } varp; /* pointer to variable storing the value */
76 } saved_val; /* original value, when editing from the GUI */
78 guint base; /* input/output base, for PREF_UINT */
80 const enum_val_t *enumvals; /* list of name & values */
81 gboolean radio_buttons; /* TRUE if it should be shown as
82 radio buttons rather than as an
83 option menu or combo box in
84 the preferences tab */
85 } enum_info; /* for PREF_ENUM */
86 } info; /* display/text file information */
87 void *control; /* handle for GUI control for this preference */
90 gint find_val_for_string(const char *needle, const enum_val_t *haystack,
94 /* read_prefs_file: read in a generic config file and do a callback to */
95 /* pref_set_pair_fct() for every key/value pair found */
96 typedef int (*pref_set_pair_cb) (gchar *key, gchar *value);
99 read_prefs_file(const char *pf_path, FILE *pf, pref_set_pair_cb pref_set_pair_fct);
103 #endif /* prefs-int.h */