~ubuntu-branches/ubuntu/natty/gnome-vfs/natty

<h2><span class="refentrytitle"><a name="gnome-vfs-2.0-gnome-vfs-application-registry.top_of_page"></a>Deprecated Application Registry API</span></h2>

<p>Deprecated Application Registry API — formerly used for managing applications. Replaced by

<span class="type">GnomeVFS MIME Database</span> API</p>

</td>

</tr></table></div>

<a name="gnome-vfs-2.0-gnome-vfs-application-registry.synopsis"></a><h2>Synopsis</h2>

#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#GNOME-VFS-APPLICATION-REGISTRY-COMMAND:CAPS" title="GNOME_VFS_APPLICATION_REGISTRY_COMMAND">GNOME_VFS_APPLICATION_REGISTRY_COMMAND</a>

#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#GNOME-VFS-APPLICATION-REGISTRY-NAME:CAPS" title="GNOME_VFS_APPLICATION_REGISTRY_NAME">GNOME_VFS_APPLICATION_REGISTRY_NAME</a>

#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#GNOME-VFS-APPLICATION-REGISTRY-CAN-OPEN-MULTIPLE-FILES:CAPS" title="GNOME_VFS_APPLICATION_REGISTRY_CAN_OPEN_MULTIPLE_FILES">GNOME_VFS_APPLICATION_REGISTRY_CAN_OPEN_MULTIPLE_FILES</a>

#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#GNOME-VFS-APPLICATION-REGISTRY-REQUIRES-TERMINAL:CAPS" title="GNOME_VFS_APPLICATION_REGISTRY_REQUIRES_TERMINAL">GNOME_VFS_APPLICATION_REGISTRY_REQUIRES_TERMINAL</a>

gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-exists" title="gnome_vfs_application_registry_exists ()">gnome_vfs_application_registry_exists</a>

(const char *app_id);

GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-get-keys" title="gnome_vfs_application_registry_get_keys ()">gnome_vfs_application_registry_get_keys</a>

(const char *app_id);

const char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-peek-value" title="gnome_vfs_application_registry_peek_value ()">gnome_vfs_application_registry_peek_value</a>

(const char *app_id,

const char *key);

gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-get-bool-value" title="gnome_vfs_application_registry_get_bool_value ()">gnome_vfs_application_registry_get_bool_value</a>

(const char *app_id,

const char *key,

gboolean *got_key);

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-remove-application" title="gnome_vfs_application_registry_remove_application ()">gnome_vfs_application_registry_remove_application</a>

(const char *app_id);

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-set-value" title="gnome_vfs_application_registry_set_value ()">gnome_vfs_application_registry_set_value</a>

(const char *app_id,

const char *key,

const char *value);

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-set-bool-value" title="gnome_vfs_application_registry_set_bool_value ()">gnome_vfs_application_registry_set_bool_value</a>

(const char *app_id,

const char *key,

gboolean value);

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-unset-key" title="gnome_vfs_application_registry_unset_key ()">gnome_vfs_application_registry_unset_key</a>

(const char *app_id,

const char *key);

GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-get-applications" title="gnome_vfs_application_registry_get_applications ()">gnome_vfs_application_registry_get_applications</a>

(const char *mime_type);

GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-get-mime-types" title="gnome_vfs_application_registry_get_mime_types ()">gnome_vfs_application_registry_get_mime_types</a>

(const char *app_id);

gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-supports-mime-type" title="gnome_vfs_application_registry_supports_mime_type ()">gnome_vfs_application_registry_supports_mime_type</a>

(const char *app_id,

const char *mime_type);

gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-supports-uri-scheme" title="gnome_vfs_application_registry_supports_uri_scheme ()">gnome_vfs_application_registry_supports_uri_scheme</a>

(const char *app_id,

const char *uri_scheme);

gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-is-user-owned-application" title="gnome_vfs_application_is_user_owned_application ()">gnome_vfs_application_is_user_owned_application</a>

