GcrKeyWidget

GcrKeyWidget — Key widget and renderer

Properties

GckAttributes * attributes Read / Write
GckObject * object Read / Write

Types and Values

Object Hierarchy

    GObject
    ├── GInitiallyUnowned
       ╰── GtkWidget
           ╰── GtkContainer
               ╰── GtkBin
                   ╰── GcrKeyWidget
    ╰── GcrKeyRenderer

Implemented Interfaces

GcrKeyWidget implements AtkImplementorIface and GtkBuildable.

GcrKeyRenderer implements GcrRenderer.

Description

A GcrKeyWidget 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 gcr_key_widget_new() to create a new key widget. Only one key can be displayed. A GcrKeyWidget contains a GcrViewer internally and GcrKeyRenderer 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.

Functions

gcr_key_widget_new ()

GcrKeyWidget *
gcr_key_widget_new (GckAttributes *attrs);

Create a new key widget which displays a given key in the attributes.

Parameters

attrs

key to display, or NULL.

[allow-none]

Returns

A newly allocated GcrKeyWidget, which should be freed with g_object_unref().


gcr_key_widget_get_attributes ()

GckAttributes *
gcr_key_widget_get_attributes (GcrKeyWidget *self);

Get the attributes displayed in the widget.

Parameters

self

The key widget

 

Returns

The attributes, owned by the widget.

[allow-none][transfer none]


gcr_key_widget_set_attributes ()

void
gcr_key_widget_set_attributes (GcrKeyWidget *self,
                               GckAttributes *attrs);

Get the attributes displayed in the widget. The attributes should represent either an RSA, DSA or EC key in PKCS#11 style.

Parameters

self

The key widget

 

attrs

the attributes to display.

[allow-none]

gcr_key_renderer_new ()

GcrKeyRenderer *
gcr_key_renderer_new (const gchar *label,
                      GckAttributes *attrs);

Create a new key renderer which renders a given key in the attributes.

Parameters

label

label describing the key.

[allow-none]

attrs

key to display, or NULL.

[allow-none]

Returns

a newly allocated GcrKeyRenderer, which should be freed with g_object_unref().

[transfer full]


gcr_key_renderer_get_attributes ()

GckAttributes *
gcr_key_renderer_get_attributes (GcrKeyRenderer *self);

Get the attributes displayed in the renderer.

Parameters

self

The key renderer

 

Returns

the attributes, owned by the renderer.

[transfer none][allow-none]


gcr_key_renderer_set_attributes ()

void
gcr_key_renderer_set_attributes (GcrKeyRenderer *self,
                                 GckAttributes *attrs);

Get the attributes displayed in the renderer. The attributes should represent either an RSA, DSA, or EC key in PKCS#11 style.

Parameters

self

The key renderer

 

attrs

the attributes to display.

[allow-none]

Types and Values

GcrKeyWidget

typedef struct _GcrKeyWidget GcrKeyWidget;

A widget that displays a key.


GcrKeyWidgetClass

typedef struct _GcrKeyWidgetClass GcrKeyWidgetClass;

The class for GcrKeyWidget


struct GcrKeyRenderer

struct GcrKeyRenderer;

An implementation of GcrRenderer which renders keys.


struct GcrKeyRendererClass

struct GcrKeyRendererClass {
	GObjectClass parent_class;
};

The class for GcrKeyRenderer.

Members

GObjectClass parent_class;

The parent class.

 

Property Details

The “attributes” property

  “attributes”               GckAttributes *

The data displayed in the widget.

Flags: Read / Write


The “object” property

  “object”                   GckObject *

Key Object.

Flags: Read / Write