| Top |  |
 |
 |
 |
Functions
Object Hierarchy
GObject ╰── GInitiallyUnowned ╰── GtkObject ╰── GtkWidget ╰── GtkContainer ╰── GtkBox ╰── GimpPageSelector
Implemented Interfaces
GimpPageSelector implements AtkImplementorIface, GtkBuildable and GtkOrientable.
Functions
gimp_page_selector_new ()
GtkWidget *
gimp_page_selector_new (void);
Creates a new GimpPageSelector widget.
Since: 2.4
gimp_page_selector_set_n_pages ()
void gimp_page_selector_set_n_pages (GimpPageSelector *selector,gint n_pages);
Sets the number of pages in the document to open.
Since: 2.4
gimp_page_selector_get_n_pages ()
gint
gimp_page_selector_get_n_pages (GimpPageSelector *selector);
Since: 2.4
gimp_page_selector_set_target ()
void gimp_page_selector_set_target (GimpPageSelector *selector,GimpPageSelectorTarget target);
Since: 2.4
gimp_page_selector_get_target ()
GimpPageSelectorTarget
gimp_page_selector_get_target (GimpPageSelector *selector);
Since: 2.4
gimp_page_selector_set_page_thumbnail ()
void gimp_page_selector_set_page_thumbnail (GimpPageSelector *selector,gint page_no,GdkPixbuf *thumbnail);
Sets the thumbnail for given page_no
. A default "page" icon will
be used if no page thumbnail is set.
Parameters
selector |
Pointer to a GimpPageSelector. |
|
page_no |
The number of the page to set the thumbnail for. |
|
thumbnail |
The thumbnail pixbuf. |
Since: 2.4
gimp_page_selector_get_page_thumbnail ()
GdkPixbuf * gimp_page_selector_get_page_thumbnail (GimpPageSelector *selector,gint page_no);
Parameters
selector |
Pointer to a GimpPageSelector. |
|
page_no |
The number of the page to get the thumbnail for. |
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: 2.4
gimp_page_selector_set_page_label ()
void gimp_page_selector_set_page_label (GimpPageSelector *selector,gint page_no,const gchar *label);
Sets the label of the specified page.
Parameters
selector |
Pointer to a GimpPageSelector. |
|
page_no |
The number of the page to set the label for. |
|
label |
The label. |
Since: 2.4
gimp_page_selector_get_page_label ()
gchar * gimp_page_selector_get_page_label (GimpPageSelector *selector,gint page_no);
Parameters
selector |
Pointer to a GimpPageSelector. |
|
page_no |
The number of the page to get the thumbnail for. |
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: 2.4
gimp_page_selector_select_all ()
void
gimp_page_selector_select_all (GimpPageSelector *selector);
Selects all pages.
Since: 2.4
gimp_page_selector_unselect_all ()
void
gimp_page_selector_unselect_all (GimpPageSelector *selector);
Unselects all pages.
Since: 2.4
gimp_page_selector_select_page ()
void gimp_page_selector_select_page (GimpPageSelector *selector,gint page_no);
Adds a page to the selection.
Since: 2.4
gimp_page_selector_unselect_page ()
void gimp_page_selector_unselect_page (GimpPageSelector *selector,gint page_no);
Removes a page from the selection.
Since: 2.4
gimp_page_selector_page_is_selected ()
gboolean gimp_page_selector_page_is_selected (GimpPageSelector *selector,gint page_no);
Since: 2.4
gimp_page_selector_get_selected_pages ()
gint * gimp_page_selector_get_selected_pages (GimpPageSelector *selector,gint *n_selected_pages);
Parameters
selector |
Pointer to a GimpPageSelector. |
|
n_selected_pages |
Returns the number of selected pages. |
Returns
A sorted array of page numbers of selected pages. Use g_free() if
you don't need the array any longer.
Since: 2.4
gimp_page_selector_select_range ()
void gimp_page_selector_select_range (GimpPageSelector *selector,const gchar *range);
Selects 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.
Parameters
selector |
Pointer to a GimpPageSelector. |
|
range |
A string representing the set of selected pages. |
Since: 2.4
gimp_page_selector_get_selected_range ()
gchar *
gimp_page_selector_get_selected_range (GimpPageSelector *selector);
Returns
A newly allocated string representing the set of selected
pages. See gimp_page_selector_select_range() for the
format of the string.
Since: 2.4
Property Details
The “n-pages” property
“n-pages” gint
The number of pages of the document to open.
Owner: GimpPageSelector
Flags: Read / Write
Allowed values: >= 0
Default value: 0
Since: 2.4
The “target” property
“target” GimpPageSelectorTarget
The target to open the document to.
Owner: GimpPageSelector
Flags: Read / Write
Default value: GIMP_PAGE_SELECTOR_TARGET_LAYERS
Since: 2.4
Signal Details
The “activate” signal
void user_function (GimpPageSelector *widget, gpointer user_data)
The "activate" signal on GimpPageSelector is an action signal. It is emitted when a user double-clicks an item in the page selection.
Parameters
widget |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Action
Since: 2.4
The “selection-changed” signal
void user_function (GimpPageSelector *widget, gpointer user_data)
This signal is emitted whenever the set of selected pages changes.
Parameters
widget |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First
Since: 2.4