util_form_dialog


Description:


public unowned Dialog util_form_dialog (string heading, string confirm_label, Widget content, int width, int height, out unowned Widget confirm)

The shell every composer puts up: content under a header bar offering to cancel or to confirm, cancelling being all it handles by itself.

A dialog rather than an alert: an alert is a short message with a question attached, and a composer is neither -- a text editor six hundred pixels wide, or a small form in a boxed list.

Parameters:

heading

what the dialog is for

confirm_label

the label of the confirm button

content

what fills the dialog under its header bar

width

the content width to give the dialog

height

the content height to give it, or 0 to let content ask for its own

confirm

the confirm button, which the caller connects to and is free to follow -- desensitizing it while the form is incomplete, and again once it has been pressed, since closing is asynchronous and the button stays live until it happens

Returns:

the dialog, not presented yet: the caller still has its own data to hang off it


Namespace: GPasteGtk
Package: gpaste-gtk4