Evolution-Data-Server Manual: Graphical Utilities (libedataserverui) | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Signals |
Synopsis
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
);
Details
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
.
|
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.
|
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
.
|
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.
|
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 NULL if undesired. |
|
location in which to store a pointer to the EDestinationStore being used
by the section, or NULL if undesired |
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
.
|
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 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
.
|
an ENameSelectorModel |
|
internal name of the section to remove |
e_name_selector_model_get_contact_emails_without_used ()
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 TRUE to remove used from a list; or set to FALSE to
set used indexes to NULL and 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 with e_name_selector_model_free_emails_list . |
Since 2.30
e_name_selector_model_free_emails_list ()
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
Signal Details
The "section-added"
signal
void user_function (ENameSelectorModel *enameselectormodel,
gchar *arg1,
gpointer user_data) : Run Last
The "section-removed"
signal
void user_function (ENameSelectorModel *enameselectormodel,
gchar *arg1,
gpointer user_data) : Run Last