~ubuntu-branches/ubuntu/trusty/gcr/trusty-proposed

« back to all changes in this revision

Viewing changes to docs/reference/gcr/html/GcrCertificateWidget.html

  • Committer: Package Import Robot
  • Author(s): Jordi Mallach
  • Date: 2012-05-03 10:18:39 UTC
  • Revision ID: package-import@ubuntu.com-20120503101839-wuvloldm7gmdsnij
Tags: upstream-3.4.1
Import upstream version 3.4.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<html>
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 
5
<title>GcrCertificateWidget</title>
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
 
7
<link rel="home" href="index.html" title="Gcr Library Reference Manual">
 
8
<link rel="up" href="widgets.html" title="Part III. Widgets">
 
9
<link rel="prev" href="widgets.html" title="Part III. Widgets">
 
10
<link rel="next" href="GcrKeyWidget.html" title="GcrKeyWidget">
 
11
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
 
12
<link rel="stylesheet" href="style.css" type="text/css">
 
13
</head>
 
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
 
16
<tr valign="middle">
 
17
<td><a accesskey="p" href="widgets.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
18
<td><a accesskey="u" href="widgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
20
<th width="100%" align="center">Gcr Library Reference Manual</th>
 
21
<td><a accesskey="n" href="GcrKeyWidget.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
22
</tr>
 
23
<tr><td colspan="5" class="shortcuts">
 
24
<a href="#GcrCertificateWidget.synopsis" class="shortcut">Top</a>
 
25
                   | 
 
26
                  <a href="#GcrCertificateWidget.description" class="shortcut">Description</a>
 
27
                   | 
 
28
                  <a href="#GcrCertificateWidget.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
29
                   | 
 
30
                  <a href="#GcrCertificateWidget.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
 
31
                   | 
 
32
                  <a href="#GcrCertificateWidget.properties" class="shortcut">Properties</a>
 
33
</td></tr>
 
34
</table>
 
35
<div class="refentry">
 
36
<a name="GcrCertificateWidget"></a><div class="titlepage"></div>
 
37
<div class="refnamediv"><table width="100%"><tr>
 
38
<td valign="top">
 
39
<h2><span class="refentrytitle"><a name="GcrCertificateWidget.top_of_page"></a>GcrCertificateWidget</span></h2>
 
40
<p>GcrCertificateWidget — Certificate widget and renderer</p>
 
41
</td>
 
42
<td valign="top" align="right"><img src="certificate-widget.png"></td>
 
43
</tr></table></div>
 
44
<div class="refsynopsisdiv">
 
45
<a name="GcrCertificateWidget.synopsis"></a><h2>Synopsis</h2>
 
46
<a name="GcrCertificateRenderer"></a><pre class="synopsis">#define             <a class="link" href="GcrCertificateWidget.html#GCR-CERTIFICATE-COLUMNS:CAPS" title="GCR_CERTIFICATE_COLUMNS">GCR_CERTIFICATE_COLUMNS</a>
 
47
                    <a class="link" href="GcrCertificateWidget.html#GcrCertificateWidget-struct" title="GcrCertificateWidget">GcrCertificateWidget</a>;
 
48
                    <a class="link" href="GcrCertificateWidget.html#GcrCertificateWidgetClass" title="GcrCertificateWidgetClass">GcrCertificateWidgetClass</a>;
 
49
struct              <a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer-struct" title="struct GcrCertificateRenderer">GcrCertificateRenderer</a>;
 
50
struct              <a class="link" href="GcrCertificateWidget.html#GcrCertificateRendererClass" title="struct GcrCertificateRendererClass">GcrCertificateRendererClass</a>;
 
51
<a class="link" href="GcrCertificateWidget.html" title="GcrCertificateWidget"><span class="returnvalue">GcrCertificateWidget</span></a> * <a class="link" href="GcrCertificateWidget.html#gcr-certificate-widget-new" title="gcr_certificate_widget_new ()">gcr_certificate_widget_new</a>       (<em class="parameter"><code><a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="type">GcrCertificate</span></a> *certificate</code></em>);
 