(const <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *application);

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-clear-mime-types" title="gnome_vfs_application_registry_clear_mime_types ()">gnome_vfs_application_registry_clear_mime_types</a>

(const char *app_id);

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-add-mime-type" title="gnome_vfs_application_registry_add_mime_type ()">gnome_vfs_application_registry_add_mime_type</a>

(const char *app_id,

const char *mime_type);

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-remove-mime-type" title="gnome_vfs_application_registry_remove_mime_type ()">gnome_vfs_application_registry_remove_mime_type</a>

(const char *app_id,

const char *mime_type);

100

<a class="link" href="gnome-vfs-2.0-gnome-vfs-result.html#GnomeVFSResult" title="enum GnomeVFSResult">GnomeVFSResult</a> <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-sync" title="gnome_vfs_application_registry_sync ()">gnome_vfs_application_registry_sync</a> (void);

101

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-shutdown" title="gnome_vfs_application_registry_shutdown ()">gnome_vfs_application_registry_shutdown</a>

102

(void);

103

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-reload" title="gnome_vfs_application_registry_reload ()">gnome_vfs_application_registry_reload</a>

104

(void);

105

<a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-get-mime-application" title="gnome_vfs_application_registry_get_mime_application ()">gnome_vfs_application_registry_get_mime_application</a>

106

(const char *app_id);

107

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-application-registry.html#gnome-vfs-application-registry-save-mime-application" title="gnome_vfs_application_registry_save_mime_application ()">gnome_vfs_application_registry_save_mime_application</a>

108

(const <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *application);

109

</pre>

110

</div>

111

112

<a name="gnome-vfs-2.0-gnome-vfs-application-registry.description"></a><h2>Description</h2>

113

<p>

114

This API was formerly used to manage the applications known

115

to GnomeVFS, providing editing capabilities. The system was

116

overengineered and not very performant, so it has been

117

replaced by a new API, described in the

118

<span class="type">GnomeVFS MIME Database</span>

119

section.

120

</p>

121

</div>

122

123

<a name="gnome-vfs-2.0-gnome-vfs-application-registry.details"></a><h2>Details</h2>

124

125

<a name="GNOME-VFS-APPLICATION-REGISTRY-COMMAND:CAPS"></a><h3>GNOME_VFS_APPLICATION_REGISTRY_COMMAND</h3>

126

<pre class="programlisting">#define GNOME_VFS_APPLICATION_REGISTRY_COMMAND "command"

127

</pre>

128

129

<h3 class="title">Warning</h3>

130

<p><code class="literal">GNOME_VFS_APPLICATION_REGISTRY_COMMAND</code> is deprecated and should not be used in newly-written code.</p>

131

</div>

132

<p>

133

Application registry key for fetching the command to execute

134

an application.</p>

135

<p>

136

</p>

137

</div>

138

<hr>

139

140

<a name="GNOME-VFS-APPLICATION-REGISTRY-NAME:CAPS"></a><h3>GNOME_VFS_APPLICATION_REGISTRY_NAME</h3>

141

<pre class="programlisting">#define GNOME_VFS_APPLICATION_REGISTRY_NAME "name"

142

</pre>

143

144

<h3 class="title">Warning</h3>

145

<p><code class="literal">GNOME_VFS_APPLICATION_REGISTRY_NAME</code> is deprecated and should not be used in newly-written code.</p>

146

</div>

147

<p>

148

Application registry key for fetching the name of an application.</p>

149

<p>

150

</p>

151

</div>

152

<hr>

153

154

<a name="GNOME-VFS-APPLICATION-REGISTRY-CAN-OPEN-MULTIPLE-FILES:CAPS"></a><h3>GNOME_VFS_APPLICATION_REGISTRY_CAN_OPEN_MULTIPLE_FILES</h3>

155

<pre class="programlisting">#define GNOME_VFS_APPLICATION_REGISTRY_CAN_OPEN_MULTIPLE_FILES "can_open_multiple_files"

156

</pre>

157

158

<h3 class="title">Warning</h3>

159

