GTK3/GTK4 utility subroutines, instead of having pre-processor flags everywhere in the code.
Whenever I need to use a GTK function that changed between v3 and v4,
I created an home made function declared in this file, and deal then here with the potential GTK versions issues. More...

#include "global.h"
#include "interface.h"
#include "preferences.h"
#include "glview.h"

Include dependency graph for gtk-misc.c:

Functions
void	adjust_preferences_window ()
	adjust the widgets of the preferences window
gboolean	is_the_widget_visible (GtkWidget *widg)
	test if a GtkWidget exist, then return if it is visible or not
void	show_the_widgets (GtkWidget *widg)
	show GtkWidget
void	hide_the_widgets (GtkWidget *widg)
	hide GtkWidget
void	widget_set_sensitive (GtkWidget *widg, gboolean sensitive)
	Set sensitivity for a GtkWidget, ensuring it is a GtkWidget.
void	add_container_child (int type, GtkWidget widg, GtkWidget child)
	Add a GtkWidget into another GtkWidget.
void	add_box_child_end (GtkWidget widg, GtkWidget child, gboolean expand, gboolean fill, int padding)
	Add a GtkWidget in a GtkBox at the end position.
void	add_box_child_start (int orientation, GtkWidget widg, GtkWidget child, gboolean expand, gboolean fill, int padding)
	Add a GtkWidget in a GtkBox at the initial position.
GtkWidget *	new_gtk_window ()
	create a new GtkWindow
GtkWidget *	create_win (gchar str, GtkWidget parent, gboolean modal, gboolean resiz)
	create a new GtkWindow
void	run_this_gtk_dialog (GtkWidget *dial, GCallback handler, gpointer data)
	run a GTK (3 and 4) basic GtkDialog
GtkWidget *	dialogmodal (gchar str, GtkWindow parent)
	Create a new dialog modal window.
GtkWidget *	message_dialogmodal (gchar message, gchar title, GtkMessageType mtype, GtkButtonsType buttons, GtkWidget *parent)
	create a modal (cannot be ignored) message window
GtkWidget *	dialog_cancel_apply (gchar title, GtkWidget parent, gboolean resiz)
	create a dialog modal offering a choice to apply something or not
void	resize_this_window (GtkWidget *window, int x, int y)
	resize this GtkWindow
const gchar *	entry_get_text (GtkEntry *entry)
	get the text in a GtkEntry
void	update_entry_int (GtkEntry *entry, int intval)
	update the content of a GtkEntry as int
void	update_entry_double (GtkEntry *entry, double doubleval)
	update the content of a GtkEntry as double
void	update_entry_long_double (GtkEntry *entry, double doubleval)
	update the content of a GtkEntry as long double
void	update_entry_text (GtkEntry entry, gchar text)
	update the content of a GtkEntry as string
void	text_view_set_monospace (GtkWidget *view)
	set the font of a GtkTextView as monospace
void	gtk_label_align (GtkWidget *lab, float ax, float ay)
	set text alignment in a GtkLabel
GtkWidget *	create_hscale (float min, float max, float delta, float val, int pos, int round, int size, GCallback handler, GCallback scroll_handler, gpointer data)
	create an horizontal scale GtkWidget
GtkWidget *	create_vscale (float min, float max, float delta, float val, int pos, int round, int size, GCallback handler, GCallback scroll_handler, gpointer data)
	create an vertical scale GtkWidget
GtkWidget *	create_vbox (int spacing)
	create a GtkBox with vertical orientation
GtkWidget *	create_hbox (int spacing)
	create a GtkBox with horizontal orientation
GtkWidget *	dialog_get_content_area (GtkWidget *widg)
	prepare GtkWidget to insert content in a GtkDialog window
void	layout_add_widget (GtkWidget layout, GtkWidget child, int x_pos, int y_pos)
	Add a GtkWidget in a GtkLayout.
GtkWidget *	add_vbox_to_layout (GtkWidget *layout, int size_x, int size_y)
	Insert a vertical GtkBox in a GtkLatout then send back the GtkBox.
GtkWidget *	create_layout (int x, int y)
	create a GtkLayout / GtkFixed widget
int	combo_get_active (GtkWidget *combo)
	retrieve the active item's position
void	combo_set_active (GtkWidget *combo, int pos)
	set the active item's position
void	combo_set_markup (GtkWidget *combo)
	use pango markup in combo widget
void	combo_text_append (GtkWidget combo, gchar text)
	append text in GtkComboBox widget
void	combo_text_prepend (GtkWidget combo, gchar text)
	prepend text in GtkComboBox widget
GtkWidget *	create_combo ()
	create a GtkCombox widget, note deprecated in GTK4
void	setup_text_tags (GtkTextBuffer *buffer)
	prepare the available text tags for the GtkTextBuffer
GtkTextBuffer *	add_buffer (GCallback handler, gpointer data, gchar *text)
	create a GtkTextBuffer
GtkWidget *	create_text_view (int dimx, int dimy, int edit, int mono, GCallback handler, gpointer data, gchar *text)
	create a GtkTextView and display some text