52
<a href="http://developer.gnome.org/gck/stable/GckAttributes.html"><span class="returnvalue">GckAttributes</span></a> *     <a class="link" href="GcrCertificateWidget.html#gcr-certificate-widget-get-attributes" title="gcr_certificate_widget_get_attributes ()">gcr_certificate_widget_get_attributes</a>
 
53
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html" title="GcrCertificateWidget"><span class="type">GcrCertificateWidget</span></a> *self</code></em>);
 
54
<span class="returnvalue">void</span>                <a class="link" href="GcrCertificateWidget.html#gcr-certificate-widget-set-attributes" title="gcr_certificate_widget_set_attributes ()">gcr_certificate_widget_set_attributes</a>
 
55
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html" title="GcrCertificateWidget"><span class="type">GcrCertificateWidget</span></a> *self</code></em>,
 
56
                                                         <em class="parameter"><code><a href="http://developer.gnome.org/gck/stable/GckAttributes.html"><span class="type">GckAttributes</span></a> *attrs</code></em>);
 
57
<a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="returnvalue">GcrCertificate</span></a> *    <a class="link" href="GcrCertificateWidget.html#gcr-certificate-widget-get-certificate" title="gcr_certificate_widget_get_certificate ()">gcr_certificate_widget_get_certificate</a>
 
58
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html" title="GcrCertificateWidget"><span class="type">GcrCertificateWidget</span></a> *self</code></em>);
 
59
<span class="returnvalue">void</span>                <a class="link" href="GcrCertificateWidget.html#gcr-certificate-widget-set-certificate" title="gcr_certificate_widget_set_certificate ()">gcr_certificate_widget_set_certificate</a>
 
60
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html" title="GcrCertificateWidget"><span class="type">GcrCertificateWidget</span></a> *self</code></em>,
 
61
                                                         <em class="parameter"><code><a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="type">GcrCertificate</span></a> *certificate</code></em>);
 
62
<a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="returnvalue">GcrCertificateRenderer</span></a> * <a class="link" href="GcrCertificateWidget.html#gcr-certificate-renderer-new" title="gcr_certificate_renderer_new ()">gcr_certificate_renderer_new</a>   (<em class="parameter"><code><a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="type">GcrCertificate</span></a> *certificate</code></em>);
 
63
<a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="returnvalue">GcrCertificateRenderer</span></a> * <a class="link" href="GcrCertificateWidget.html#gcr-certificate-renderer-new-for-attributes" title="gcr_certificate_renderer_new_for_attributes ()">gcr_certificate_renderer_new_for_attributes</a>
 
64
                                                        (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
 
65
                                                         <em class="parameter"><code><span class="type">struct _GckAttributes</span> *attrs</code></em>);
 
66
<a href="http://developer.gnome.org/gck/stable/GckAttributes.html"><span class="returnvalue">GckAttributes</span></a> *     <a class="link" href="GcrCertificateWidget.html#gcr-certificate-renderer-get-attributes" title="gcr_certificate_renderer_get_attributes ()">gcr_certificate_renderer_get_attributes</a>
 
67
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="type">GcrCertificateRenderer</span></a> *self</code></em>);
 
68
<span class="returnvalue">void</span>                <a class="link" href="GcrCertificateWidget.html#gcr-certificate-renderer-set-attributes" title="gcr_certificate_renderer_set_attributes ()">gcr_certificate_renderer_set_attributes</a>
 
69
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="type">GcrCertificateRenderer</span></a> *self</code></em>,
 
70
                                                         <em class="parameter"><code><a href="http://developer.gnome.org/gck/stable/GckAttributes.html"><span class="type">GckAttributes</span></a> *attrs</code></em>);
 
