An implementation of #GcrRenderer which renders certificates.
Create a new certificate renderer to display the certificate.
a newly allocated #GcrCertificateRenderer, which
should be released with g_object_unref()
The certificate to display
Create a new certificate renderer to display the label and attributes. One
of the attributes should be a CKA_VALUE type attribute containing a DER
encoded certificate.
a newly allocated #GcrCertificateRenderer, which
should be released with g_object_unref()
the label to display
The attributes to display
Get the certificate displayed in the renderer. If no certificate was
explicitly set, then the renderer will return itself since it acts as
a valid certificate.
The certificate, owned by the renderer.
The renderer
Set a certificate to display in the renderer.
The renderer
the certificate to display
The certificate attributes to display. One of the attributes must be
a CKA_VALUE type attribute which contains a DER encoded certificate.
The certificate to display. May be %NULL.
The label to display.
The class for #GcrCertificateRenderer.
The parent class.
A widget that can be used to display a certificate.
A certificate widget is normally in a collapsed state showing only
details, but can be expanded by the user.
Use [ctor@CertificateWidget.new] to create a new certificate widget. Only
one certificate can be displayed. It contains a [iface@Viewer] internally
and [class@CertificateRenderer] is used to render the certificate to the
viewer.
To show more than one certificate in a view, create the viewer and
add renderers to it.
Create a new certificate widget which displays a given certificate.
a new certificate widget
certificate to display, or %NULL
Get the attributes displayed in the widget. The attributes should contain
a certificate.
the attributes, owned by the widget
The certificate widget
Get the certificate displayed in the widget.
the certificate
The certificate widget
Set the attributes displayed in the widget. The attributes should contain
a certificate.
The certificate widget
the attributes to display
Set the certificate displayed in the widget
The certificate widget
the certificate to display
Ain implementation of a [iface@Gtk.TreeModel] which contains a row for each
object in a [iface@Gcr.Collection].
As objects are added or removed from the collection, rows are added and
removed from this model.
The row values come from the properties of the objects in the collection. Use
[ctor@CollectionModel.new] to create a new collection model. To have more
control over the values use a set of [struct@Gcr.Column] structures to
define the columns. This can be done with [ctor@CollectionModel.new_full] or
[method@CollectionModel.set_columns].
Each row can have a selected state, which is represented by a boolean column.
The selected state can be toggled with gcr_collection_model_toggle_selected()
or set with gcr_collection_model_set_selected_objects() and retrieved with
[method@CollectionModel.get_selected_objects].
To determine which object a row represents and vice versa, use the
[method@CollectionModel.iter_for_object] or
[method@CollectionModel.object_for_iter] functions.
Create a new #GcrCollectionModel. The variable argument list should contain
pairs of property names, and #GType values. The variable argument list should
be terminated with %NULL.
a newly allocated model, which should be released
with g_object_unref().
the collection to represent
whether list or tree mode
the column names and types
Create a new #GcrCollectionModel.
a newly allocated model, which should be released
with g_object_unref()
the collection to represent
whether list or tree mode
the columns the model should contain
Set whether a given row is toggled selected or not.
The model
The row
Whether the row should be selected or not.
Get the column identifier for the column that contains the values
of the selected state.
The column identifier.
The model
Get the collection which this model represents
the collection, owned by the model
a collection model
Get a list of checked/selected objects.
a list of selected
objects, which should be freed with g_list_free()
the collection model
Check whether a given row has been toggled as selected.
Whether the row has been selected.
The model
The row
Set @iter to the row for the given object. If the object is not in this
model, then %FALSE will be returned.
%TRUE if the object was present.
The model
The object
The row for the object
Get the object that is represented by the given row in the model.
The object, owned by the model.
The model
The row
Set the collection which this model represents
a collection model
the collection or %NULL
Set the columns that the model should contain. @columns is an array of
#GcrColumn structures, with the last one containing %NULL for all values.
This function can only be called once, and only if the model was not created
without a set of columns. This function cannot be called after the model
has been added to a view.
The columns are accessed as static data. They should continue to remain
in memory for longer than the GcrCollectionModel object.
The number of columns
The model
The columns the model should contain
Set the checked/selected objects.
the collection model
a list of objects to select
Toggle the selected state of a given row.
The model
The row
The class for #GcrCollectionModel.
The parent class
If a [class@CollectionModel] is created with a mode of
%GCR_COLLECTION_MODEL_TREE, then any included objects that are themselves a
[iface@Gcr.Collection], will have all child
objects include as child rows in a tree form.
only objects in the top collection, no child objects
show objects in the collection, and child objects in a tree form
A widget that can be used to select a certificate or key. It allows
the user to select one object from the selector at a time.
Create a new #GcrTreeSelector.
A newly allocated selector, which should be released with
g_object_unref().
The collection that contains the objects to display
Get the collection that this selector is displaying objects from.
The collection, owned by the selector.
The selector
Get the selected object in the selector, or %NULL if nothing selected.
the selected object, owned by the selector, or %NULL
The selector
Set the currently selected object in the selector, or clear the selection
if selected is set to %NULL.
The selector
the object to select or %NULL
The collection which contains the objects to display in the selector.
A renderer that can be used for unsupported data.
Create a new renderer for an error.
the new renderer
the label for the failure
the error to display
Create a new renderer for unsupported data.
the new renderer
the label for the failure
A button which imports keys and certificates.
The import button shows a spinner when the button is activated. When more
than one importer is available, it shows a drop down to select which to
import to.
Create a new #GcrImportButton.
a newly created #GcrImportButton
label to display on the button
Emitted when the import completes, or fails.
Emitted when the import begins.
Queue an item to import via the button
an import button
a parsed item
Signal emitted when an import completes or fails.
the importer that was imported to
if import was successful %NULL, or an error
Signal emitted when an import begins.
the importer that will be imported to
Class struct for [class@ImportButton].
The parent class
Emitted when the import begins.
Emitted when the import completes, or fails.
An implementation of #GcrRenderer which renders keys.
Create a new key renderer which renders a given key in the attributes.
a newly allocated #GcrKeyRenderer, which should be
freed with g_object_unref()
label describing the key
key to display, or %NULL
Get the attributes displayed in the renderer.
the attributes, owned by the renderer
The key renderer
Get the attributes displayed in the renderer. The attributes should represent
either an RSA, DSA, or EC key in PKCS#11 style.
The key renderer
the attributes to display
The class for #GcrKeyRenderer.
The parent class.
A key widget and renderer
A key widget can be used to display a RSA, DSA or EC key. The widget is
normally in a collapsed state showing only details, but can be expanded by
the user.
Use [ctor@KeyWidget.new] to create a new key widget. Only one key can be
displayed. A key widget contains a [iface@Viewer] internally and
[class@KeyRenderer] is used to render the key to the viewer. To show more
than one key in a view, create the viewer and add renderers to it.
Create a new key widget which displays a given key in the attributes.
A newly allocated #GcrKeyWidget, which should be freed
with g_object_unref().
key to display, or %NULL
Get the attributes displayed in the widget.
The attributes, owned by the widget.
The key widget
Get the attributes displayed in the widget. The attributes should represent
either an RSA, DSA or EC key in PKCS#11 style.
The key widget
the attributes to display
A selector widget to select 1 or more certificates or keys from a list.
Live search is available for quick filtering.
Create a new #GcrListSelector.
a newly allocated selector, which should be
released with g_object_unref()
The collection that contains the objects to display
Get the collection that this selector is displaying objects from.
The collection, owned by the selector.
The selector
Get a list of selected objects.
the list of
selected objects, to be released with g_list_free()
The selector
Select certain objects in the selector.
The selector
the list of objects to select
The collection which contains the objects to display in the selector.
A [iface@Gcr.Prompt] implementation which shows a GTK dialog. The dialog
will remain visible (but insensitive) between prompts. If the user cancels
the dialog between prompts, then the dialog will be hidden.
Whether the choice check box is visible or not.
Whether the password confirm entry is visible or not.
Whether the password entry is visible or not.
Whether the warning label is visible or not.
An interface that's implemented by renderers which wish to render data to a
[iface@Viewer].
The interaction between [iface@Renderer] and [iface@Viewer] is not stable
yet, and so new renderers cannot be implemented outside the Gcr library at
this time.
To lookup a renderer for a given set of attributes, use the gcr_renderer_create()
function. This will create and initialize a renderer that's capable of viewing
the data in those attributes.
Create and initialize a renderer for the given attributes and label. These
renderers should have been preregistered via gcr_renderer_register().
a new renderer, or %NULL if no renderer
matched the attributes; the render should be released with g_object_unref()
The label for the renderer
The attributes to render
Register a renderer to be created when matching attributes are passed to
gcr_renderer_create().
The renderer class type
The attributes to match
Register all the well known renderers for certificates and keys known to the
Gcr library.
signal emitted when data being rendered changes
method invoked to populate a popup menu with additional
renderer options
Render the contents of the renderer to the given viewer.
The renderer
The viewer to render to.
Emit the #GcrRenderer::data-changed signal on the renderer. This is used by
renderer implementations.
The renderer
Get the PKCS#11 attributes, if any, set for this renderer to display.
the attributes, owned by the renderer
The renderer
Called by #GcrViewer when about to display a popup menu for the content
displayed by the renderer. The renderer can add a menu item if desired.
The renderer
The viewer that is displaying a popup
The popup menu being displayed
Render the contents of the renderer to the given viewer.
The renderer
The viewer to render to.
Set the PKCS#11 attributes for this renderer to display.
The renderer
attributes to set
The attributes to display.
The label to display.
A signal that is emitted by the renderer when it's data
changed and should be rerendered.
The interface for #GcrRenderer
the parent interface type
signal emitted when data being rendered changes
method invoked to render the data into a viewer
The renderer
The viewer to render to.
method invoked to populate a popup menu with additional
renderer options
A [class@Gtk.EntryBuffer] that uses non-pageable memory.
It's good practice to try to keep passwords or sensitive secrets out of
pageable memory whenever possible, so that they don't get written to disk.
A [class@SecureEntryBuffer] is a [class@Gtk.EntryBuffer] to be used with
[class@Gtk.Entry] which uses non-pageable memory to store a password placed
in the entry. In order to make any sense at all, the entry must have it's
visibility turned off, and just be displaying place holder characters for
the text. That is, a password style entry.
Use [ctor@Gtk.Entry.new_with_buffer] or [method@Gtk.Entry.set_buffer] to set this buffer
on an entry.
Create a new secure entry buffer.
the new entry buffer
A tree selector can be used to select certificates or keys. It allows
the user to select multiple objects from a tree.
Create a new #GcrTreeSelector.
a newly allocated selector, which should be
released with g_object_unref()
The collection that contains the objects to display
The columns to use to display the objects
Get the collection that this selector is displaying objects from.
the collection, owned by the selector
The selector
Get the columns displayed in a selector in multiple mode.
The columns, owned by the selector.
The selector
Get a list of selected objects.
the list of selected
objects, to be released with g_list_free()
The selector
Select certain objects in the selector.
The selector
the list of objects to select
The collection which contains the objects to display in the selector.
The columns to use to display the objects.
This widget displays a set of unlock options for the user to select.
The user can choose between keeping caching the unlock indefinitely, or for
a given amount of time.
Each option has a different name, for example #GCR_UNLOCK_OPTION_ALWAYS. These
names are used together with the various functions like
[method@UnlockOptionsWidget.get_choice].
Create a new #GcrUnlockOptionsWidget.
a new #GcrUnlockOptionsWidget
Get the currently selected option, like %GCR_UNLOCK_OPTION_ALWAYS.
The currently selected option name.
The unlock options widget
Get the label for one of the options. Use an option name like
%GCR_UNLOCK_OPTION_ALWAYS.
The current label for the option.
The unlock options widget
The option name
Get the sensitivity state for one of the options. Use an option name like
%GCR_UNLOCK_OPTION_ALWAYS.
Whether the option is sensitive or not.
The unlock options widget
The option name
Get the timeout setting set for unlock options that have a timeout.
This will also return a valid value if the currently selected option
does not have a timeout.
The unlock timeout in seconds.
The unlock options widget
Set the currently selected option. Use an option name like
%GCR_UNLOCK_OPTION_ALWAYS.
The unlock options widget
The option name
Set the label for one of the options. Use an option name like
%GCR_UNLOCK_OPTION_ALWAYS.
The unlock options widget
The option name
The new label
Set the sensitivity state for one of the options. Use an option name like
%GCR_UNLOCK_OPTION_ALWAYS. The reason will be displayed as a tooltip.
The unlock options widget
The option name
The sensitivity state.
A user displayable string which contains the reason for the sensitivity.
Set the current setting for the timeout. This can be set even when the
currently selected option does not have a timeout.
The unlock options widget
The timeout to set, in seconds
An abstract interface that represents a widget that can hold
various renderers and display their contents.
The interaction between [iface@Renderer] and [iface@Viewer] is not stable
yet, and so viewers cannot be implemented outside the Gcr library at this
time.
Use the [func@Viewer.new] and [func@Viewer.new_scrolled] to get default
implementations of viewers.
Get an implementation of #GcrViewer that supports a view
of multiple renderers.
a newly allocated #GcrViewer, which should be
released with g_object_unref()
Get an implementation of #GcrViewer that supports a scrolled view
of multiple renderers.
a #GcrViewer which is also a #GtkWidget
Add a renderer to this viewer.
The viewer
The renderer to add
Get the number of renderers present in the viewer.
The number of renderers.
The viewer
Get a pointer to the renderer at the given index. It is an error to request
an index that is out of bounds.
the render, owned by the viewer
The viewer
The index of the renderer to get
Insert a renderer at a specific point in the viewer
the viewer
the renderer to insert
the renderer to insert before
Remove a renderer from this viewer.
The viewer
The renderer to remove
Add a renderer to this viewer.
The viewer
The renderer to add
Get the number of renderers present in the viewer.
The number of renderers.
The viewer
Get a pointer to the renderer at the given index. It is an error to request
an index that is out of bounds.
the render, owned by the viewer
The viewer
The index of the renderer to get
Insert a renderer at a specific point in the viewer
the viewer
the renderer to insert
the renderer to insert before
Remove a renderer from this viewer.
The viewer
The renderer to remove
The interface for #GcrViewer
The parent interface
Virtual method to add a renderer
The viewer
The renderer to add
Virtual method to insert a renderer
the viewer
the renderer to insert
the renderer to insert before
Virtual method to remove a renderer
The viewer
The renderer to remove
Virtual method to count renderers
The number of renderers.
The viewer
Virtual method to get a renderer
the render, owned by the viewer
The viewer
The index of the renderer to get
A viewer widget which can display certificates and keys that are
located in files.
Create a new viewer widget.
A new #GcrViewerWidget object
Clear the error displayed on the viewer widget.
a viewer widget
Get the display name for data being displayed. This is automatically
calculated from a loaded file, or can be explicitly set.
Used as a hint when displaying a title for the data, but may be
overridden by the parsed data.
the display name
a viewer widget
Get the parser used to parse loaded data into viewable items.
the parser
a viewer widget
Get the viewer used to display the viewable items.
the viewer
a viewer widget
Parse and load some data to be displayed into the viewer widgets. The data
may contain multiple parseable items if the format can contain multiple
items.
a viewer widget
label for the loaded data
data to load
Parse and load some data to be displayed into the viewer widgets. The data
may contain multiple parseable items if the format can contain multiple
items.
This function will copy the data. Use [method@ViewerWidget.load_bytes] to avoid
copying the data.
a viewer widget
label for the loaded data
data to load
length of data to load
Display contents of a file in the viewer widget. Multiple files can
be loaded.
a viewer widget
a file to load
Set the display name for data being displayed. Once explicitly
set it will no longer be calculated automatically by loading data.
Used as a hint when displaying a title for the data, but may be
overridden by the parsed data.
a viewer widget
the display name
Show an error on the viewer widget. This is displayed on a info bar near
the edge of the widget.
a viewer widget
descriptive error message
detailed error
Display name for data being displayed. This is automatically
calculated from a loaded file, or can be explicitly set.
Used as a hint when displaying a title for the data, but may be
overridden by the parsed data.
The parser used to parse loaded data into viewable items.
This signal is emitted when an item is added to the viewer widget.
the renderer that was added
the parsed item that was added
Create and initialize a renderer for the given attributes and label. These
renderers should have been preregistered via gcr_renderer_register().
a new renderer, or %NULL if no renderer
matched the attributes; the render should be released with g_object_unref()
The label for the renderer
The attributes to render
Register a renderer to be created when matching attributes are passed to
gcr_renderer_create().
The renderer class type
The attributes to match
Register all the well known renderers for certificates and keys known to the
Gcr library.
Get an implementation of #GcrViewer that supports a view
of multiple renderers.
a newly allocated #GcrViewer, which should be
released with g_object_unref()
Get an implementation of #GcrViewer that supports a scrolled view
of multiple renderers.
a #GcrViewer which is also a #GtkWidget