## ENameSelectorModel ENameSelectorModel — |

## Synopsis

    typedef     ENameSelectorModel;
    ENameSelectorModel* e_name_selector_model_new
                                                (void);
    EContactStore* e_name_selector_model_peek_contact_store
                                                (ENameSelectorModel *name_selector_model);
    ETreeModelGenerator* e_name_selector_model_peek_contact_filter
                                                (ENameSelectorModel *name_selector_model);
    GList*      e_name_selector_model_list_sections
                                                (ENameSelectorModel *name_selector_model);
    gboolean    e_name_selector_model_peek_section
                                                (ENameSelectorModel *name_selector_model,
                                                 const gchar *name,
                                                 gchar **pretty_name,
                                                 EDestinationStore **destination_store);
    void        e_name_selector_model_add_section
                                                (ENameSelectorModel *name_selector_model,
                                                 const gchar *name,
                                                 const gchar *pretty_name,
                                                 EDestinationStore *destination_store);
    void        e_name_selector_model_remove_section
                                                (ENameSelectorModel *name_selector_model,
                                                 const gchar *name);

## Object Hierarchy

      GObject
       +----ENameSelectorModel

## Signals

    "section-added"
                void        user_function      (ENameSelectorModel *enameselectormodel,
                                                gchar              *arg1,
                                                gpointer            user_data)               : Run last
    "section-removed"
                void        user_function      (ENameSelectorModel *enameselectormodel,
                                                gchar              *arg1,
                                                gpointer            user_data)               : Run last

## Description

## Details

### ENameSelectorModel

    typedef struct ENameSelectorModel       ENameSelectorModel;

### e_name_selector_model_new ()

    ENameSelectorModel* e_name_selector_model_new
                                                (void);

Creates a new ENameSelectorModel.

Returns : | A new ENameSelectorModel.

### e_name_selector_model_peek_contact_store ()

    EContactStore* e_name_selector_model_peek_contact_store
                                                (ENameSelectorModel *name_selector_model);

Gets the EContactStore associated with `name_selector_model`.

`name_selector_model` : | an ENameSelectorModel
Returns : | An EContactStore.

### e_name_selector_model_peek_contact_filter ()

    ETreeModelGenerator* e_name_selector_model_peek_contact_filter
                                                (ENameSelectorModel *name_selector_model);

Gets the ETreeModelGenerator being used to filter and/or extend the list of contacts in `name_selector_model`'s EContactStore.

`name_selector_model` : | an ENameSelectorModel
Returns : | An ETreeModelGenerator.

### e_name_selector_model_list_sections ()

    GList*      e_name_selector_model_list_sections
                                                (ENameSelectorModel *name_selector_model);

Gets a list of the destination sections in `name_selector_model`.

`name_selector_model` : | an ENameSelectorModel
Returns : | A GList of pointers to strings. The GList and the strings belong to the caller, and must be freed when no longer needed.

### e_name_selector_model_peek_section ()

    gboolean    e_name_selector_model_peek_section
                                                (ENameSelectorModel *name_selector_model,
                                                 const gchar *name,
                                                 gchar **pretty_name,
                                                 EDestinationStore **destination_store);

Gets the parameters for a destination section.

`name_selector_model` : | an ENameSelectorModel
`name` : | internal name of the section to peek
`pretty_name` : | location in which to store a pointer to the user-visible name of the section, or `NULL` if undesired.
`destination_store` : | location in which to store a pointer to the EDestinationStore being used by the section, or `NULL` if undesired
Returns : |

### e_name_selector_model_add_section ()

    void        e_name_selector_model_add_section
                                                (ENameSelectorModel *name_selector_model,
                                                 const gchar *name,
                                                 const gchar *pretty_name,
                                                 EDestinationStore *destination_store);

Adds a destination section to `name_selector_model`.

`name_selector_model` : | an ENameSelectorModel
`name` : | internal name of this section
`pretty_name` : | user-visible name of this section
`destination_store` : | the EDestinationStore to use to store the destinations for this section, or `NULL` if `name_selector_model` should create its own.

### e_name_selector_model_remove_section ()

    void        e_name_selector_model_remove_section
                                                (ENameSelectorModel *name_selector_model,
                                                 const gchar *name);

Removes a destination section from `name_selector_model`.

`name_selector_model` : | an ENameSelectorModel
`name` : | internal name of the section to remove

## Signal Details

### The "section-added" signal

    void        user_function                  (ENameSelectorModel *enameselectormodel,
                                                gchar              *arg1,
                                                gpointer            user_data)               : Run last

`enameselectormodel` : | the object which received the signal.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.

### The "section-removed" signal

    void        user_function                  (ENameSelectorModel *enameselectormodel,
                                                gchar              *arg1,
                                                gpointer            user_data)               : Run last

`enameselectormodel` : | the object which received the signal.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.