71
<a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="returnvalue">GcrCertificate</span></a> *    <a class="link" href="GcrCertificateWidget.html#gcr-certificate-renderer-get-certificate" title="gcr_certificate_renderer_get_certificate ()">gcr_certificate_renderer_get_certificate</a>
 
72
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="type">GcrCertificateRenderer</span></a> *self</code></em>);
 
73
<span class="returnvalue">void</span>                <a class="link" href="GcrCertificateWidget.html#gcr-certificate-renderer-set-certificate" title="gcr_certificate_renderer_set_certificate ()">gcr_certificate_renderer_set_certificate</a>
 
74
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="type">GcrCertificateRenderer</span></a> *self</code></em>,
 
75
                                                         <em class="parameter"><code><a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="type">GcrCertificate</span></a> *certificate</code></em>);
 
76
</pre>
 
77
</div>
 
78
<div class="refsect1">
 
79
<a name="GcrCertificateWidget.object-hierarchy"></a><h2>Object Hierarchy</h2>
 
80
<pre class="synopsis">
 
81
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
82
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
 
83
         +----<a href="http://developer.gnome.org/devel/gtk/GtkWidget.html">GtkWidget</a>
 
84
               +----<a href="http://developer.gnome.org/devel/gtk/GtkContainer.html">GtkContainer</a>
 
85
                     +----<a href="http://developer.gnome.org/devel/gtk/GtkBin.html">GtkBin</a>
 
86
                           +----<a href="http://developer.gnome.org/devel/gtk/GtkAlignment.html">GtkAlignment</a>
 
87
                                 +----GcrCertificateWidget
 
88
</pre>
 
89
<pre class="synopsis">
 
90
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
91
   +----GcrCertificateRenderer
 
92
</pre>
 
93
</div>
 
94
<div class="refsect1">
 
95
<a name="GcrCertificateWidget.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
 
96
<p>
 
97
GcrCertificateWidget implements
 
98
 AtkImplementorIface and  <a href="http://developer.gnome.org/devel/gtk/GtkBuildable.html">GtkBuildable</a>.</p>
 
99
<p>
 
100
GcrCertificateRenderer implements
 
101
 <a class="link" href="GcrRenderer.html" title="GcrRenderer">GcrRenderer</a>,  <a class="link" href="gcr-GcrComparable.html#GcrComparableIface">GcrComparableIface</a> and  <a class="link" href="GcrCertificate.html" title="GcrCertificate">GcrCertificate</a>.</p>
 
102
</div>
 
103
<div class="refsect1">
 
104
<a name="GcrCertificateWidget.properties"></a><h2>Properties</h2>
 
105
<pre class="synopsis">
 
106
  "<a class="link" href="GcrCertificateWidget.html#GcrCertificateWidget--attributes" title='The "attributes" property'>attributes</a>"               <a href="http://developer.gnome.org/gck/stable/GckAttributes.html"><span class="type">GckAttributes</span></a>*        : Read / Write
 
107
  "<a class="link" href="GcrCertificateWidget.html#GcrCertificateWidget--certificate" title='The "certificate" property'>certificate</a>"              <a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="type">GcrCertificate</span></a>*       : Read / Write
 
108
  "<a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer--attributes" title='The "attributes" property'>attributes</a>"               <a href="http://developer.gnome.org/gck/stable/GckAttributes.html"><span class="type">GckAttributes</span></a>*        : Read / Write
 
109
  "<a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer--certificate" title='The "certificate" property'>certificate</a>"              <a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="type">GcrCertificate</span></a>*       : Read / Write
 
110
  "<a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer--label" title='The "label" property'>label</a>"                    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 
111
</pre>
 
112
</div>
 
113
<div class="refsect1">
 
114
<a name="GcrCertificateWidget.description"></a><h2>Description</h2>
 
115
<p>
 
116
A <a class="link" href="GcrCertificateWidget.html" title="GcrCertificateWidget"><span class="type">GcrCertificateWidget</span></a> can be used to display a certificate. The widget
 