<p><code class="literal">GNOME_VFS_APPLICATION_REGISTRY_CAN_OPEN_MULTIPLE_FILES</code> is deprecated and should not be used in newly-written code.</p>

160

</div>

161

<p>

162

Application registry key for determining if an application

163

can open multiple files in the same invocation.</p>

164

<p>

165

</p>

166

</div>

167

<hr>

168

169

<a name="GNOME-VFS-APPLICATION-REGISTRY-REQUIRES-TERMINAL:CAPS"></a><h3>GNOME_VFS_APPLICATION_REGISTRY_REQUIRES_TERMINAL</h3>

170

<pre class="programlisting">#define GNOME_VFS_APPLICATION_REGISTRY_REQUIRES_TERMINAL "requires_terminal"

171

</pre>

172

173

<h3 class="title">Warning</h3>

174

<p><code class="literal">GNOME_VFS_APPLICATION_REGISTRY_REQUIRES_TERMINAL</code> is deprecated and should not be used in newly-written code.</p>

175

</div>

176

<p>

177

Application registry key for determining if an application

178

needs to run from within a terminal (for example, mpg123)</p>

179

<p>

180

</p>

181

</div>

182

<hr>

183

184

<a name="gnome-vfs-application-registry-exists"></a><h3>gnome_vfs_application_registry_exists ()</h3>

185

<pre class="programlisting">gboolean gnome_vfs_application_registry_exists

186

(const char *app_id);</pre>

187

188

<h3 class="title">Warning</h3>

189

<p><code class="literal">gnome_vfs_application_registry_exists</code> is deprecated and should not be used in newly-written code. All application registry functions have been

190

deprecated. Use the functions available in gnome-mime-handlers

191

instead.</p>

192

</div>

193

<p>

194

This function will return TRUE if there is an entry for <em class="parameter"><code>app_id</code></em> in

195

the registry, otherwise FALSE.</p>

196

<p>

197

</p>

198

199

200

<tbody>

201

<tr>

202

203

<td> an application ID

204

</td>

205

</tr>

206

<tr>

207

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

208

<td> TRUE if the application is in the registry, FALSE if not

209

210

</td>

211

</tr>

212

</tbody>

213

</table></div>

214

</div>

215

<hr>

216

217

<a name="gnome-vfs-application-registry-get-keys"></a><h3>gnome_vfs_application_registry_get_keys ()</h3>

218

<pre class="programlisting">GList * gnome_vfs_application_registry_get_keys

219

(const char *app_id);</pre>

220

221

<h3 class="title">Warning</h3>

222

<p><code class="literal">gnome_vfs_application_registry_get_keys</code> is deprecated and should not be used in newly-written code. All application registry functions have been

223

deprecated. Use the functions available in gnome-mime-handlers

224

instead.</p>

225

</div>

226

<p>

227

This function wil return a list of strings which is the list of

228

keys set for <em class="parameter"><code>app_id</code></em> in the application registry.</p>

229

<p>

230

</p>

231

232

233

<tbody>

234

<tr>

235

236

<td> the application ID for which to get keys

237

</td>

238

</tr>

239

<tr>

240

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

241

242

243

</td>

244

</tr>

245

</tbody>

246

</table></div>

247

</div>

248

<hr>

249

250

<a name="gnome-vfs-application-registry-peek-value"></a><h3>gnome_vfs_application_registry_peek_value ()</h3>

251

<pre class="programlisting">const char * gnome_vfs_application_registry_peek_value

252

(const char *app_id,

253

const char *key);</pre>

254

255

<h3 class="title">Warning</h3>

256

<p><code class="literal">gnome_vfs_application_registry_peek_value</code> is deprecated and should not be used in newly-written code. All application registry functions have been

257

deprecated. Use the functions available in gnome-mime-handlers

258

instead.</p>

259

</div>

260

<p>

261

This will return the value associated with <em class="parameter"><code>key</code></em> for <em class="parameter"><code>app_id</code></em> in the

262

application registry. There is no need to free the return value.</p>

