dialogs.h File Reference

File related dialogs, miscellaneous dialogs, font dialog. More...

Functions
gchar *	dialogs_show_input (const gchar *title, GtkWindow *parent, const gchar *label_text, const gchar *default_text)
	Asks the user for text input.
gboolean	dialogs_show_input_numeric (const gchar *title, const gchar *label_text, gdouble *value, gdouble min, gdouble max, gdouble step)
	Shows an input box to enter a numerical value using a GtkSpinButton.
void	dialogs_show_msgbox (GtkMessageType type, const gchar *text,...)
	Shows a message box of the type type with text.
gboolean	dialogs_show_question (const gchar *text,...)
	Shows a question message box with text and Yes/No buttons.
gboolean	dialogs_show_save_as (void)
	Shows the Save As dialog for the current notebook page.

---

Detailed Description

File related dialogs, miscellaneous dialogs, font dialog.

---

Function Documentation

gchar* dialogs_show_input	(	const gchar *	title,
		GtkWindow *	parent,
		const gchar *	label_text,
		const gchar *	default_text
	)

Asks the user for text input.

Parameters:

	title	Dialog title.
	parent	The currently focused window, usually geany->main_widgets->window. NULL can be used but is discouraged due to window manager effects.
	label_text	Label text, or NULL.
	default_text	Text to display in the input field, or NULL.

Returns:

New copy of user input or NULL if cancelled.

Since:

0.20.

gboolean dialogs_show_input_numeric	(	const gchar *	title,
		const gchar *	label_text,
		gdouble *	value,
		gdouble	min,
		gdouble	max,
		gdouble	step
	)

Shows an input box to enter a numerical value using a GtkSpinButton.

If the dialog is aborted, value remains untouched.

Parameters:

	title	The dialog title.
	label_text	The shown dialog label.
	value	The default value for the spin button and the return location of the entered value. Must be non-NULL.
	min	Minimum allowable value (see documentation for gtk_spin_button_new_with_range()).
	max	Maximum allowable value (see documentation for gtk_spin_button_new_with_range()).
	step	Increment added or subtracted by spinning the widget (see documentation for gtk_spin_button_new_with_range()).

Returns:

TRUE if a value was entered and the dialog closed with 'OK'. FALSE otherwise.

Since:

0.16

void dialogs_show_msgbox	(	GtkMessageType	type,
		const gchar *	text,
			...
	)

Shows a message box of the type type with text.

On Unix-like systems a GTK message dialog box is shown, on Win32 systems a native Windows message dialog box is shown.

Parameters:

	type	A GtkMessageType, e.g. GTK_MESSAGE_INFO, GTK_MESSAGE_WARNING, GTK_MESSAGE_QUESTION, GTK_MESSAGE_ERROR.
	text	Printf()-style format string.
	...	Arguments for the text format string.

gboolean dialogs_show_question	(	const gchar *	text,
			...
	)

Shows a question message box with text and Yes/No buttons.

On Unix-like systems a GTK message dialog box is shown, on Win32 systems a native Windows message dialog box is shown.

Parameters:

	text	Printf()-style format string.
	...	Arguments for the text format string.

Returns:

TRUE if the user answered with Yes, otherwise FALSE.

gboolean dialogs_show_save_as

(

void

)

Shows the Save As dialog for the current notebook page.

Returns:

TRUE if the file was saved, otherwise FALSE.