117
is normally in a collapsed state showing only details, but can be expanded
 
118
by the user.
 
119
</p>
 
120
<p>
 
121
Use <a class="link" href="GcrCertificateWidget.html#gcr-certificate-widget-new" title="gcr_certificate_widget_new ()"><code class="function">gcr_certificate_widget_new()</code></a> to create a new certificate widget. Only
 
122
one certificate can be displayed.  A <a class="link" href="GcrCertificateWidget.html" title="GcrCertificateWidget"><span class="type">GcrCertificateWidget</span></a> contains a
 
123
<a class="link" href="GcrViewer.html" title="GcrViewer"><span class="type">GcrViewer</span></a> internally and <a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="type">GcrCertificateRenderer</span></a> is used to render the
 
124
certificate to the viewer. To show more than one certificate in a view,
 
125
create the viewer and add renderers to it.
 
126
</p>
 
127
</div>
 
128
<div class="refsect1">
 
129
<a name="GcrCertificateWidget.details"></a><h2>Details</h2>
 
130
<div class="refsect2">
 
131
<a name="GCR-CERTIFICATE-COLUMNS:CAPS"></a><h3>GCR_CERTIFICATE_COLUMNS</h3>
 
132
<pre class="programlisting">#define GCR_CERTIFICATE_COLUMNS                 (gcr_certificate_get_columns ())
 
133
</pre>
 
134
<p>
 
135
The columns that are valid for a certificate. This is to be used with
 
136
the <a class="link" href="GcrTreeSelector.html" title="GcrTreeSelector"><span class="type">GcrTreeSelector</span></a> or <a class="link" href="GcrCollectionModel.html" title="GcrCollectionModel"><span class="type">GcrCollectionModel</span></a>.
 
137
</p>
 
138
<p>
 
139
This is an array of <a class="link" href="gcr-GcrColumn.html#GcrColumn" title="GcrColumn"><span class="type">GcrColumn</span></a>, owned by the gcr library.
 
140
</p>
 
141
</div>
 
142
<hr>
 
143
<div class="refsect2">
 
144
<a name="GcrCertificateWidget-struct"></a><h3>GcrCertificateWidget</h3>
 
145
<pre class="programlisting">typedef struct _GcrCertificateWidget GcrCertificateWidget;</pre>
 
146
<p>
 
147
A widget that displays a certificate.
 
148
</p>
 
149
</div>
 
150
<hr>
 
151
<div class="refsect2">
 
152
<a name="GcrCertificateWidgetClass"></a><h3>GcrCertificateWidgetClass</h3>
 
153
<pre class="programlisting">typedef struct _GcrCertificateWidgetClass GcrCertificateWidgetClass;</pre>
 
154
<p>
 
155
The class for <a class="link" href="GcrCertificateWidget.html" title="GcrCertificateWidget"><span class="type">GcrCertificateWidget</span></a>
 
156
</p>
 
157
</div>
 
158
<hr>
 
159
<div class="refsect2">
 
160
<a name="GcrCertificateRenderer-struct"></a><h3>struct GcrCertificateRenderer</h3>
 
161
<pre class="programlisting">struct GcrCertificateRenderer;</pre>
 
162
<p>
 
163
An implementation of <a class="link" href="GcrRenderer.html" title="GcrRenderer"><span class="type">GcrRenderer</span></a> which renders certificates.
 
164
</p>
 
165
</div>
 
166
<hr>
 
167
<div class="refsect2">
 
168
<a name="GcrCertificateRendererClass"></a><h3>struct GcrCertificateRendererClass</h3>
 
169
<pre class="programlisting">struct GcrCertificateRendererClass {
 
170
        GObjectClass parent_class;
 
171
};
 
172
</pre>
 
173
<p>
 
174
The class for <a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="type">GcrCertificateRenderer</span></a>.
 