263

<p>

264

</p>

265

266

267

<tbody>

268

<tr>

269

270

<td> the application ID for which to look up a value

271

</td>

272

</tr>

273

<tr>

274

275

<td> the key to look up

276

</td>

277

</tr>

278

<tr>

279

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

280

<td> the value associated with the key, or NULL if there is no

281

associated value

282

283

284

</td>

285

</tr>

286

</tbody>

287

</table></div>

288

</div>

289

<hr>

290

291

<a name="gnome-vfs-application-registry-get-bool-value"></a><h3>gnome_vfs_application_registry_get_bool_value ()</h3>

292

<pre class="programlisting">gboolean gnome_vfs_application_registry_get_bool_value

293

(const char *app_id,

294

const char *key,

295

gboolean *got_key);</pre>

296

297

<h3 class="title">Warning</h3>

298

<p><code class="literal">gnome_vfs_application_registry_get_bool_value</code> is deprecated and should not be used in newly-written code. All application registry functions have been

299

deprecated. Use the functions available in gnome-mime-handlers

300

instead.</p>

301

</div>

302

<p>

303

This will look up a key in the structure pointed to by app_id and return the

304

boolean value of that key. It will return false if there are no

305

applications associated with the app_id.</p>

306

<p>

307

</p>

308

309

310

<tbody>

311

<tr>

312

313

<td> registry id of the application

314

</td>

315

</tr>

316

<tr>

317

318

<td> key to look up

319

</td>

320

</tr>

321

<tr>

322

323

<td> TRUE if a setting was dound, otherwise FALSE

324

</td>

325

</tr>

326

<tr>

327

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

328

<td> TRUE if <em class="parameter"><code>key</code></em> is set to "true" or "yes" for <em class="parameter"><code>app_id</code></em>, otherwise FALSE

329

330

</td>

331

</tr>

332

</tbody>

333

</table></div>

334

</div>

335

<hr>

336

337

<a name="gnome-vfs-application-registry-remove-application"></a><h3>gnome_vfs_application_registry_remove_application ()</h3>

338

<pre class="programlisting">void gnome_vfs_application_registry_remove_application

339

(const char *app_id);</pre>

340

341

<h3 class="title">Warning</h3>

342

<p><code class="literal">gnome_vfs_application_registry_remove_application</code> is deprecated and should not be used in newly-written code. All application registry functions have been

343

deprecated. Use the functions available in gnome-mime-handlers

344

instead.</p>

345

</div>

346

<p>

347

Given the registry id this function will remove all applications that has

348

been set by the user. You will need to call

349

gnome_vfs_application_registry_sync to save the changes.</p>

350

<p>

351

</p>

352

353

354

355

356

<td> registry id of the application

357

</td>

358

</tr></tbody>

359

</table></div>

360

</div>

361

<hr>

362

363

<a name="gnome-vfs-application-registry-set-value"></a><h3>gnome_vfs_application_registry_set_value ()</h3>

364

<pre class="programlisting">void gnome_vfs_application_registry_set_value

365

(const char *app_id,

366

const char *key,

367

const char *value);</pre>

368

369

<h3 class="title">Warning</h3>

370

<p><code class="literal">gnome_vfs_application_registry_set_value</code> is deprecated and should not be used in newly-written code. All application registry functions have been

371

deprecated. Use the functions available in gnome-mime-handlers

372

instead.</p>

373

</div>

374

<p>

375

This function will set values pertaining to registry entry pointed to by

376

app_id. You will need to call gnome_vfs_application_registry_sync to

377

realize the changes.</p>

378

<p>

379

</p>

380

381

382

<tbody>

383

<tr>

384

385

<td> registry id of the application

386

</td>

387

</tr>

388

<tr>

389

390

<td> target key

391

</td>

392

</tr>

393

<tr>

394

<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>

395

<td> value to set the target key to

396

</td>

397

</tr>

398

</tbody>

399

</table></div>

400

</div>

401

<hr>

402

403