GdkPixbuf *	convert_to_pixbuf (cairo_surface_t *surf)
	convert cairo surface to GdkPixbuf
G_MODULE_EXPORT void	to_activate_entry (GtkEventControllerFocus *focus, gpointer data)
	GtkEntry activate signal managment.
GtkWidget *	create_entry (GCallback handler, int dim, int cdim, gboolean key_release, gpointer data)
	Create a GtkEntry.
GtkWidget *	stock_image (const gchar *stock_id)
	create a GtkImage for the Gtk database
GtkWidget *	create_image_from_data (int format, gpointer item_image)
	create Gtk image for data
GtkWidget *	markup_label (gchar *text, int dimx, int dimy, float ax, float ay)
	create a GtkLabel with pango markup
ColRGBA *	duplicate_color (int num, ColRGBA *col)
	duplicate a ColRGBA pointer
ColRGBA	gdkrgba_to_rgba (GdkRGBA colgdk)
	convert GdkRGBA color to ColRGBA color
GdkRGBA	colrgba_togtkrgba (ColRGBA col)
	convert ColRGBA color to GdkRGBA color
void	set_renderer_color (int tocol, GtkCellRenderer *renderer, ColRGBA col)
	set the color of a GtkCellRenderer
void	set_renderer_markup (GtkTreeModel mod, GtkTreeIter iter, GtkCellRenderer *renderer, int col)
	set Pango text markup for a GtkCellRenderer
void	button_set_image (GtkButton but, gchar text, int format, gpointer image)
	Add an image to a GtkButton.
void	adjust_label (GtkWidget *lab, int dimx, int dimy, float ax, float ay)
	adjust the text position, and widget size of a GtkLabel
GtkWidget *	color_button (ColRGBA col, gboolean alpha, int dimx, int dimy, GCallback handler, gpointer data)
	create a color selection button
GtkWidget *	font_button (gchar *font, int dimx, int dimy, GCallback handler, gpointer data)
	create a font selection button
GtkWidget *	spin_button (GCallback handler, double value, double start, double end, double step, int digits, int dim, gpointer data)
	create a spin button
int	button_get_status (GtkWidget *button)
	get status of check / toggle button
void	button_set_status (GtkWidget *button, int status)
	set status of check / toggle button
GtkWidget *	check_button (gchar *text, int dimx, int dimy, gboolean state, GCallback handler, gpointer data)
	create a check button
GtkWidget *	radio_button (gchar *text, int dimx, int dimy, gboolean state, GCallback handler, gpointer data)
	create a radio button
GtkWidget *	create_button (gchar text, int image_format, gchar image, int dimx, int dimy, int relief, GCallback handler, gpointer data)
	create a simple button
void	set_image_from_icon_name (GtkWidget widg, gchar icon)
	set a image from a stock icon name
void	append_comments (GtkWidget vbox, gchar symbol, gchar *legend)
	append comments to a vertical box
GtkWidget *	abox (GtkWidget box, char lab, int vspace)
	box creating routine, to help design faster elements for the GUI
GtkWidget *	bbox (GtkWidget box, char lab)
	box creating routine, to help design faster elements for the GUI
GtkWidget *	cbox (GtkWidget box, char lab)
	box creating routine, to help design faster elements for the GUI
GtkWidget *	fbox (GtkWidget box, char lab)
	box creating routine, to help design faster elements for the GUI
GtkWidget *	create_scroll (GtkWidget *box, int dimx, int dimy, int shadow)
	create a scroll window
GtkWidget *	create_expander (gchar name, gchar file_img)
	create GtkExpander
void	provide_gtk_css (gchar *css)
	create a css provider based on the css data
GtkWidget *	destroy_this_widget (GtkWidget *widg)
	destroy a GtkWidget
void	destroy_this_dialog (GtkDialog *dialog)
	destroy a GtkDialog
void	destroy_this_native_dialog (GtkNativeDialog *dialog)
	destroy a GtkNativeDialog
G_MODULE_EXPORT void	run_destroy_dialog (GtkDialog *dialog, gint response_id, gpointer data)
	to destroy a GtkDialog when the dialog emit the closing signal
GSList *	file_chooser_get_file_names (GtkFileChooser *chooser)
	create a file list from files selected using a GtkFileChooser
gchar *	file_chooser_get_file_name (GtkFileChooser *chooser)
	get a file name from a GtkFileChooser (single file selected)
gchar *	file_chooser_get_current_folder (GtkFileChooser *chooser)
	get the current folder for a GtkFileChooser
gboolean	file_chooser_set_file_name (GtkFileChooser chooser, gchar filename)
	set file name in a GtkFilechooser
void	file_chooser_set_current_folder (GtkFileChooser *chooser)
	set current folder in a GtkFilechooser
GtkWidget *	create_file_chooser (const gchar title, GtkWindow parent, GtkFileChooserAction act, const gchar *act_name)
	create a GtkFileChooser, utility to select file(s)
ColRGBA	get_button_color (GtkColorChooser *colob)
	get the ColRGBA color from a GtkColorChooser button
ColRGBA	get_window_color (GtkWidget *color_win)
	get the ColRGBA color from a color selection window