175
</p>
 
176
<div class="variablelist"><table border="0">
 
177
<col align="left" valign="top">
 
178
<tbody><tr>
 
179
<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> <em class="structfield"><code><a name="GcrCertificateRendererClass.parent-class"></a>parent_class</code></em>;</span></p></td>
 
180
<td>The parent class.</td>
 
181
</tr></tbody>
 
182
</table></div>
 
183
</div>
 
184
<hr>
 
185
<div class="refsect2">
 
186
<a name="gcr-certificate-widget-new"></a><h3>gcr_certificate_widget_new ()</h3>
 
187
<pre class="programlisting"><a class="link" href="GcrCertificateWidget.html" title="GcrCertificateWidget"><span class="returnvalue">GcrCertificateWidget</span></a> * gcr_certificate_widget_new       (<em class="parameter"><code><a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="type">GcrCertificate</span></a> *certificate</code></em>);</pre>
 
188
<p>
 
189
Create a new certificate widget which displays a given certificate.
 
190
</p>
 
191
<div class="variablelist"><table border="0">
 
192
<col align="left" valign="top">
 
193
<tbody>
 
194
<tr>
 
195
<td><p><span class="term"><em class="parameter"><code>certificate</code></em> :</span></p></td>
 
196
<td>certificate to display, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
197
</td>
 
198
</tr>
 
199
<tr>
 
200
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
201
<td>a newly allocated <a class="link" href="GcrCertificateWidget.html" title="GcrCertificateWidget"><span class="type">GcrCertificateWidget</span></a>, which
 
202
should be freed with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
203
</td>
 
204
</tr>
 
205
</tbody>
 
206
</table></div>
 
207
</div>
 
208
<hr>
 
209
<div class="refsect2">
 
210
<a name="gcr-certificate-widget-get-attributes"></a><h3>gcr_certificate_widget_get_attributes ()</h3>
 
211
<pre class="programlisting"><a href="http://developer.gnome.org/gck/stable/GckAttributes.html"><span class="returnvalue">GckAttributes</span></a> *     gcr_certificate_widget_get_attributes
 
212
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html" title="GcrCertificateWidget"><span class="type">GcrCertificateWidget</span></a> *self</code></em>);</pre>
 
213
<p>
 
214
Get the attributes displayed in the widget. The attributes should contain
 
215
a certificate.
 
216
</p>
 
217
<div class="variablelist"><table border="0">
 
218
<col align="left" valign="top">
 
219
<tbody>
 
220
<tr>
 
221
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
222
<td>The certificate widget</td>
 
223
</tr>
 
224
<tr>
 
225
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
226
<td>the attributes, owned by the widget. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
227
</td>
 
228
</tr>
 
229
</tbody>
 
230
</table></div>
 
231
</div>
 
232
<hr>
 
233
<div class="refsect2">
 
234
<a name="gcr-certificate-widget-set-attributes"></a><h3>gcr_certificate_widget_set_attributes ()</h3>
 
235
<pre class="programlisting"><span class="returnvalue">void</span>                gcr_certificate_widget_set_attributes
 
236
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html" title="GcrCertificateWidget"><span class="type">GcrCertificateWidget</span></a> *self</code></em>,
 
237
                                                         <em class="parameter"><code><a href="http://developer.gnome.org/gck/stable/GckAttributes.html"><span class="type">GckAttributes</span></a> *attrs</code></em>);</pre>
 
238
<p>
 
239
Set the attributes displayed in the widget. The attributes should contain
 
240
a certificate.
 
241
</p>
 
242
<div class="variablelist"><table border="0">
 
243
<col align="left" valign="top">
 
244
<tbody>
 
245
<tr>
 
246
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
247
<td>The certificate widget</td>
 
248
</tr>
 
249
<tr>
 
250
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
 
251
<td>the attributes to display. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
252
</td>
 
253
</tr>
 
254
</tbody>
 
255
</table></div>
 