<a name="gnome-vfs-application-registry-set-bool-value"></a><h3>gnome_vfs_application_registry_set_bool_value ()</h3>

404

<pre class="programlisting">void gnome_vfs_application_registry_set_bool_value

405

(const char *app_id,

406

const char *key,

407

gboolean value);</pre>

408

409

<h3 class="title">Warning</h3>

410

<p><code class="literal">gnome_vfs_application_registry_set_bool_value</code> is deprecated and should not be used in newly-written code. All application registry functions have been

411

deprecated. Use the functions available in gnome-mime-handlers

412

instead.</p>

413

</div>

414

<p>

415

This function will modify those registry values that are of type boolean to

416

a value specified by the user. You will need to call

417

gnome_vfs_application_registry_sync to save your changes.</p>

418

<p>

419

</p>

420

421

422

<tbody>

423

<tr>

424

425

<td> registry id of the application

426

</td>

427

</tr>

428

<tr>

429

430

<td> target key

431

</td>

432

</tr>

433

<tr>

434

<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>

435

<td> value you want to set the target key to

436

</td>

437

</tr>

438

</tbody>

439

</table></div>

440

</div>

441

<hr>

442

443

<a name="gnome-vfs-application-registry-unset-key"></a><h3>gnome_vfs_application_registry_unset_key ()</h3>

444

<pre class="programlisting">void gnome_vfs_application_registry_unset_key

445

(const char *app_id,

446

const char *key);</pre>

447

448

<h3 class="title">Warning</h3>

449

<p><code class="literal">gnome_vfs_application_registry_unset_key</code> is deprecated and should not be used in newly-written code. All application registry functions have been

450

deprecated. Use the functions available in gnome-mime-handlers

451

instead.</p>

452

</div>

453

<p>

454

This function given the application and the target will wipe the current

455

value that the key contains.</p>

456

<p>

457

</p>

458

459

460

<tbody>

461

<tr>

462

463

<td> registry id of the application

464

</td>

465

</tr>

466

<tr>

467

468

<td> search key

469

</td>

470

</tr>

471

</tbody>

472

</table></div>

473

</div>

474

<hr>

475

476

<a name="gnome-vfs-application-registry-get-applications"></a><h3>gnome_vfs_application_registry_get_applications ()</h3>

477

<pre class="programlisting">GList * gnome_vfs_application_registry_get_applications

478

(const char *mime_type);</pre>

479

480

<h3 class="title">Warning</h3>

481

<p><code class="literal">gnome_vfs_application_registry_get_applications</code> is deprecated and should not be used in newly-written code. All application registry functions have been

482

deprecated. Use the functions available in gnome-mime-handlers

483

instead.</p>

484

</div>

485

<p>

486

This will return all applications from the registry that are associated with

487

the given mime type string, if NULL it returns all applications.</p>

488

<p>

489

</p>

490

491

492

<tbody>

493

<tr>

494

495

<td> mime type string

496

</td>

497

</tr>

498

<tr>

499

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

500

<td> a list of the application IDs for all applications which

501

support the given mime type.

502

503

</td>

504

</tr>

505

</tbody>

506

</table></div>

507

</div>

508

<hr>

509

510

<a name="gnome-vfs-application-registry-get-mime-types"></a><h3>gnome_vfs_application_registry_get_mime_types ()</h3>

511

<pre class="programlisting">GList * gnome_vfs_application_registry_get_mime_types

512

(const char *app_id);</pre>

513

514

<h3 class="title">Warning</h3>

515

<p><code class="literal">gnome_vfs_application_registry_get_mime_types</code> is deprecated and should not be used in newly-written code. All application registry functions have been

516

deprecated. Use the functions available in gnome-mime-handlers

517

instead.</p>

518

</div>

519

<p>

520

This function returns a list of strings that represent the mime

521

types that can be handled by an application.</p>

522

<p>

523

</p>

524

525

526

<tbody>

527

<tr>

528

529

<td> registry id of application

530

</td>

531

</tr>

532

<tr>

533

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

534

<td> a list of the mime types supported

535

536

</td>

537

</tr>

538

</tbody>

539

</table></div>

540

</div>

541

<hr>

542

543

<a name="gnome-vfs-application-registry-supports-mime-type"></a><h3>gnome_vfs_application_registry_supports_mime_type ()</h3>

544

<pre class="programlisting">gboolean gnome_vfs_application_registry_supports_mime_type

545

(const char *app_id,

546

const char *mime_type);</pre>

547

548

<h3 class="title">Warning</h3>

549

<p><code class="literal">gnome_vfs_application_registry_supports_mime_type</code> is deprecated and should not be used in newly-written code. All application registry functions have been

550

deprecated. Use the functions available in gnome-mime-handlers

551

instead.</p>

552

</div>

553

<p>

554

Use this function to see if there is an application associated with a given

555

mime type. The function will return true or false.</p>

556

<p>

557

</p>

558

559

560

<tbody>

561

<tr>

562

563

<td> registry id of application

564

</td>

565

</tr>

566

<tr>

567

568

<td> mime type string

569

</td>

570

</tr>

571

<tr>

572

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

573

<td> TRUE if <em class="parameter"><code>app_id</code></em> supports <em class="parameter"><code>mime_type</code></em>, otherwise FALSE.

574

575

</td>

576

</tr>

577

</tbody>

578

</table></div>

579

</div>

580

<hr>

581

582

<a name="gnome-vfs-application-registry-supports-uri-scheme"></a><h3>gnome_vfs_application_registry_supports_uri_scheme ()</h3>

583

<pre class="programlisting">gboolean gnome_vfs_application_registry_supports_uri_scheme

584

(const char *app_id,

585

const char *uri_scheme);</pre>

586

587

<h3 class="title">Warning</h3>

588

<p><code class="literal">gnome_vfs_application_registry_supports_uri_scheme</code> is deprecated and should not be used in newly-written code. All application registry functions have been

589

deprecated. Use the functions available in gnome-mime-handlers

590

instead.</p>

591

</div>

592

<p>

593

Given the id of the application this function will determine if the

594

uri scheme will given is supported.</p>

595

<p>

596

</p>

597

598

599

<tbody>

600

<tr>

601

602

<td> registry id of application

603

</td>

604

</tr>

605

<tr>

606

<td><p><span class="term"><em class="parameter"><code>uri_scheme</code></em> :</span></p></td>

607

<td> uri schme string

608

</td>

609

</tr>

610

<tr>

611

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

612

<td> TRUE if <em class="parameter"><code>app_id</code></em> supports <em class="parameter"><code>uri_scheme</code></em>, otherwise FALSE

613

614

</td>

615

</tr>

616

</tbody>

617

</table></div>

618

</div>

619

<hr>

620

621

<a name="gnome-vfs-application-is-user-owned-application"></a><h3>gnome_vfs_application_is_user_owned_application ()</h3>

622

<pre class="programlisting">gboolean gnome_vfs_application_is_user_owned_application

623

(const <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *application);</pre>

624

625

<h3 class="title">Warning</h3>

626

<p><code class="literal">gnome_vfs_application_is_user_owned_application</code> is deprecated and should not be used in newly-written code. All application registry functions have been

627

deprecated. Use the functions available in gnome-mime-handlers

628

instead.</p>

629

</div>

630

<p>

631

This function will determine if a mime application is user owned or not. By

632

user ownered this means that the application is not a system application

633

located in the prerequisite /usr area but rather in the user's area.</p>

634

<p>

635

</p>

636

637

638

<tbody>

639

<tr>

640

<td><p><span class="term"><em class="parameter"><code>application</code></em> :</span></p></td>

641

<td> data structure of the mime application

642

</td>

643

</tr>

644

<tr>

645

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

646

<td> gboolean

647

648

</td>

649

</tr>

650

</tbody>

651

</table></div>

652

</div>

653

<hr>

654

655

<a name="gnome-vfs-application-registry-clear-mime-types"></a><h3>gnome_vfs_application_registry_clear_mime_types ()</h3>

656

<pre class="programlisting">void gnome_vfs_application_registry_clear_mime_types

657

(const char *app_id);</pre>

658

659

<h3 class="title">Warning</h3>

660

<p><code class="literal">gnome_vfs_application_registry_clear_mime_types</code> is deprecated and should not be used in newly-written code. All application registry functions have been

661

deprecated. Use the functions available in gnome-mime-handlers

662

instead.</p>

663

</div>

664

<p>

665

This function will remove the mime types associated with the application.

666

Changes are not realized until the gnome_vfs_application_registry_sync

667

function is called to save the changes to the file.</p>

668

<p>

669

</p>

670

671

672

673

674

<td> Application id

675

</td>

676

</tr></tbody>

677

</table></div>

678

</div>

679

<hr>

680

681

<a name="gnome-vfs-application-registry-add-mime-type"></a><h3>gnome_vfs_application_registry_add_mime_type ()</h3>

682

<pre class="programlisting">void gnome_vfs_application_registry_add_mime_type

683

(const char *app_id,

684

const char *mime_type);</pre>

685

686

<h3 class="title">Warning</h3>

687

<p><code class="literal">gnome_vfs_application_registry_add_mime_type</code> is deprecated and should not be used in newly-written code. All application registry functions have been

688

deprecated. Use the functions available in gnome-mime-handlers

689

instead.</p>

690

</div>

691

<p>

692

This function will associate a mime type with an application given the

693

application registry id and the mime type. Changes are not realized until

694

the gnome_vfs_application_registry_sync function is called to save the

695

changes to the file.</p>

696

<p>

697

</p>

698

699

700

<tbody>

701

<tr>

702

703

<td> registry id of application

704

</td>

705

</tr>

706

<tr>

707

708

<td> mime type string

709

</td>

710

</tr>

711

</tbody>

712

</table></div>

713

</div>

714

<hr>

715

716

<a name="gnome-vfs-application-registry-remove-mime-type"></a><h3>gnome_vfs_application_registry_remove_mime_type ()</h3>

717

<pre class="programlisting">void gnome_vfs_application_registry_remove_mime_type

718

(const char *app_id,

719

const char *mime_type);</pre>

720

721

<h3 class="title">Warning</h3>

722

<p><code class="literal">gnome_vfs_application_registry_remove_mime_type</code> is deprecated and should not be used in newly-written code. All application registry functions have been

723

deprecated. Use the functions available in gnome-mime-handlers

724

instead.</p>

725

</div>

726

<p>

727

This function will de-associate a mime type from an application registry.

728

Given the application registry id and the mime type. Changes are not

729

realized until the gnome_vfs_application_registry_sync function is called to

730

save the changes to the file.</p>

731

<p>

732

</p>

733

734

735

<tbody>

736

<tr>

737

738

<td> registry id of the application

739

</td>

740

</tr>

741

<tr>

742

743

<td> mime type string

744

</td>

745

</tr>

746

</tbody>

747

</table></div>

748

</div>

749

<hr>

750

751

<a name="gnome-vfs-application-registry-sync"></a><h3>gnome_vfs_application_registry_sync ()</h3>

752

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-result.html#GnomeVFSResult" title="enum GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_application_registry_sync (void);</pre>

753

754

<h3 class="title">Warning</h3>

755

<p><code class="literal">gnome_vfs_application_registry_sync</code> is deprecated and should not be used in newly-written code. All application registry functions have been

756

deprecated. Use the functions available in gnome-mime-handlers

757

instead.</p>

758

</div>

759

<p>

760

This function will sync the registry. Typically you would use this function

761

after a modification of the registry. When you modify the registry a dirty

762

flag is set. Calling this function will save your modifications to disk and

763

reset the flag.

764

</p>

765

<p>

766

If successful, will return GNOME_VFS_OK</p>

767

<p>

768

</p>

769

770

771

772

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

773

<td> GnomeVFSResult