void	set_color_chooser_color (GtkWidget *color_win, ColRGBA col)
	set the color of a color selection window
void	pop_menu_at_pointer (GtkWidget widg, GdkEvent event)
	popup a menu at pointer location
GtkWidget *	get_top_level (GtkWidget *widg)
	get the top level container, window, of a widget
G_MODULE_EXPORT gboolean	destroy_this_window (GtkWidget win, GdkEvent event, gpointer data)
	destroy a GtkWindow
G_MODULE_EXPORT gboolean	hide_this_window (GtkWidget win, GdkEvent event, gpointer data)
	hide a GtkWindow
void	add_gtk_close_event (GtkWidget *widg, GCallback handler, gpointer data)
	add a close event signal and callback to a GtkWidget
int	get_widget_width (GtkWidget *widg)
	retrive GtkWidget width
int	get_widget_height (GtkWidget *widg)
	retrive GtkWidget height

Detailed Description

GTK3/GTK4 utility subroutines, instead of having pre-processor flags everywhere in the code.
Whenever I need to use a GTK function that changed between v3 and v4,
I created an home made function declared in this file, and deal then here with the potential GTK versions issues.

Author: Sébastien Le Roux sebas.nosp@m.tien.nosp@m..lero.nosp@m.ux@i.nosp@m.pcms..nosp@m.unis.nosp@m.tra.f.nosp@m.r

Definition in file gtk-misc.c.

Function Documentation

◆ abox()

GtkWidget * abox	(	GtkWidget *	box,
		char *	lab,
		int	vspace )

box creating routine, to help design faster elements for the GUI

Parameters

box	the box to insert the new box into
lab	string to display
vspace	vertical space

Definition at line 2067 of file gtk-misc.c.

◆ add_box_child_end()

void add_box_child_end	(	GtkWidget *	widg,
		GtkWidget *	child,
		gboolean	expand,
		gboolean	fill,
		int	padding )

Add a GtkWidget in a GtkBox at the end position.

Parameters

widg	the GtkBox
child	the GtkWidget to add
expand	GTK3 only: expandable
fill	GTK3 only: fill
padding	GTK3 only: box padding

Definition at line 318 of file gtk-misc.c.

◆ add_box_child_start()

void add_box_child_start	(	int	orientation,
		GtkWidget *	widg,
		GtkWidget *	child,
		gboolean	expand,
		gboolean	fill,
		int	padding )

Add a GtkWidget in a GtkBox at the initial position.

Parameters

orientation	horizontal or vertical
widg	the GtkBox
child	the GtkWidget to add
expand	GTK3 only: expandable
fill	GTK3 only: fill
padding	GTK3 only: box padding

Definition at line 340 of file gtk-misc.c.

◆ add_buffer()

GtkTextBuffer * add_buffer	(	GCallback	handler,
		gpointer	data,
		gchar *	text )

create a GtkTextBuffer

Parameters

handler	the callback on buffer changed
data	the associated data pointer
text	the text to display

Definition at line 1258 of file gtk-misc.c.

◆ add_container_child()

void add_container_child	(	int	type,
		GtkWidget *	widg,
		GtkWidget *	child )

Add a GtkWidget into another GtkWidget.

Parameters

type	GTK4 only: the type of container
widg	the container Gtkwidget
child	the child GtkWidget

Definition at line 267 of file gtk-misc.c.

◆ add_gtk_close_event()

void add_gtk_close_event	(	GtkWidget *	widg,
		GCallback	handler,
		gpointer	data )

add a close event signal and callback to a GtkWidget

Parameters

widg	the GtkWidget
handler	the callback for the close event
data	the associated data pointer

Definition at line 2557 of file gtk-misc.c.

◆ add_vbox_to_layout()

GtkWidget * add_vbox_to_layout	(	GtkWidget *	layout,
		int	size_x,
		int	size_y )

Insert a vertical GtkBox in a GtkLatout then send back the GtkBox.

Parameters

layout	the GtkLayout
size_x	the x size of the box
size_y	the y size of the box

Definition at line 900 of file gtk-misc.c.

◆ adjust_label()

void adjust_label	(	GtkWidget *	lab,
		int	dimx,
		int	dimy,
		float	ax,
		float	ay )

adjust the text position, and widget size of a GtkLabel

Parameters

lab	the GtkLabel to adjust
dimx	the x size
dimy	the y size
ax	the x alignment
ay	the y alignment

Definition at line 1813 of file gtk-misc.c.

◆ adjust_preferences_window()

void adjust_preferences_window ( )

extern

adjust the widgets of the preferences window

Definition at line 4903 of file preferences.c.

◆ append_comments()

void append_comments	(	GtkWidget *	vbox,
		gchar *	symbol,
		gchar *	legend )

append comments to a vertical box

Parameters

vbox	the target vertical box
symbol	the symbol to legend
legend	the associated legend

Definition at line 2048 of file gtk-misc.c.

◆ bbox()

GtkWidget * bbox	(	GtkWidget *	box,
		char *	lab )

box creating routine, to help design faster elements for the GUI

Parameters

box	the box to insert the new box into
lab	string to display

Definition at line 2084 of file gtk-misc.c.

◆ button_get_status()

int button_get_status ( GtkWidget * button )

get status of check / toggle button

Parameters

button the button to check

Definition at line 1899 of file gtk-misc.c.

◆ button_set_image()

void button_set_image	(	GtkButton *	but,
		gchar *	text,
		int	format,
		gpointer	image )

Add an image to a GtkButton.

Parameters

but	the GtkButton
text	the message to display
format	the image format
image	the data of the image

Definition at line 1782 of file gtk-misc.c.

◆ button_set_status()

void button_set_status	(	GtkWidget *	button,
		int	status )

set status of check / toggle button

Parameters

button	the button to update
status	the new status

Definition at line 1916 of file gtk-misc.c.

◆ cbox()

GtkWidget * cbox	(	GtkWidget *	box,
		char *	lab )

box creating routine, to help design faster elements for the GUI

Parameters

box	the box to insert the new box into
lab	string to display

Definition at line 2102 of file gtk-misc.c.

◆ check_button()

GtkWidget * check_button	(	gchar *	text,
		int	dimx,
		int	dimy,
		gboolean	state,
		GCallback	handler,
		gpointer	data )

create a check button

Parameters

text	the message to display
dimx	the x size
dimy	the y size
state	Checked or not (1/0)
handler	the callback for the button
data	the associated data pointer

Definition at line 1937 of file gtk-misc.c.

◆ color_button()

GtkWidget * color_button	(	ColRGBA	col,
		gboolean	alpha,
		int	dimx,
		int	dimy,
		GCallback	handler,
		gpointer	data )

create a color selection button

Parameters

col	the color to use
alpha	Use alpha channel (1/0)
dimx	Size x of the button
dimy	Size y of the button
handler	the callback for the button
data	the associated data pointer

Definition at line 1833 of file gtk-misc.c.

◆ colrgba_togtkrgba()

GdkRGBA colrgba_togtkrgba ( ColRGBA col )

convert ColRGBA color to GdkRGBA color

Parameters

col	the ColRGBA to convert

Definition at line 1721 of file gtk-misc.c.

◆ combo_get_active()

int combo_get_active ( GtkWidget * combo )

retrieve the active item's position

Parameters

combo the target GtkWidget

Definition at line 935 of file gtk-misc.c.

◆ combo_set_active()

void combo_set_active	(	GtkWidget *	combo,
		int	pos )

set the active item's position

Parameters

combo	the target GtkWidget
pos	the position to set

Definition at line 958 of file gtk-misc.c.

◆ combo_set_markup()

void combo_set_markup ( GtkWidget * combo )

use pango markup in combo widget

Parameters

combo to the target widget

Definition at line 970 of file gtk-misc.c.

◆ combo_text_append()

void combo_text_append	(	GtkWidget *	combo,
		gchar *	text )

append text in GtkComboBox widget

Parameters

combo	the GtkWidget
text	the text to append

Definition at line 987 of file gtk-misc.c.

◆ combo_text_prepend()

void combo_text_prepend	(	GtkWidget *	combo,
		gchar *	text )

prepend text in GtkComboBox widget

Parameters

combo	the GtkWidget
text	the text to prepend

Definition at line 1000 of file gtk-misc.c.

◆ convert_to_pixbuf()

GdkPixbuf * convert_to_pixbuf ( cairo_surface_t * surf )

convert cairo surface to GdkPixbuf

Parameters

surf	the cairo sufrace to convert

Definition at line 1351 of file gtk-misc.c.

◆ create_button()

GtkWidget * create_button	(	gchar *	text,
		int	image_format,
		gchar *	image,
		int	dimx,
		int	dimy,
		int	relief,
		GCallback	handler,
		gpointer	data )

create a simple button

Parameters

text	the message to display
image_format	the image format
image	the name of the stock image
dimx	the x size
dimy	the y size
relief	button should appear pressed or not (1/0)
handler	the callback for the button
data	the associated data pointer

Definition at line 1999 of file gtk-misc.c.

◆ create_combo()

GtkWidget * create_combo ( )

create a GtkCombox widget, note deprecated in GTK4

Definition at line 1010 of file gtk-misc.c.

◆ create_entry()

GtkWidget * create_entry	(	GCallback	handler,
		int	dim,
		int	cdim,
		gboolean	key_release,
		gpointer	data )

Create a GtkEntry.

Parameters

handler	the callback
dim	the x size
cdim	the maximum number of character to display
key_release	Use release event (1/0)
data	the data pointer for the callback

Definition at line 1401 of file gtk-misc.c.

◆ create_expander()

GtkWidget * create_expander	(	gchar *	name,
		gchar *	file_img )

create GtkExpander

Parameters

name	Name of the expander tab
file_img	image file to add if required

Definition at line 2163 of file gtk-misc.c.

◆ create_file_chooser()

GtkWidget * create_file_chooser	(	const gchar *	title,
		GtkWindow *	parent,
		GtkFileChooserAction	act,
		const gchar *	act_name )

create a GtkFileChooser, utility to select file(s)

Parameters