256
</div>
 
257
<hr>
 
258
<div class="refsect2">
 
259
<a name="gcr-certificate-widget-get-certificate"></a><h3>gcr_certificate_widget_get_certificate ()</h3>
 
260
<pre class="programlisting"><a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="returnvalue">GcrCertificate</span></a> *    gcr_certificate_widget_get_certificate
 
261
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html" title="GcrCertificateWidget"><span class="type">GcrCertificateWidget</span></a> *self</code></em>);</pre>
 
262
<p>
 
263
Get the certificate displayed in the widget.
 
264
</p>
 
265
<div class="variablelist"><table border="0">
 
266
<col align="left" valign="top">
 
267
<tbody>
 
268
<tr>
 
269
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
270
<td>The certificate widget</td>
 
271
</tr>
 
272
<tr>
 
273
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
274
<td>the certificate. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
275
</td>
 
276
</tr>
 
277
</tbody>
 
278
</table></div>
 
279
</div>
 
280
<hr>
 
281
<div class="refsect2">
 
282
<a name="gcr-certificate-widget-set-certificate"></a><h3>gcr_certificate_widget_set_certificate ()</h3>
 
283
<pre class="programlisting"><span class="returnvalue">void</span>                gcr_certificate_widget_set_certificate
 
284
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html" title="GcrCertificateWidget"><span class="type">GcrCertificateWidget</span></a> *self</code></em>,
 
285
                                                         <em class="parameter"><code><a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="type">GcrCertificate</span></a> *certificate</code></em>);</pre>
 
286
<p>
 
287
Set the certificate displayed in the widget
 
288
</p>
 
289
<div class="variablelist"><table border="0">
 
290
<col align="left" valign="top">
 
291
<tbody>
 
292
<tr>
 
293
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
294
<td>The certificate widget</td>
 
295
</tr>
 
296
<tr>
 
297
<td><p><span class="term"><em class="parameter"><code>certificate</code></em> :</span></p></td>
 
298
<td>the certificate to display. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
299
</td>
 
300
</tr>
 
301
</tbody>
 
302
</table></div>
 
303
</div>
 
304
<hr>
 
305
<div class="refsect2">
 
306
<a name="gcr-certificate-renderer-new"></a><h3>gcr_certificate_renderer_new ()</h3>
 
307
<pre class="programlisting"><a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="returnvalue">GcrCertificateRenderer</span></a> * gcr_certificate_renderer_new   (<em class="parameter"><code><a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="type">GcrCertificate</span></a> *certificate</code></em>);</pre>
 
308
<p>
 
309
Create a new certificate renderer to display the certificate.
 
310
</p>
 
311
<div class="variablelist"><table border="0">
 
312
<col align="left" valign="top">
 
313
<tbody>
 
314
<tr>
 
315
<td><p><span class="term"><em class="parameter"><code>certificate</code></em> :</span></p></td>
 
316
<td>The certificate to display</td>
 
317
</tr>
 
318
<tr>
 
319
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
320
<td>a newly allocated <a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="type">GcrCertificateRenderer</span></a>, which
 
321
should be released with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
322
</td>
 
323
</tr>
 
324
</tbody>
 
325
</table></div>
 
326
</div>
 
327
<hr>
 
328
<div class="refsect2">
 
329
<a name="gcr-certificate-renderer-new-for-attributes"></a><h3>gcr_certificate_renderer_new_for_attributes ()</h3>
 
330
<pre class="programlisting"><a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="returnvalue">GcrCertificateRenderer</span></a> * gcr_certificate_renderer_new_for_attributes
 
331
                                                        (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>,
 
332
                                                         <em class="parameter"><code><span class="type">struct _GckAttributes</span> *attrs</code></em>);</pre>
 
333
<p>
 
334
Create a new certificate renderer to display the label and attributes. One
 
335
of the attributes should be a CKA_VALUE type attribute containing a DER
 
