Commit 6ed5d64c authored by Michael Natterer's avatar Michael Natterer 😴 Committed by Michael Natterer
Browse files

some cleanup and API docs.

2005-07-02  Michael Natterer  <mitch@gimp.org>

	* libgimpwidgets/gimppageselector.c: some cleanup and API docs.
parent ee4de85c
2005-07-02 Michael Natterer <mitch@gimp.org>
* libgimpwidgets/gimppageselector.c: some cleanup and API docs.
2005-07-01 Nathan Summers <rock@gimp.org> 2005-07-01 Nathan Summers <rock@gimp.org>
* app/batch.c * app/batch.c
* app/config/gimprc-blurbs.h * app/config/gimprc-blurbs.h
* app/core/gimpimage-convert.c * app/core/gimpimage-convert.c
* app/dialogs/user-install-dialog.c: grammar and other pedantic string * app/dialogs/user-install-dialog.c: grammar and other pedantic string
changes. changes.
2005-07-01 Sven Neumann <sven@gimp.org> 2005-07-01 Sven Neumann <sven@gimp.org>
......
...@@ -79,6 +79,8 @@ static gboolean gimp_page_selector_range_focus_out (GtkEntry *entry, ...@@ -79,6 +79,8 @@ static gboolean gimp_page_selector_range_focus_out (GtkEntry *entry,
GimpPageSelector *selector); GimpPageSelector *selector);
static void gimp_page_selector_range_activate (GtkEntry *entry, static void gimp_page_selector_range_activate (GtkEntry *entry,
GimpPageSelector *selector); GimpPageSelector *selector);
static gint gimp_page_selector_int_compare (gconstpointer a,
gconstpointer b);
static void gimp_page_selector_print_range (GString *string, static void gimp_page_selector_print_range (GString *string,
gint start, gint start,
gint end); gint end);
...@@ -147,7 +149,7 @@ gimp_page_selector_class_init (GimpPageSelectorClass *klass) ...@@ -147,7 +149,7 @@ gimp_page_selector_class_init (GimpPageSelectorClass *klass)
* The number of pages of the document to open. * The number of pages of the document to open.
* *
* Since: GIMP 2.4 * Since: GIMP 2.4
*/ **/
g_object_class_install_property (object_class, PROP_N_PAGES, g_object_class_install_property (object_class, PROP_N_PAGES,
g_param_spec_int ("n-pages", NULL, NULL, g_param_spec_int ("n-pages", NULL, NULL,
0, G_MAXINT, 0, 0, G_MAXINT, 0,
...@@ -159,7 +161,7 @@ gimp_page_selector_class_init (GimpPageSelectorClass *klass) ...@@ -159,7 +161,7 @@ gimp_page_selector_class_init (GimpPageSelectorClass *klass)
* The target to open the document to. * The target to open the document to.
* *
* Since: GIMP 2.4 * Since: GIMP 2.4
*/ **/
g_object_class_install_property (object_class, PROP_TARGET, g_object_class_install_property (object_class, PROP_TARGET,
g_param_spec_enum ("target", NULL, NULL, g_param_spec_enum ("target", NULL, NULL,
GIMP_TYPE_PAGE_SELECTOR_TARGET, GIMP_TYPE_PAGE_SELECTOR_TARGET,
...@@ -456,6 +458,13 @@ gimp_page_selector_get_n_pages (GimpPageSelector *selector) ...@@ -456,6 +458,13 @@ gimp_page_selector_get_n_pages (GimpPageSelector *selector)
return selector->n_pages; return selector->n_pages;
} }
/**
* gimp_page_selector_set_target:
* @selector: Pointer to a #GimpPageSelector.
* @target: How to open the selected pages.
*
* Since: GIMP 2.4
**/
void void
gimp_page_selector_set_target (GimpPageSelector *selector, gimp_page_selector_set_target (GimpPageSelector *selector,
GimpPageSelectorTarget target) GimpPageSelectorTarget target)
...@@ -472,6 +481,14 @@ gimp_page_selector_set_target (GimpPageSelector *selector, ...@@ -472,6 +481,14 @@ gimp_page_selector_set_target (GimpPageSelector *selector,
} }
} }
/**
* gimp_page_selector_get_target:
* @selector: Pointer to a #GimpPageSelector.
*
* Returns: How the selected pages should be opened.
*
* Since: GIMP 2.4
**/
GimpPageSelectorTarget GimpPageSelectorTarget
gimp_page_selector_get_target (GimpPageSelector *selector) gimp_page_selector_get_target (GimpPageSelector *selector)
{ {
...@@ -487,6 +504,8 @@ gimp_page_selector_get_target (GimpPageSelector *selector) ...@@ -487,6 +504,8 @@ gimp_page_selector_get_target (GimpPageSelector *selector)
* @page_no: The number of the page to set the thumbnail for. * @page_no: The number of the page to set the thumbnail for.
* @thumbnail: The thumbnail pixbuf. * @thumbnail: The thumbnail pixbuf.
* *
* Sets the thumbnail for given %page_no. A default "page" icon will
* be used if no page thumbnail is set.
* *
* Since: GIMP 2.4 * Since: GIMP 2.4
**/ **/
...@@ -516,13 +535,15 @@ gimp_page_selector_set_page_thumbnail (GimpPageSelector *selector, ...@@ -516,13 +535,15 @@ gimp_page_selector_set_page_thumbnail (GimpPageSelector *selector,
* @selector: Pointer to a #GimpPageSelector. * @selector: Pointer to a #GimpPageSelector.
* @page_no: The number of the page to get the thumbnail for. * @page_no: The number of the page to get the thumbnail for.
* *
* Returns: The page's thumbnail, or %NULL if none is set. * Returns: The page's thumbnail, or %NULL if none is set. The returned
* pixbuf is owned by #GimpPageSelector and must not be
* unref'ed when no longer needed.
* *
* Since: GIMP 2.4 * Since: GIMP 2.4
**/ **/
GdkPixbuf * GdkPixbuf *
gimp_page_selector_get_page_thumbnail (GimpPageSelector *selector, gimp_page_selector_get_page_thumbnail (GimpPageSelector *selector,
gint page_no) gint page_no)
{ {
GdkPixbuf *thumbnail; GdkPixbuf *thumbnail;
GtkTreeIter iter; GtkTreeIter iter;
...@@ -586,7 +607,9 @@ gimp_page_selector_set_page_label (GimpPageSelector *selector, ...@@ -586,7 +607,9 @@ gimp_page_selector_set_page_label (GimpPageSelector *selector,
* @selector: Pointer to a #GimpPageSelector. * @selector: Pointer to a #GimpPageSelector.
* @page_no: The number of the page to get the thumbnail for. * @page_no: The number of the page to get the thumbnail for.
* *
* Returns: The page's label, or %NULL if none is set. * Returns: The page's label, or %NULL if none is set. This is a newly
* allocated string that should be g_free()'d when no longer
* needed.
* *
* Since: GIMP 2.4 * Since: GIMP 2.4
**/ **/
...@@ -611,7 +634,7 @@ gimp_page_selector_get_page_label (GimpPageSelector *selector, ...@@ -611,7 +634,7 @@ gimp_page_selector_get_page_label (GimpPageSelector *selector,
if (! label_set) if (! label_set)
{ {
g_free (label); g_free (label);
return NULL; label = NULL;
} }
return label; return label;
...@@ -737,13 +760,6 @@ gimp_page_selector_page_is_selected (GimpPageSelector *selector, ...@@ -737,13 +760,6 @@ gimp_page_selector_page_is_selected (GimpPageSelector *selector,
return selected; return selected;
} }
static gint
gimp_page_selector_int_compare (gconstpointer a,
gconstpointer b)
{
return *(gint*) a - *(gint*) b;
}
/** /**
* gimp_page_selector_get_selected_pages: * gimp_page_selector_get_selected_pages:
* @selector: Pointer to a #GimpPageSelector. * @selector: Pointer to a #GimpPageSelector.
...@@ -790,7 +806,15 @@ gimp_page_selector_get_selected_pages (GimpPageSelector *selector, ...@@ -790,7 +806,15 @@ gimp_page_selector_get_selected_pages (GimpPageSelector *selector,
/** /**
* gimp_page_selector_select_range: * gimp_page_selector_select_range:
* @selector: Pointer to a #GimpPageSelector. * @selector: Pointer to a #GimpPageSelector.
* @range: * @range: A string representing the set of selected pages.
*
* Selectes the pages described by %range. The range string is a
* user-editable list of pages and ranges, e.g. "1,3,5-7,9-12,14".
* Note that the page numbering in the range string starts with 1,
* not 0.
*
* Invalid pages and ranges will be silently ignored, duplicate and
* overlapping pages and ranges will be merged.
* *
* Since: GIMP 2.4 * Since: GIMP 2.4
**/ **/
...@@ -871,7 +895,9 @@ gimp_page_selector_select_range (GimpPageSelector *selector, ...@@ -871,7 +895,9 @@ gimp_page_selector_select_range (GimpPageSelector *selector,
* gimp_page_selector_get_selected_range: * gimp_page_selector_get_selected_range:
* @selector: Pointer to a #GimpPageSelector. * @selector: Pointer to a #GimpPageSelector.
* *
* Returns: A newly allocated string. * Returns: A newly allocated string representing the set of selected
* pages. See gimp_page_selector_set_selected_range() for the
* format of the string.
* *
* Since: GIMP 2.4 * Since: GIMP 2.4
**/ **/
...@@ -921,6 +947,7 @@ gimp_page_selector_get_selected_range (GimpPageSelector *selector) ...@@ -921,6 +947,7 @@ gimp_page_selector_get_selected_range (GimpPageSelector *selector)
return g_string_free (string, FALSE); return g_string_free (string, FALSE);
} }
/* private functions */ /* private functions */
static void static void
...@@ -955,6 +982,13 @@ gimp_page_selector_range_activate (GtkEntry *entry, ...@@ -955,6 +982,13 @@ gimp_page_selector_range_activate (GtkEntry *entry,
gimp_page_selector_select_range (selector, gtk_entry_get_text (entry)); gimp_page_selector_select_range (selector, gtk_entry_get_text (entry));
} }
static gint
gimp_page_selector_int_compare (gconstpointer a,
gconstpointer b)
{
return *(gint*)a - *(gint*)b;
}
static void static void
gimp_page_selector_print_range (GString *string, gimp_page_selector_print_range (GString *string,
gint start, gint start,
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment