~ubuntu-branches/ubuntu/utopic/glib2.0/utopic

<a class="link" href="ExampleCat.html#example-cat-override-properties" title="example_cat_override_properties ()">example_cat_override_properties</a> ()

155

</div>

156

157

<a name="ExampleCat.object-hierarchy"></a><h2>Object Hierarchy</h2>

158

<pre class="screen"> GInterface

158

<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>

159

╰── ExampleCat

160

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

160

<a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>

161

├── <a class="link" href="GDBusInterfaceSkeleton.html" title="GDBusInterfaceSkeleton">GDBusInterfaceSkeleton</a>

162

│ ╰── ExampleCatSkeleton

163

╰── <a class="link" href="GDBusProxy.html" title="GDBusProxy">GDBusProxy</a>

168

<a name="ExampleCat.prerequisites"></a><h2>Prerequisites</h2>

169

170

ExampleCat requires

171

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>.

171

<a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>.

172

</div>

173

174

<a name="ExampleCat.implemented-interfaces"></a><h2>Implemented Interfaces</h2>

205

<hr>

206

207

<a name="example-cat-override-properties"></a><h3>example_cat_override_properties ()</h3>

208

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a>

209

example_cat_override_properties (<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass">GObjectClass</a> *klass</code>,

210

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> property_id_begin</code>);</pre>

211

Overrides all <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> properties in the <a class="link" href="ExampleCat.html" title="ExampleCat">ExampleCat</a> interface for a concrete class.

208

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint">guint</a>

209

example_cat_override_properties (<code><a href="../gobject/gobject-The-Base-Object-Type.html#GObjectClass">GObjectClass</a> *klass</code>,

210

<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> property_id_begin</code>);</pre>

211

Overrides all <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a> properties in the <a class="link" href="ExampleCat.html" title="ExampleCat">ExampleCat</a> interface for a concrete class.

212

The properties are overridden in the order they are defined.

213

214

<a name="id-1.5.5.6.6.12.3.5"></a><h4>Parameters</h4>

221

<tbody>

222

<tr>

223

<td class="parameter_name">klass</td>

224

<td class="parameter_description">The class structure for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>-derived class.</td>

224

<td class="parameter_description">The class structure for a <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>-derived class.</td>

225

226

</tr>

227

<tr>

244

<pre class="programlisting">void

245