336
encoded certificate.
 
337
</p>
 
338
<div class="variablelist"><table border="0">
 
339
<col align="left" valign="top">
 
340
<tbody>
 
341
<tr>
 
342
<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
 
343
<td>the label to display. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
344
</td>
 
345
</tr>
 
346
<tr>
 
347
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
 
348
<td>The attributes to display</td>
 
349
</tr>
 
350
<tr>
 
351
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
352
<td>a newly allocated <a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="type">GcrCertificateRenderer</span></a>, which
 
353
should be released with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
354
</td>
 
355
</tr>
 
356
</tbody>
 
357
</table></div>
 
358
</div>
 
359
<hr>
 
360
<div class="refsect2">
 
361
<a name="gcr-certificate-renderer-get-attributes"></a><h3>gcr_certificate_renderer_get_attributes ()</h3>
 
362
<pre class="programlisting"><a href="http://developer.gnome.org/gck/stable/GckAttributes.html"><span class="returnvalue">GckAttributes</span></a> *     gcr_certificate_renderer_get_attributes
 
363
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="type">GcrCertificateRenderer</span></a> *self</code></em>);</pre>
 
364
<p>
 
365
Get the PKCS#11 attributes, if any, set for this renderer to display.
 
366
</p>
 
367
<div class="variablelist"><table border="0">
 
368
<col align="left" valign="top">
 
369
<tbody>
 
370
<tr>
 
371
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
372
<td>The renderer</td>
 
373
</tr>
 
374
<tr>
 
375
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
376
<td>the attributes, owned by the renderer. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
377
</td>
 
378
</tr>
 
379
</tbody>
 
380
</table></div>
 
381
</div>
 
382
<hr>
 
383
<div class="refsect2">
 
384
<a name="gcr-certificate-renderer-set-attributes"></a><h3>gcr_certificate_renderer_set_attributes ()</h3>
 
385
<pre class="programlisting"><span class="returnvalue">void</span>                gcr_certificate_renderer_set_attributes
 
386
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="type">GcrCertificateRenderer</span></a> *self</code></em>,
 
387
                                                         <em class="parameter"><code><a href="http://developer.gnome.org/gck/stable/GckAttributes.html"><span class="type">GckAttributes</span></a> *attrs</code></em>);</pre>
 
388
<p>
 
389
Set the PKCS#11 attributes for this renderer to display. One of the attributes
 
390
should be a CKA_VALUE type attribute containing a DER encoded certificate.
 
391
</p>
 
392
<div class="variablelist"><table border="0">
 
393
<col align="left" valign="top">
 
394
<tbody>
 
395
<tr>
 
396
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
397
<td>The renderer</td>
 
398
</tr>
 
399
<tr>
 
400
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
 
401
<td>attributes to set. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
402
</td>
 
403
</tr>
 
404
</tbody>
 
405
</table></div>
 
406
</div>
 
407
<hr>
 
408
<div class="refsect2">
 
409
<a name="gcr-certificate-renderer-get-certificate"></a><h3>gcr_certificate_renderer_get_certificate ()</h3>
 
410
<pre class="programlisting"><a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="returnvalue">GcrCertificate</span></a> *    gcr_certificate_renderer_get_certificate
 
411
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="type">GcrCertificateRenderer</span></a> *self</code></em>);</pre>
 
412
<p>
 
413
Get the certificate displayed in the renderer. If no certificate was
 
414
explicitly set, then the renderer will return itself since it acts as
 
415
a valid certificate.
 
416
</p>
 
417
<div class="variablelist"><table border="0">
 
418
<col align="left" valign="top">
 
419
<tbody>
 
420
<tr>
 
421
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
422
<td>The renderer</td>
 
423
</tr>
 
424
<tr>
 
425
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
426
<td>The certificate, owned by the renderer. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
427
</td>
 
428
</tr>
 
429
</tbody>
 
430
</table></div>
 
