|  |  |  | Evolution Utilities Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Signals | ||||
struct 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); GList * e_name_selector_model_get_contact_emails_without_used (ENameSelectorModel *name_selector_model,EContact *contact,gboolean remove_used); void e_name_selector_model_free_emails_list (GList *email_list);
ENameSelectorModel * e_name_selector_model_new          (void);
Creates a new ENameSelectorModel.
| Returns : | A new ENameSelectorModel. | 
EContactStore *     e_name_selector_model_peek_contact_store
                                                        (ENameSelectorModel *name_selector_model);
Gets the EContactStore associated with name_selector_model.
| 
 | an ENameSelectorModel | 
| Returns : | An EContactStore. | 
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.
| 
 | an ENameSelectorModel | 
| Returns : | An ETreeModelGenerator. | 
GList *             e_name_selector_model_list_sections (ENameSelectorModel *name_selector_model);
Gets a list of the destination sections in 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. | 
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.
| 
 | an ENameSelectorModel | 
| 
 | internal name of the section to peek | 
| 
 | location in which to store a pointer to the user-visible name of the section,
or NULLif undesired. | 
| 
 | location in which to store a pointer to the EDestinationStore being used
by the section, or NULLif undesired | 
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.
| 
 | an ENameSelectorModel | 
| 
 | internal name of this section | 
| 
 | user-visible name of this section | 
| 
 | the EDestinationStore to use to store the destinations for this
section, or NULLifname_selector_modelshould create its own. | 
void e_name_selector_model_remove_section (ENameSelectorModel *name_selector_model,const gchar *name);
Removes a destination section from name_selector_model.
| 
 | an ENameSelectorModel | 
| 
 | internal name of the section to remove | 
GList * e_name_selector_model_get_contact_emails_without_used (ENameSelectorModel *name_selector_model,EContact *contact,gboolean remove_used);
| 
 | an ENameSelectorModel | 
| 
 | to get emails from | 
| 
 | set to TRUEto remove used from a list; or set toFALSEto
set used indexes toNULLand keep them in the returned list | 
| Returns : | list of all email from contact, without all used
in any section. Each item is a string, an email address.
Returned list should be freed withe_name_selector_model_free_emails_list. | 
Since 2.30
void                e_name_selector_model_free_emails_list
                                                        (GList *email_list);
Frees a list of emails returned from e_name_selector_model_get_contact_emails_without_used.
| 
 | list of emails returned from e_name_selector_model_get_contact_emails_without_used | 
Since 2.30
"section-added" signalvoid                user_function                      (ENameSelectorModel *enameselectormodel,
                                                        gchar              *arg1,
                                                        gpointer            user_data)               : Run Last
"section-removed" signalvoid                user_function                      (ENameSelectorModel *enameselectormodel,
                                                        gchar              *arg1,
                                                        gpointer            user_data)               : Run Last