From c138ed493376f1e5bd35f1bfd688f7eb5863d022 Mon Sep 17 00:00:00 2001 From: Matthew Barnes Date: Fri, 2 Nov 2012 13:28:05 -0400 Subject: [PATCH] Update libedataserverui API documentation. --- .../libedataserverui/libedataserverui-sections.txt | 2 + libedataserverui/e-name-selector-dialog.c | 49 +++++++++++----------- libedataserverui/e-name-selector-dialog.h | 6 +-- 3 files changed, 30 insertions(+), 27 deletions(-) diff --git a/docs/reference/libedataserverui/libedataserverui-sections.txt b/docs/reference/libedataserverui/libedataserverui-sections.txt index cf5906a..7c5e089 100644 --- a/docs/reference/libedataserverui/libedataserverui-sections.txt +++ b/docs/reference/libedataserverui/libedataserverui-sections.txt @@ -225,6 +225,8 @@ e_name_selector_dialog_peek_model e_name_selector_dialog_set_model e_name_selector_dialog_set_destination_index e_name_selector_dialog_set_scrolling_policy +e_name_selector_dialog_get_section_visible +e_name_selector_dialog_set_section_visible E_NAME_SELECTOR_DIALOG E_IS_NAME_SELECTOR_DIALOG diff --git a/libedataserverui/e-name-selector-dialog.c b/libedataserverui/e-name-selector-dialog.c index aa3a939..3ebfcbc 100644 --- a/libedataserverui/e-name-selector-dialog.c +++ b/libedataserverui/e-name-selector-dialog.c @@ -1754,59 +1754,60 @@ e_name_selector_dialog_set_scrolling_policy (ENameSelectorDialog *name_selector_ } /** - * e_name_selector_dialog_set_section_visible: + * e_name_selector_dialog_get_section_visible: * @name_selector_dialog: an #ENameSelectorDialog * @name: name of the section - * @visible: whether to show or hide the section * - * Shows or hides section named @name in the dialog. + * Returns: whether section named @name is visible in the dialog. * * Since: 3.8 **/ -void -e_name_selector_dialog_set_section_visible (ENameSelectorDialog *name_selector_dialog, - const gchar *name, - gboolean visible) +gboolean +e_name_selector_dialog_get_section_visible (ENameSelectorDialog *name_selector_dialog, + const gchar *name) { Section *section; gint index; - g_return_if_fail (E_IS_NAME_SELECTOR_DIALOG (name_selector_dialog)); - g_return_if_fail (name != NULL); + g_return_val_if_fail (E_IS_NAME_SELECTOR_DIALOG (name_selector_dialog), FALSE); + g_return_val_if_fail (name != NULL, FALSE); index = find_section_by_name (name_selector_dialog, name); - g_return_if_fail (index != -1); + g_return_val_if_fail (index != -1, FALSE); section = &g_array_index (name_selector_dialog->priv->sections, Section, index); - - if (visible) - gtk_widget_show (GTK_WIDGET (section->section_box)); - else - gtk_widget_hide (GTK_WIDGET (section->section_box)); + return gtk_widget_get_visible (GTK_WIDGET (section->section_box)); } /** - * e_name_selector_dialog_get_section_visible: + * e_name_selector_dialog_set_section_visible: * @name_selector_dialog: an #ENameSelectorDialog * @name: name of the section + * @visible: whether to show or hide the section * - * Returns: whether section named @name is visible in the dialog. + * Shows or hides section named @name in the dialog. * * Since: 3.8 **/ -gboolean -e_name_selector_dialog_get_section_visible (ENameSelectorDialog *name_selector_dialog, - const gchar *name) +void +e_name_selector_dialog_set_section_visible (ENameSelectorDialog *name_selector_dialog, + const gchar *name, + gboolean visible) { Section *section; gint index; - g_return_val_if_fail (E_IS_NAME_SELECTOR_DIALOG (name_selector_dialog), FALSE); - g_return_val_if_fail (name != NULL, FALSE); + g_return_if_fail (E_IS_NAME_SELECTOR_DIALOG (name_selector_dialog)); + g_return_if_fail (name != NULL); index = find_section_by_name (name_selector_dialog, name); - g_return_val_if_fail (index != -1, FALSE); + g_return_if_fail (index != -1); section = &g_array_index (name_selector_dialog->priv->sections, Section, index); - return gtk_widget_get_visible (GTK_WIDGET (section->section_box)); + + if (visible) + gtk_widget_show (GTK_WIDGET (section->section_box)); + else + gtk_widget_hide (GTK_WIDGET (section->section_box)); } + diff --git a/libedataserverui/e-name-selector-dialog.h b/libedataserverui/e-name-selector-dialog.h index e670517..3d1e28c 100644 --- a/libedataserverui/e-name-selector-dialog.h +++ b/libedataserverui/e-name-selector-dialog.h @@ -87,13 +87,13 @@ void e_name_selector_dialog_set_scrolling_policy (ENameSelectorDialog *name_selector_dialog, GtkPolicyType hscrollbar_policy, GtkPolicyType vscrollbar_policy); +gboolean e_name_selector_dialog_get_section_visible + (ENameSelectorDialog *name_selector_dialog, + const gchar *name); void e_name_selector_dialog_set_section_visible (ENameSelectorDialog *name_selector_dialog, const gchar *name, gboolean visible); -gboolean e_name_selector_dialog_get_section_visible - (ENameSelectorDialog *name_selector_dialog, - const gchar *name); G_END_DECLS -- 2.7.4