colorchooserdialog: Convert docs

Convert link syntax, add example image, clean things up.
This commit is contained in:
Matthias Clasen 2021-02-26 11:25:46 -05:00 committed by Emmanuele Bassi
parent c0be9c5b97
commit 11c5523142

View File

@ -30,13 +30,20 @@
#include "gtkcolorchooserwidget.h"
/**
* SECTION:gtkcolorchooserdialog
* @Short_description: A dialog for choosing colors
* @Title: GtkColorChooserDialog
* @See_also: #GtkColorChooser, #GtkDialog
* GtkColorChooserDialog:
*
* The #GtkColorChooserDialog widget is a dialog for choosing
* a color. It implements the #GtkColorChooser interface.
* A dialog for choosing a color.
*
* ![An example GtkColorChooserDialog](colorchooser.png)
*
* `GtkColorChooserDialog` implements the `GtkColorChooser` interface
* and does not provide much API of its own.
*
* To create a `GtkColorChooserDialog`, use [ctor@Gtk.ColorChooserDialog.new].
*
* To change the initially selected color, use
* [method@Gtk.ColorChooser.set_rgba]. To get the selected color use
* [method@Gtk.ColorChooser.get_rgba].
*/
typedef struct _GtkColorChooserDialogClass GtkColorChooserDialogClass;
@ -272,9 +279,9 @@ gtk_color_chooser_dialog_iface_init (GtkColorChooserInterface *iface)
* @title: (allow-none): Title of the dialog, or %NULL
* @parent: (allow-none): Transient parent of the dialog, or %NULL
*
* Creates a new #GtkColorChooserDialog.
* Creates a new `GtkColorChooserDialog`.
*
* Returns: a new #GtkColorChooserDialog
* Returns: a new `GtkColorChooserDialog`
*/
GtkWidget *
gtk_color_chooser_dialog_new (const char *title,