title	the title of the window
parent	the parent window, if any
act	the action to perform (read or write)
act_name	the action name to display

Definition at line 2393 of file gtk-misc.c.

◆ create_hbox()

GtkWidget * create_hbox ( int spacing )

create a GtkBox with horizontal orientation

Parameters

spacing spacing between elements

Definition at line 849 of file gtk-misc.c.

◆ create_hscale()

GtkWidget * create_hscale	(	float	min,
		float	max,
		float	delta,
		float	val,
		int	pos,
		int	round,
		int	size,
		GCallback	handler,
		GCallback	scroll_handler,
		gpointer	data )

create an horizontal scale GtkWidget

Parameters

min	Min value for the h scale
max	Max value for the h scale
delta	the step on the h scale
val	the value to position to set on the h scale
pos	the location where the value is on display
round	the rounding digit for the value on display
size	the x size of the GtkWdiget
handler	the callback to move the h scale
scroll_handler	the callback on mouse scroll
data	the associated data pointer

Definition at line 780 of file gtk-misc.c.

◆ create_image_from_data()

GtkWidget * create_image_from_data	(	int	format,
		gpointer	item_image )

create Gtk image for data

Parameters

format	Image format
item_image	the data to create the image

Definition at line 1530 of file gtk-misc.c.

◆ create_layout()

GtkWidget * create_layout	(	int	x,
		int	y )

create a GtkLayout / GtkFixed widget

Parameters

x	the x size of the widget
y	the y size of the widget

Definition at line 916 of file gtk-misc.c.

◆ create_scroll()

GtkWidget * create_scroll	(	GtkWidget *	box,
		int	dimx,
		int	dimy,
		int	shadow )

create a scroll window

Parameters

box	the box to insert the scroll window in, if any
dimx	the x size of the widget
dimy	the x size of the widget
shadow	Add shadow (1/0)

Definition at line 2139 of file gtk-misc.c.

◆ create_text_view()

GtkWidget * create_text_view	(	int	dimx,
		int	dimy,
		int	edit,
		int	mono,
		GCallback	handler,
		gpointer	data,
		gchar *	text )

create a GtkTextView and display some text

Parameters

dimx	the x size of the GtkTextView
dimy	the y size of the GtkTextView
edit	Is the text view editable (1/0)
mono	Use monospace font (1/0)
handler	the callback on buffer changed
data	the associated data pointer
text	the text to display

Definition at line 1286 of file gtk-misc.c.

◆ create_vbox()

GtkWidget * create_vbox ( int spacing )

create a GtkBox with vertical orientation

Parameters

spacing spacing between elements

Definition at line 837 of file gtk-misc.c.

◆ create_vscale()

GtkWidget * create_vscale	(	float	min,
		float	max,
		float	delta,
		float	val,
		int	pos,
		int	round,
		int	size,
		GCallback	handler,
		GCallback	scroll_handler,
		gpointer	data )

create an vertical scale GtkWidget

Parameters

min	Min value for the v scale
max	Max value for the v scale
delta	the step on the v scale
val	the value to position to set on the h scale
pos	the location where the value is on display
round	the rounding digit for the value on display
size	the x size of the GtkWdiget
handler	the callback to move the v scale
scroll_handler	the callback on mouse scroll
data	the associated data pointer

Definition at line 814 of file gtk-misc.c.

◆ create_win()

GtkWidget * create_win	(	gchar *	str,
		GtkWidget *	parent,
		gboolean	modal,
		gboolean	resiz )

create a new GtkWindow

Parameters

str	Title
parent	Parent GtkWidget (if any)
modal	Modal (TRUE/FALSE)
resiz	Can be re-sized (TRUE/FALSE)

Definition at line 486 of file gtk-misc.c.

◆ destroy_this_dialog()

void destroy_this_dialog ( GtkDialog * dialog )

destroy a GtkDialog

Parameters

dialog the GtkDialog to destroy

Definition at line 2235 of file gtk-misc.c.

◆ destroy_this_native_dialog()

void destroy_this_native_dialog ( GtkNativeDialog * dialog )

destroy a GtkNativeDialog

Parameters

dialog the GtkNativeDialog to destroy

Definition at line 2254 of file gtk-misc.c.

◆ destroy_this_widget()

GtkWidget * destroy_this_widget ( GtkWidget * widg )

destroy a GtkWidget

Parameters

widg	the GtkWidget to destroy

Definition at line 2213 of file gtk-misc.c.

◆ destroy_this_window()

G_MODULE_EXPORT gboolean destroy_this_window	(	GtkWidget *	win,
		GdkEvent *	event,
		gpointer	data )

destroy a GtkWindow

Parameters

win	the GtkWindow to destroy
event	the GdkEvent triggering the signal
data	the associated data pointer

Definition at line 2514 of file gtk-misc.c.

◆ dialog_cancel_apply()

GtkWidget * dialog_cancel_apply	(	gchar *	title,
		GtkWidget *	parent,
		gboolean	resiz )

create a dialog modal offering a choice to apply something or not

Parameters

title	the message
parent	the parent window, if any
resiz	Is the new window re-sizable ?