431
</div>
 
432
<hr>
 
433
<div class="refsect2">
 
434
<a name="gcr-certificate-renderer-set-certificate"></a><h3>gcr_certificate_renderer_set_certificate ()</h3>
 
435
<pre class="programlisting"><span class="returnvalue">void</span>                gcr_certificate_renderer_set_certificate
 
436
                                                        (<em class="parameter"><code><a class="link" href="GcrCertificateWidget.html#GcrCertificateRenderer"><span class="type">GcrCertificateRenderer</span></a> *self</code></em>,
 
437
                                                         <em class="parameter"><code><a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="type">GcrCertificate</span></a> *certificate</code></em>);</pre>
 
438
<p>
 
439
Set a certificate to display in the renderer.
 
440
</p>
 
441
<div class="variablelist"><table border="0">
 
442
<col align="left" valign="top">
 
443
<tbody>
 
444
<tr>
 
445
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
446
<td>The renderer</td>
 
447
</tr>
 
448
<tr>
 
449
<td><p><span class="term"><em class="parameter"><code>certificate</code></em> :</span></p></td>
 
450
<td>the certificate to display. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
451
</td>
 
452
</tr>
 
453
</tbody>
 
454
</table></div>
 
455
</div>
 
456
</div>
 
457
<div class="refsect1">
 
458
<a name="GcrCertificateWidget.property-details"></a><h2>Property Details</h2>
 
459
<div class="refsect2">
 
460
<a name="GcrCertificateWidget--attributes"></a><h3>The <code class="literal">"attributes"</code> property</h3>
 
461
<pre class="programlisting">  "attributes"               <a href="http://developer.gnome.org/gck/stable/GckAttributes.html"><span class="type">GckAttributes</span></a>*        : Read / Write</pre>
 
462
<p>Attributes which contain the certificate.</p>
 
463
</div>
 
464
<hr>
 
465
<div class="refsect2">
 
466
<a name="GcrCertificateWidget--certificate"></a><h3>The <code class="literal">"certificate"</code> property</h3>
 
467
<pre class="programlisting">  "certificate"              <a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="type">GcrCertificate</span></a>*       : Read / Write</pre>
 
468
<p>Certificate to display.</p>
 
469
</div>
 
470
<hr>
 
471
<div class="refsect2">
 
472
<a name="GcrCertificateRenderer--attributes"></a><h3>The <code class="literal">"attributes"</code> property</h3>
 
473
<pre class="programlisting">  "attributes"               <a href="http://developer.gnome.org/gck/stable/GckAttributes.html"><span class="type">GckAttributes</span></a>*        : Read / Write</pre>
 
474
<p>
 
475
The certificate attributes to display. One of the attributes must be
 
476
a CKA_VALUE type attribute which contains a DER encoded certificate.
 
477
</p>
 
478
</div>
 
479
<hr>
 
480
<div class="refsect2">
 
481
<a name="GcrCertificateRenderer--certificate"></a><h3>The <code class="literal">"certificate"</code> property</h3>
 
482
<pre class="programlisting">  "certificate"              <a class="link" href="GcrCertificate.html" title="GcrCertificate"><span class="type">GcrCertificate</span></a>*       : Read / Write</pre>
 
483
<p>
 
484
The certificate to display. May be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 
485
</p>
 
486
</div>
 
487
<hr>
 
488
<div class="refsect2">
 
489
<a name="GcrCertificateRenderer--label"></a><h3>The <code class="literal">"label"</code> property</h3>
 
490
<pre class="programlisting">  "label"                    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 
491
<p>
 
492
The label to display.
 
493
</p>
 
494
<p>Default value: ""</p>
 
495
</div>
 
496
</div>
 
497
</div>
 
498
<div class="footer">
 
499
<hr>
 
500
          Generated by GTK-Doc V1.18</div>
 
501
</body>
 
502
</html>
 
 
b'\\ No newline at end of file'