MetaEnumPreference Struct Reference

The details of one preference which is constrained to be one of a small number of string values-- in other words, an enumeration. More...

Data Fields
gchar *	key
MetaPreference	pref
GConfEnumStringPair *	symtab
gpointer	target

---

Detailed Description

The details of one preference which is constrained to be one of a small number of string values-- in other words, an enumeration.

We could have done this other ways. One particularly attractive possibility would have been to represent the entire symbol table as a space-separated string literal in the list of symtabs, so the focus mode enums could have been represented simply by "click sloppy mouse". However, the simplicity gained would have been outweighed by the bugs caused when the ordering of the enum strings got out of sync with the actual enum statement. Also, there is existing library code to use this kind of symbol tables.

Other things we might consider doing to clean this up in the future include:

• most of the keys begin with the same prefix, and perhaps we could assume it if they don't start with a slash

• there are several cases where a single identifier could be used to generate an entire entry, and perhaps this could be done with a macro. (This would reduce clarity, however, and is probably a bad thing.)

• these types all begin with a gchar* (and contain a MetaPreference) and we can factor out the repeated code in the handlers by taking advantage of this using some kind of union arrangement.

Definition at line 243 of file prefs.c.

---

Field Documentation

gchar* MetaEnumPreference::key

Definition at line 245 of file prefs.c.

Referenced by handle_preference_init_enum(), and handle_preference_update_enum().

MetaPreference MetaEnumPreference::pref

Definition at line 246 of file prefs.c.

Referenced by handle_preference_update_enum().

GConfEnumStringPair* MetaEnumPreference::symtab

Definition at line 247 of file prefs.c.

Referenced by handle_preference_init_enum(), and handle_preference_update_enum().

gpointer MetaEnumPreference::target

Definition at line 248 of file prefs.c.

Referenced by handle_preference_init_enum(), and handle_preference_update_enum().

---

The documentation for this struct was generated from the following file:

• src/core/prefs.c