Definition at line 616 of file gtk-misc.c.

◆ dialog_get_content_area()

GtkWidget * dialog_get_content_area ( GtkWidget * widg )

prepare GtkWidget to insert content in a GtkDialog window

Parameters

widg	the GtkDialog window

Definition at line 861 of file gtk-misc.c.

◆ dialogmodal()

GtkWidget * dialogmodal	(	gchar *	str,
		GtkWindow *	parent )

Create a new dialog modal window.

Parameters

str	Title
parent	Parent GtkWindow, if any

Definition at line 552 of file gtk-misc.c.

◆ duplicate_color()

ColRGBA * duplicate_color	(	int	num,
		ColRGBA *	col )

duplicate a ColRGBA pointer

Parameters

num	Size of the pointer
col	ColRGBA pointer to duplicate

Definition at line 1689 of file gtk-misc.c.

◆ entry_get_text()

const gchar * entry_get_text ( GtkEntry * entry )

get the text in a GtkEntry

Parameters

entry the GtkEntry

Definition at line 652 of file gtk-misc.c.

◆ fbox()

GtkWidget * fbox	(	GtkWidget *	box,
		char *	lab )

box creating routine, to help design faster elements for the GUI

Parameters

box	the box to insert the new box into
lab	string to display

Definition at line 2120 of file gtk-misc.c.

◆ file_chooser_get_current_folder()

gchar * file_chooser_get_current_folder ( GtkFileChooser * chooser )

get the current folder for a GtkFileChooser

Parameters

chooser the GtkFilechooser

Definition at line 2322 of file gtk-misc.c.

◆ file_chooser_get_file_name()

gchar * file_chooser_get_file_name ( GtkFileChooser * chooser )

get a file name from a GtkFileChooser (single file selected)

Parameters

chooser the GtkFilechooser

Definition at line 2306 of file gtk-misc.c.

◆ file_chooser_get_file_names()

GSList * file_chooser_get_file_names ( GtkFileChooser * chooser )

create a file list from files selected using a GtkFileChooser

Definition at line 2293 of file gtk-misc.c.

◆ file_chooser_set_current_folder()

void file_chooser_set_current_folder ( GtkFileChooser * chooser )

set current folder in a GtkFilechooser

Parameters

chooser the GtkFilechooser

Definition at line 2358 of file gtk-misc.c.

◆ file_chooser_set_file_name()

gboolean file_chooser_set_file_name	(	GtkFileChooser *	chooser,
		gchar *	filename )

set file name in a GtkFilechooser

Parameters

chooser	the GtkFilechooser
filename	the file name to appear in the GtkFilechooser

Definition at line 2339 of file gtk-misc.c.

◆ font_button()

GtkWidget * font_button	(	gchar *	font,
		int	dimx,
		int	dimy,
		GCallback	handler,
		gpointer	data )

create a font selection button

Parameters

font	the font to use
dimx	Size x of the button
dimy	Size y of the button
handler	the callback for the button
data	the associated data pointer

Definition at line 1855 of file gtk-misc.c.

◆ gdkrgba_to_rgba()

ColRGBA gdkrgba_to_rgba ( GdkRGBA colgdk )

convert GdkRGBA color to ColRGBA color

Parameters

colgdk the GdkRGBA to convert

Definition at line 1704 of file gtk-misc.c.

◆ get_button_color()

ColRGBA get_button_color ( GtkColorChooser * colob )

get the ColRGBA color from a GtkColorChooser button

Parameters

colob the GtkColorChooser button

Definition at line 2406 of file gtk-misc.c.

◆ get_top_level()

GtkWidget * get_top_level ( GtkWidget * widg )

get the top level container, window, of a widget

Parameters

widg	the GtkWidget

Definition at line 2485 of file gtk-misc.c.

◆ get_widget_height()

int get_widget_height ( GtkWidget * widg )

retrive GtkWidget height

Parameters

widg	the GtkWidget

Definition at line 2589 of file gtk-misc.c.

◆ get_widget_width()

int get_widget_width ( GtkWidget * widg )

retrive GtkWidget width

Parameters

widg	the GtkWidget

Definition at line 2573 of file gtk-misc.c.

◆ get_window_color()

ColRGBA get_window_color ( GtkWidget * color_win )

get the ColRGBA color from a color selection window

Parameters

color_win the color selection window

Definition at line 2420 of file gtk-misc.c.

◆ gtk_label_align()

void gtk_label_align	(	GtkWidget *	lab,
		float	ax,
		float	ay )

set text alignment in a GtkLabel

Parameters

lab	the GtkLabel
ax	the x alignment
ay	the Y alignment

Definition at line 756 of file gtk-misc.c.

◆ hide_the_widgets()

void hide_the_widgets ( GtkWidget * widg )

hide GtkWidget

Parameters

widg	the GtkWidget to show

Definition at line 224 of file gtk-misc.c.

◆ hide_this_window()

G_MODULE_EXPORT gboolean hide_this_window	(	GtkWidget *	win,
		GdkEvent *	event,
		gpointer	data )

hide a GtkWindow

Parameters

