Commit aa94434f authored by Sven Neumann's avatar Sven Neumann Committed by Sven Neumann

libgimp/gimpprocbrowserdialog.h libgimpwidgets/gimpbrowser.h

2005-09-27  Sven Neumann  <sven@gimp.org>

	* libgimp/gimpprocbrowserdialog.h
	* libgimpwidgets/gimpbrowser.h
	* libgimpwidgets/gimpdialog.h
	* libgimpwidgets/gimpintcombobox.h
	* libgimpwidgets/gimpoldwidgets.h
	* libgimpwidgets/gimpwidgets.h: use G_GNUC_NULL_TERMINATED where
	appropriate.

	* libgimp/gimpprocbrowserdialog.c
	* libgimpwidgets/gimpbrowser.c: added missing API docs.
parent 7863fe64
2005-09-27 Sven Neumann <sven@gimp.org>
* libgimp/gimpprocbrowserdialog.h
* libgimpwidgets/gimpbrowser.h
* libgimpwidgets/gimpdialog.h
* libgimpwidgets/gimpintcombobox.h
* libgimpwidgets/gimpoldwidgets.h
* libgimpwidgets/gimpwidgets.h: use G_GNUC_NULL_TERMINATED where
appropriate.
* libgimp/gimpprocbrowserdialog.c
* libgimpwidgets/gimpbrowser.c: added missing API docs.
2005-09-27 Sven Neumann <sven@gimp.org>
* libgimp/gimpprocbrowserdialog.[ch]: let
......
......@@ -42,6 +42,11 @@ GimpProcBrowserDialog
</para>
@title:
@role:
@help_func:
@help_id:
@Varargs:
@Returns:
......
......@@ -231,6 +231,20 @@ gimp_proc_browser_dialog_init (GimpProcBrowserDialog *dialog)
/* public functions */
/**
* gimp_proc_browser_dialog_new:
* @title: The dialog's title.
* @role: The dialog's role, see gtk_window_set_role().
* @help_func: The function which will be called if the user presses "F1".
* @help_id: The help_id which will be passed to @help_func.
* @...: A %NULL-terminated list destribing the action_area buttons.
*
* Create a new #GimpProcBrowserDialog.
*
* Return Value: a newly created #GimpProcBrowserDialog.
*
* Since: GIMP 2.4
**/
GtkWidget *
gimp_proc_browser_dialog_new (const gchar *title,
const gchar *role,
......@@ -255,12 +269,22 @@ gimp_proc_browser_dialog_new (const gchar *title,
va_end (args);
/* first search (all procedures) */
browser_search (GIMP_BROWSER (dialog->browser), "", SEARCH_TYPE_ALL,
dialog);
browser_search (GIMP_BROWSER (dialog->browser), "", SEARCH_TYPE_ALL, dialog);
return GTK_WIDGET (dialog);
}
/**
* gimp_proc_browser_dialog_get_selected:
* @dialog: a #GimpProcBrowserDialog
*
* Retrieves the name of the currently selected procedure.
*
* Return Value: The name of the selected procedure of %NULL if no
* procedure is selected.
*
* Since: GIMP 2.4
**/
gchar *
gimp_proc_browser_dialog_get_selected (GimpProcBrowserDialog *dialog)
{
......
......@@ -71,7 +71,7 @@ GtkWidget * gimp_proc_browser_dialog_new (const gchar *title,
const gchar *role,
GimpHelpFunc help_func,
const gchar *help_id,
...);
...) G_GNUC_NULL_TERMINATED;
gchar * gimp_proc_browser_dialog_get_selected (GimpProcBrowserDialog *dialog);
......
......@@ -186,12 +186,33 @@ gimp_browser_destroy (GtkObject *object)
/* public functions */
/**
* gimp_browser_new:
*
* Create a new #GimpBrowser widget.
*
* Return Value: a newly created #GimpBrowser.
*
* Since: GIMP 2.4
**/
GtkWidget *
gimp_browser_new (void)
{
return g_object_new (GIMP_TYPE_BROWSER, NULL);
}
/**
* gimp_browser_add_search_types:
* @browser: a #GimpBrowser widget
* @first_type_label: the label of the first search type
* @first_type_id: an integer that identifies the first search type
* @...: a %NULL-terminated list of more labels and ids.
*
* Populates the #GtkComboBox with search types.
*
* Since: GIMP 2.4
**/
void
gimp_browser_add_search_types (GimpBrowser *browser,
const gchar *first_type_label,
......@@ -238,6 +259,15 @@ gimp_browser_add_search_types (GimpBrowser *browser,
}
}
/**
* gimp_browser_set_widget:
* @browser: a #GimpBrowser widget
* @widget: a #GtkWidget
*
* Sets the widget to appear on the right side of the @browser.
*
* Since: GIMP 2.4
**/
void
gimp_browser_set_widget (GimpBrowser *browser,
GtkWidget *widget)
......@@ -262,6 +292,17 @@ gimp_browser_set_widget (GimpBrowser *browser,
}
}
/**
* gimp_browser_show_message:
* @browser: a #GimpBrowser widget
* @message: text message
*
* Displays @message in the right side of the @browser. Unless the right
* side already contains a #GtkLabel, the widget previously added with
* gimp_browser_set_widget() is removed and replaced by a #GtkLabel.
*
* Since: GIMP 2.4
**/
void
gimp_browser_show_message (GimpBrowser *browser,
const gchar *message)
......
......@@ -81,7 +81,7 @@ GtkWidget * gimp_browser_new (void);
void gimp_browser_add_search_types (GimpBrowser *browser,
const gchar *first_type_label,
gint first_type_id,
...);
...) G_GNUC_NULL_TERMINATED;
void gimp_browser_set_widget (GimpBrowser *browser,
GtkWidget *widget);
......
......@@ -65,7 +65,7 @@ GtkWidget * gimp_dialog_new (const gchar *title,
GtkDialogFlags flags,
GimpHelpFunc help_func,
const gchar *help_id,
...);
...) G_GNUC_NULL_TERMINATED;
GtkWidget * gimp_dialog_new_valist (const gchar *title,
const gchar *role,
......
......@@ -64,7 +64,7 @@ GType gimp_int_combo_box_get_type (void) G_GNUC_CONST;
GtkWidget * gimp_int_combo_box_new (const gchar *first_label,
gint first_value,
...);
...) G_GNUC_NULL_TERMINATED;
GtkWidget * gimp_int_combo_box_new_valist (const gchar *first_label,
gint first_value,
va_list values);
......
......@@ -47,7 +47,7 @@ GtkWidget * gimp_int_option_menu_new (gboolean menu_only,
* GtkWidget **widget_ptr,
*/
...);
...) G_GNUC_NULL_TERMINATED;
void gimp_int_option_menu_set_history (GtkOptionMenu *option_menu,
gint item_data);
......@@ -70,7 +70,7 @@ GtkWidget * gimp_option_menu_new (gboolean menu_only,
* gboolean active
*/
...);
...) G_GNUC_NULL_TERMINATED;
GtkWidget * gimp_option_menu_new2 (gboolean menu_only,
GCallback menu_item_callback,
gpointer menu_item_callback_data,
......@@ -81,7 +81,7 @@ GtkWidget * gimp_option_menu_new2 (gboolean menu_only,
* gpointer item_data,
* GtkWidget **widget_ptr,
*/
...);
...) G_GNUC_NULL_TERMINATED;
void gimp_option_menu_set_history (GtkOptionMenu *option_menu,
gpointer item_data);
......
......@@ -93,7 +93,7 @@ GtkWidget * gimp_int_radio_group_new (gboolean in_frame,
* GtkWidget **widget_ptr,
*/
...);
...) G_GNUC_NULL_TERMINATED;
void gimp_int_radio_group_set_active (GtkRadioButton *radio_button,
gint item_data);
......@@ -111,7 +111,7 @@ GtkWidget * gimp_radio_group_new (gboolean in_frame,
* gboolean active,
*/
...);
...) G_GNUC_NULL_TERMINATED;
GtkWidget * gimp_radio_group_new2 (gboolean in_frame,
const gchar *frame_title,
GCallback radio_button_callback,
......@@ -124,7 +124,7 @@ GtkWidget * gimp_radio_group_new2 (gboolean in_frame,
* GtkWidget **widget_ptr,
*/
...);
...) G_GNUC_NULL_TERMINATED;
void gimp_radio_group_set_active (GtkRadioButton *radio_button,
gpointer item_data);
......
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