example_cat_proxy_new (<code><a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> *connection</code>,

246

<code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags">GDBusProxyFlags</a> flags</code>,

247

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

248

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

247

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

248

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

249

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

250

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

251

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

251

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

252

Asynchronously creates a proxy for the D-Bus interface <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Cat.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</a>. See <a class="link" href="GDBusProxy.html#g-dbus-proxy-new" title="g_dbus_proxy_new ()"><code class="function">g_dbus_proxy_new()</code></a> for more details.

253

When the operation is finished, <code>callback</code>

254

will be invoked in the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.

254

will be invoked in the <a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.

255

You can then call <a class="link" href="ExampleCat.html#example-cat-proxy-new-finish" title="example_cat_proxy_new_finish ()"><code class="function">example_cat_proxy_new_finish()</code></a> to get the result of the operation.

256

See <a class="link" href="ExampleCat.html#example-cat-proxy-new-sync" title="example_cat_proxy_new_sync ()"><code class="function">example_cat_proxy_new_sync()</code></a> for the synchronous, blocking version of this constructor.

257

275

</tr>

276

<tr>

277

278

<td class="parameter_description"> A bus name (well-known or unique) or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>connection</code>

278

<td class="parameter_description"> A bus name (well-known or unique) or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>connection</code>

279

is not a message bus connection. </td>

280

<td class="parameter_annotations">[<acronym title="NULL is OK, both for passing and for returning.">allow-none</acronym>]</td>

281

</tr>

286

</tr>

287

<tr>

288

<td class="parameter_name">cancellable</td>

289

<td class="parameter_description"> A <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

289

<td class="parameter_description"> A <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

290

<td class="parameter_annotations">[<acronym title="NULL is OK, both for passing and for returning.">allow-none</acronym>]</td>

291

</tr>

292

<tr>

309

<a name="example-cat-proxy-new-finish"></a><h3>example_cat_proxy_new_finish ()</h3>

310

<pre class="programlisting"><a class="link" href="ExampleCat.html" title="ExampleCat">ExampleCat</a> *

311

example_cat_proxy_new_finish (<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

312

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

312

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

313

Finishes an operation started with <a class="link" href="ExampleCat.html#example-cat-proxy-new" title="example_cat_proxy_new ()"><code class="function">example_cat_proxy_new()</code></a>.

314

315

<a name="id-1.5.5.6.6.12.5.5"></a><h4>Parameters</h4>

327

</tr>

328

<tr>

329

<td class="parameter_name">error</td>

330

<td class="parameter_description">Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

330

<td class="parameter_description">Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

331

332

</tr>

333

</tbody>

335

</div>

336

337

<a name="id-1.5.5.6.6.12.5.6"></a><h4>Returns</h4>

338

The constructed proxy object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

338

The constructed proxy object or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

339

is set.

340

[<acronym title="Free data after the code is done.">transfer full</acronym>][<acronym title="Override the parsed C type with given type.">type</acronym> ExampleCatProxy]

341

</div>

346

<pre class="programlisting"><a class="link" href="ExampleCat.html" title="ExampleCat">ExampleCat</a> *

347

example_cat_proxy_new_sync (<code><a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a> *connection</code>,

348

<code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags">GDBusProxyFlags</a> flags</code>,

349

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

350

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

349

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

350

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

351

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

352

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

352

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

353

Synchronously creates a proxy for the D-Bus interface <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Cat.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</a>. See <a class="link" href="GDBusProxy.html#g-dbus-proxy-new-sync" title="g_dbus_proxy_new_sync ()"><code class="function">g_dbus_proxy_new_sync()</code></a> for more details.

354

The calling thread is blocked until a reply is received.

355

See <a class="link" href="ExampleCat.html#example-cat-proxy-new" title="example_cat_proxy_new ()"><code class="function">example_cat_proxy_new()</code></a> for the asynchronous version of this constructor.

374

</tr>

375

<tr>

376

377

378

is not a message bus connection. </td>

379

<td class="parameter_annotations">[<acronym title="NULL is OK, both for passing and for returning.">allow-none</acronym>]</td>

380

</tr>

385

</tr>

386

<tr>

387

<td class="parameter_name">cancellable</td>

388

389

<td class="parameter_annotations">[<acronym title="NULL is OK, both for passing and for returning.">allow-none</acronym>]</td>

390

</tr>

391

<tr>

392

<td class="parameter_name">error</td>

393

<td class="parameter_description">Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

394

395

</tr>

396

</tbody>

398

</div>

399

400

<a name="id-1.5.5.6.6.12.6.8"></a><h4>Returns</h4>

401

The constructed proxy object or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

402

is set.

403

404

</div>

409

<pre class="programlisting">void

410

example_cat_proxy_new_for_bus (<code><a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType">GBusType</a> bus_type</code>,

411

<code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags">GDBusProxyFlags</a> flags</code>,

412

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

413

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

412

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

413

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

414

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

415

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

416

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

416

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

417

Like <a class="link" href="ExampleCat.html#example-cat-proxy-new" title="example_cat_proxy_new ()"><code class="function">example_cat_proxy_new()</code></a> but takes a <a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType">GBusType</a> instead of a <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a>.

418

When the operation is finished, <code>callback</code>

419

will be invoked in the <a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.

420

You can then call <a class="link" href="ExampleCat.html#example-cat-proxy-new-for-bus-finish" title="example_cat_proxy_new_for_bus_finish ()"><code class="function">example_cat_proxy_new_for_bus_finish()</code></a> to get the result of the operation.

421

See <a class="link" href="ExampleCat.html#example-cat-proxy-new-for-bus-sync" title="example_cat_proxy_new_for_bus_sync ()"><code class="function">example_cat_proxy_new_for_bus_sync()</code></a> for the synchronous, blocking version of this constructor.

422

450

</tr>

451

<tr>

452

<td class="parameter_name">cancellable</td>

453

454

<td class="parameter_annotations">[<acronym title="NULL is OK, both for passing and for returning.">allow-none</acronym>]</td>

455

</tr>

456

<tr>

473

<a name="example-cat-proxy-new-for-bus-finish"></a><h3>example_cat_proxy_new_for_bus_finish ()</h3>

474

<pre class="programlisting"><a class="link" href="ExampleCat.html" title="ExampleCat">ExampleCat</a> *

475

example_cat_proxy_new_for_bus_finish (<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

476

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

476

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

477

Finishes an operation started with <a class="link" href="ExampleCat.html#example-cat-proxy-new-for-bus" title="example_cat_proxy_new_for_bus ()"><code class="function">example_cat_proxy_new_for_bus()</code></a>.

478

479

<a name="id-1.5.5.6.6.12.8.5"></a><h4>Parameters</h4>

491

</tr>

492

<tr>

493

<td class="parameter_name">error</td>

494

<td class="parameter_description">Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

495

496

</tr>

497

</tbody>

499

</div>

500

501

<a name="id-1.5.5.6.6.12.8.6"></a><h4>Returns</h4>

502

The constructed proxy object or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

503

is set.

504

505

</div>

510

<pre class="programlisting"><a class="link" href="ExampleCat.html" title="ExampleCat">ExampleCat</a> *

511

example_cat_proxy_new_for_bus_sync (<code><a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType">GBusType</a> bus_type</code>,

512

<code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags">GDBusProxyFlags</a> flags</code>,

513

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

514

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

513

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *name</code>,

514

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *object_path</code>,

515

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

516

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

516

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

517

Like <a class="link" href="ExampleCat.html#example-cat-proxy-new-sync" title="example_cat_proxy_new_sync ()"><code class="function">example_cat_proxy_new_sync()</code></a> but takes a <a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType">GBusType</a> instead of a <a class="link" href="GDBusConnection.html" title="GDBusConnection">GDBusConnection</a>.

518

The calling thread is blocked until a reply is received.

519

See <a class="link" href="ExampleCat.html#example-cat-proxy-new-for-bus" title="example_cat_proxy_new_for_bus ()"><code class="function">example_cat_proxy_new_for_bus()</code></a> for the asynchronous version of this constructor.

548

</tr>

549

<tr>

550

<td class="parameter_name">cancellable</td>

551

552

<td class="parameter_annotations">[<acronym title="NULL is OK, both for passing and for returning.">allow-none</acronym>]</td>

553

</tr>

554

<tr>

555

<td class="parameter_name">error</td>

556

<td class="parameter_description">Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

557

558

</tr>

559

</tbody>

561

</div>

562

563

<a name="id-1.5.5.6.6.12.9.8"></a><h4>Returns</h4>

564

The constructed proxy object or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

565

is set.

566

567

</div>

603

604

</colgroup>

605

606

<td class="struct_member_name"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GTypeInterface">GTypeInterface</a> <code><a name="ExampleCatIface.parent-iface"></a>parent_iface</code>;</td>

606

<td class="struct_member_name"><a href="../gobject/gobject-Type-Information.html#GTypeInterface">GTypeInterface</a> <code><a name="ExampleCatIface.parent-iface"></a>parent_iface</code>;</td>

607

<td class="struct_member_description">The parent interface.</td>

608

609

</tr></tbody>

Older »