win	the GtkWindow to hide
event	the GdkEvent triggering the signal
data	the associated data pointer

Definition at line 2541 of file gtk-misc.c.

◆ is_the_widget_visible()

gboolean is_the_widget_visible ( GtkWidget * widg )

test if a GtkWidget exist, then return if it is visible or not

Parameters

widg	the GtkWidget

Definition at line 183 of file gtk-misc.c.

◆ layout_add_widget()

void layout_add_widget	(	GtkWidget *	layout,
		GtkWidget *	child,
		int	x_pos,
		int	y_pos )

Add a GtkWidget in a GtkLayout.

Parameters

layout	the GtkLayout
child	the GtkWidget to insert
x_pos	the x position to insert at
y_pos	the y position to insert at

Definition at line 882 of file gtk-misc.c.

◆ markup_label()

GtkWidget * markup_label	(	gchar *	text,
		int	dimx,
		int	dimy,
		float	ax,
		float	ay )

create a GtkLabel with pango markup

Parameters

text	Message to display
dimx	y size for the widget
dimy	y size for the widget
ax	x alignment
ay	y alignment

Definition at line 1672 of file gtk-misc.c.

◆ message_dialogmodal()

GtkWidget * message_dialogmodal	(	gchar *	message,
		gchar *	title,
		GtkMessageType	mtype,
		GtkButtonsType	buttons,
		GtkWidget *	parent )

create a modal (cannot be ignored) message window

Parameters

message	the message
title	the title
mtype	the message type
buttons	the type of closing button to add
parent	the parent window, if any

Definition at line 573 of file gtk-misc.c.

◆ new_gtk_window()

GtkWidget * new_gtk_window ( )

create a new GtkWindow

Definition at line 389 of file gtk-misc.c.

◆ pop_menu_at_pointer()

void pop_menu_at_pointer	(	GtkWidget *	widg,
		GdkEvent *	event )

popup a menu at pointer location

Parameters

widg	the menu to popup
event	the GdkEvent triggering the signal

Definition at line 2471 of file gtk-misc.c.

◆ provide_gtk_css()

void provide_gtk_css ( gchar * css )

create a css provider based on the css data

Parameters

css	the css data, use the name of the variable to use the css

Definition at line 2185 of file gtk-misc.c.

◆ radio_button()

GtkWidget * radio_button	(	gchar *	text,
		int	dimx,
		int	dimy,
		gboolean	state,
		GCallback	handler,
		gpointer	data )

create a radio button

Parameters

text	the message to display
dimx	the x size
dimy	the y size
state	Checked or not (1/0)
handler	the callback for the button
data	the associated data pointer

Definition at line 1970 of file gtk-misc.c.

◆ resize_this_window()

void resize_this_window	(	GtkWidget *	window,
		int	x,
		int	y )

resize this GtkWindow

Parameters

window	the GtkWidget to resize
x	the x size
y	the y size

Definition at line 636 of file gtk-misc.c.

◆ run_destroy_dialog()

G_MODULE_EXPORT void run_destroy_dialog	(	GtkDialog *	dialog,
		gint	response_id,
		gpointer	data )

to destroy a GtkDialog when the dialog emit the closing signal

Parameters

dialog	the GtkDialog to destroy
response_id	the response id
data	the associated data pointer

Definition at line 2272 of file gtk-misc.c.

◆ run_this_gtk_dialog()

void run_this_gtk_dialog	(	GtkWidget *	dial,
		GCallback	handler,
		gpointer	data )

run a GTK (3 and 4) basic GtkDialog

Parameters

dial	the GtkDialog
handler	the callback
data	the associated data pointer

Definition at line 533 of file gtk-misc.c.

◆ set_color_chooser_color()

void set_color_chooser_color	(	GtkWidget *	color_win,
		ColRGBA	col )

set the color of a color selection window

Parameters

color_win	the color selection window
col	the color to use

Definition at line 2435 of file gtk-misc.c.

◆ set_image_from_icon_name()

void set_image_from_icon_name	(	GtkWidget *	widg,
		gchar *	icon )

set a image from a stock icon name

Parameters

widg	the GtkImage to modify
icon	the name of the stock icon

Definition at line 2030 of file gtk-misc.c.

◆ set_renderer_color()

void set_renderer_color	(	int	tocol,
		GtkCellRenderer *	renderer,
		ColRGBA	col )

set the color of a GtkCellRenderer

Parameters

tocol	Apply color (1/0)
renderer	the GtkCellRenderer
col	the color to apply

Definition at line 1740 of file gtk-misc.c.

◆ set_renderer_markup()

void set_renderer_markup	(	GtkTreeModel *	mod,
		GtkTreeIter *	iter,
		GtkCellRenderer *	renderer,
		int	col )

set Pango text markup for a GtkCellRenderer

Parameters

mod	the target tree model
iter	the target tree iter
renderer	the target GtkCellRenderer
col	column number

Definition at line 1764 of file gtk-misc.c.

◆ setup_text_tags()

void setup_text_tags ( GtkTextBuffer * buffer )

prepare the available text tags for the GtkTextBuffer

Parameters

buffer the GtkTextBuffer