774

775

</td>

776

</tr></tbody>

777

</table></div>

778

</div>

779

<hr>

780

781

<a name="gnome-vfs-application-registry-shutdown"></a><h3>gnome_vfs_application_registry_shutdown ()</h3>

782

<pre class="programlisting">void gnome_vfs_application_registry_shutdown

783

(void);</pre>

784

785

<h3 class="title">Warning</h3>

786

<p><code class="literal">gnome_vfs_application_registry_shutdown</code> is deprecated and should not be used in newly-written code. All application registry functions have been

787

deprecated. Use the functions available in gnome-mime-handlers

788

instead.</p>

789

</div>

790

<p>

791

Synchronize gnome-vfs application registry data to disk, and free

792

resources.</p>

793

<p>

794

</p>

795

</div>

796

<hr>

797

798

<a name="gnome-vfs-application-registry-reload"></a><h3>gnome_vfs_application_registry_reload ()</h3>

799

<pre class="programlisting">void gnome_vfs_application_registry_reload

800

(void);</pre>

801

802

<h3 class="title">Warning</h3>

803

<p><code class="literal">gnome_vfs_application_registry_reload</code> is deprecated and should not be used in newly-written code. All application registry functions have been

804

deprecated. Use the functions available in gnome-mime-handlers

805

instead.</p>

806

</div>

807

<p>

808

If this function is called for the first time it will initialize the

809

registry. Subsequent calls to the function will clear out the current

810

registry contents and load registry contents from the save file. Make

811

certain that you've saved your registry before calling this function. It

812

will destroy unsaved changes.</p>

813

<p>

814

</p>

815

</div>

816

<hr>

817

818

<a name="gnome-vfs-application-registry-get-mime-application"></a><h3>gnome_vfs_application_registry_get_mime_application ()</h3>

819

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> * gnome_vfs_application_registry_get_mime_application

820

(const char *app_id);</pre>

821

822

<h3 class="title">Warning</h3>

823

<p><code class="literal">gnome_vfs_application_registry_get_mime_application</code> is deprecated and should not be used in newly-written code. All application registry functions have been

824

deprecated. Use the functions available in gnome-mime-handlers

825

instead.</p>

826

</div>

827

<p>

828

Returns a structure that contains the application that handles

829

the mime type associated by the application referred by app_id.</p>

830

<p>

831

</p>

832

833

834

<tbody>

835

<tr>

836

837

<td> registry id of the application

838

</td>

839

</tr>

840

<tr>

841

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

842

<td> GnomeVFSMimeApplication

843

844

</td>

845

</tr>

846

</tbody>

847

</table></div>

848

</div>

849

<hr>

850

851

<a name="gnome-vfs-application-registry-save-mime-application"></a><h3>gnome_vfs_application_registry_save_mime_application ()</h3>

852

<pre class="programlisting">void gnome_vfs_application_registry_save_mime_application

853

(const <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *application);</pre>

854

855

<h3 class="title">Warning</h3>

856

<p><code class="literal">gnome_vfs_application_registry_save_mime_application</code> is deprecated and should not be used in newly-written code. All application registry functions have been

857

deprecated. Use the functions available in gnome-mime-handlers

858

instead.</p>

859

</div>

860

<p>

861

This will save to the registry the application that will be associated with

862

a defined mime type. The defined mime type is located within the

863

GnomeVFSMimeApplication structure. Changes are not realized until the

864

gnome_vfs_application_registry_sync function is called.</p>

865

<p>

866

</p>

867

868

869

870

<td><p><span class="term"><em class="parameter"><code>application</code></em> :</span></p></td>

871

<td> application associated with the mime type

872

</td>

873

</tr></tbody>

874

</table></div>

875

</div>

876

</div>

877

878

879

<p>

880

<span class="type">GnomeVFS MIME Database API</span>

881

</p>

882

</div>

883

</div>

884

885

<hr>

886

Generated by GTK-Doc V1.12</div>

887

</body>

888

</html>

Older »