Definition at line 1022 of file gtk-misc.c.

◆ show_the_widgets()

void show_the_widgets ( GtkWidget * widg )

show GtkWidget

Parameters

widg	the GtkWidget to show

Definition at line 202 of file gtk-misc.c.

◆ spin_button()

GtkWidget * spin_button	(	GCallback	handler,
		double	value,
		double	start,
		double	end,
		double	step,
		int	digits,
		int	dim,
		gpointer	data )

create a spin button

Parameters

handler	the callback for the button
value	Initial value for the spin button
start	Minimum value
end	Maximum value
step	Step between values
digits	Number of digits displayed
dim	Size x of the button
data	the associated data pointer

Definition at line 1877 of file gtk-misc.c.

◆ stock_image()

GtkWidget * stock_image ( const gchar * stock_id )

create a GtkImage for the Gtk database

Parameters

stock_id

Definition at line 1451 of file gtk-misc.c.

◆ text_view_set_monospace()

void text_view_set_monospace ( GtkWidget * view )

set the font of a GtkTextView as monospace

Parameters

view	the GtkTextView

Definition at line 742 of file gtk-misc.c.

◆ to_activate_entry()

G_MODULE_EXPORT void to_activate_entry	(	GtkEventControllerFocus *	focus,
		gpointer	data )

GtkEntry activate signal managment.

Parameters

focus	Focus event controller
data	the associated data pointer

Definition at line 1384 of file gtk-misc.c.

◆ update_entry_double()

void update_entry_double	(	GtkEntry *	entry,
		double	doubleval )

update the content of a GtkEntry as double

Parameters

entry	the GtkEntry
doubleval	the new double value to display

Definition at line 688 of file gtk-misc.c.

◆ update_entry_int()

void update_entry_int	(	GtkEntry *	entry,
		int	intval )

update the content of a GtkEntry as int

Parameters

entry	the GtkEntry
intval	the new int value to display

Definition at line 669 of file gtk-misc.c.

◆ update_entry_long_double()

void update_entry_long_double	(	GtkEntry *	entry,
		double	doubleval )

update the content of a GtkEntry as long double

Parameters

entry	the GtkEntry
doubleval	the new long double value to display

Definition at line 707 of file gtk-misc.c.

◆ update_entry_text()

void update_entry_text	(	GtkEntry *	entry,
		gchar *	text )

update the content of a GtkEntry as string

Parameters

entry	the GtkEntry
text	the new string to display

Definition at line 726 of file gtk-misc.c.

◆ widget_set_sensitive()

void widget_set_sensitive	(	GtkWidget *	widg,
		gboolean	sensitive )

Set sensitivity for a GtkWidget, ensuring it is a GtkWidget.

Parameters

widg	the GtkWidget
sensitive	Sensitivity

Definition at line 247 of file gtk-misc.c.

Functions

Detailed Description

Function Documentation

◆ abox()

◆ add_box_child_end()

◆ add_box_child_start()

◆ add_buffer()

◆ add_container_child()

◆ add_gtk_close_event()

◆ add_vbox_to_layout()

◆ adjust_label()

◆ adjust_preferences_window()

◆ append_comments()

◆ bbox()

◆ button_get_status()

◆ button_set_image()

◆ button_set_status()

◆ cbox()

◆ check_button()

◆ color_button()

◆ colrgba_togtkrgba()

◆ combo_get_active()

◆ combo_set_active()

◆ combo_set_markup()

◆ combo_text_append()

◆ combo_text_prepend()

◆ convert_to_pixbuf()

◆ create_button()

◆ create_combo()

◆ create_entry()

◆ create_expander()

◆ create_file_chooser()

◆ create_hbox()

◆ create_hscale()

◆ create_image_from_data()

◆ create_layout()

◆ create_scroll()

◆ create_text_view()

◆ create_vbox()

◆ create_vscale()

◆ create_win()

◆ destroy_this_dialog()

◆ destroy_this_native_dialog()

◆ destroy_this_widget()

◆ destroy_this_window()

◆ dialog_cancel_apply()

◆ dialog_get_content_area()

◆ dialogmodal()

◆ duplicate_color()

◆ entry_get_text()

◆ fbox()

◆ file_chooser_get_current_folder()

◆ file_chooser_get_file_name()

◆ file_chooser_get_file_names()

◆ file_chooser_set_current_folder()

◆ file_chooser_set_file_name()

◆ font_button()

◆ gdkrgba_to_rgba()

◆ get_button_color()

◆ get_top_level()

◆ get_widget_height()

◆ get_widget_width()

◆ get_window_color()

◆ gtk_label_align()

◆ hide_the_widgets()

◆ hide_this_window()

◆ is_the_widget_visible()

◆ layout_add_widget()

◆ markup_label()

◆ message_dialogmodal()

◆ new_gtk_window()

◆ pop_menu_at_pointer()

◆ provide_gtk_css()

◆ radio_button()

◆ resize_this_window()

◆ run_destroy_dialog()

◆ run_this_gtk_dialog()

◆ set_color_chooser_color()

◆ set_image_from_icon_name()

◆ set_renderer_color()