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

<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-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-get-default-application" title="gnome_vfs_mime_get_default_application ()">gnome_vfs_mime_get_default_application</a>

(const char *mime_type);

<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-mime-database.html#gnome-vfs-mime-get-default-application-for-uri" title="gnome_vfs_mime_get_default_application_for_uri ()">gnome_vfs_mime_get_default_application_for_uri</a>

(const char *uri,

const char *mime_type);

GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-get-all-applications" title="gnome_vfs_mime_get_all_applications ()">gnome_vfs_mime_get_all_applications</a> (const char *mime_type);

GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-get-all-applications-for-uri" title="gnome_vfs_mime_get_all_applications_for_uri ()">gnome_vfs_mime_get_all_applications_for_uri</a>

(const char *uri,

const char *mime_type);

GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-get-all-desktop-entries" title="gnome_vfs_mime_get_all_desktop_entries ()">gnome_vfs_mime_get_all_desktop_entries</a>

(const char *mime_type);

gchar * <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-get-default-desktop-entry" title="gnome_vfs_mime_get_default_desktop_entry ()">gnome_vfs_mime_get_default_desktop_entry</a>

(const char *mime_type);

Bonobo_ServerInfo * <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-get-default-component" title="gnome_vfs_mime_get_default_component ()">gnome_vfs_mime_get_default_component</a>

(const char *mime_type);

GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-get-all-components" title="gnome_vfs_mime_get_all_components ()">gnome_vfs_mime_get_all_components</a> (const char *mime_type);

const char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-get-icon" title="gnome_vfs_mime_get_icon ()">gnome_vfs_mime_get_icon</a> (const char *mime_type);

const char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-get-description" title="gnome_vfs_mime_get_description ()">gnome_vfs_mime_get_description</a> (const char *mime_type);

gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-can-be-executable" title="gnome_vfs_mime_can_be_executable ()">gnome_vfs_mime_can_be_executable</a> (const char *mime_type);

<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-mime-database.html#gnome-vfs-mime-application-new-from-desktop-id" title="gnome_vfs_mime_application_new_from_desktop_id ()">gnome_vfs_mime_application_new_from_desktop_id</a>

(const char *id);

<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-mime-database.html#gnome-vfs-mime-application-launch" title="gnome_vfs_mime_application_launch ()">gnome_vfs_mime_application_launch</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *app,

GList *uris);

<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-mime-database.html#gnome-vfs-mime-application-launch-with-env" title="gnome_vfs_mime_application_launch_with_env ()">gnome_vfs_mime_application_launch_with_env</a>

(<a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *app,

GList *uris,

char **envp);

const char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-application-get-desktop-id" title="gnome_vfs_mime_application_get_desktop_id ()">gnome_vfs_mime_application_get_desktop_id</a>

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

const char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-application-get-desktop-file-path" title="gnome_vfs_mime_application_get_desktop_file_path ()">gnome_vfs_mime_application_get_desktop_file_path</a>

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

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

const char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-application-get-generic-name" title="gnome_vfs_mime_application_get_generic_name ()">gnome_vfs_mime_application_get_generic_name</a>

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

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

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

const char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-application-get-binary-name" title="gnome_vfs_mime_application_get_binary_name ()">gnome_vfs_mime_application_get_binary_name</a>

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

gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-application-requires-terminal" title="gnome_vfs_mime_application_requires_terminal ()">gnome_vfs_mime_application_requires_terminal</a>

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

gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-application-supports-uris" title="gnome_vfs_mime_application_supports_uris ()">gnome_vfs_mime_application_supports_uris</a>

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

gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-application-supports-startup-notification" title="gnome_vfs_mime_application_supports_startup_notification ()">gnome_vfs_mime_application_supports_startup_notification</a>

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

const char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-application-get-startup-wm-class" title="gnome_vfs_mime_application_get_startup_wm_class ()">gnome_vfs_mime_application_get_startup_wm_class</a>

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

gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-application-equal" title="gnome_vfs_mime_application_equal ()">gnome_vfs_mime_application_equal</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *app_a,

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

100

<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-mime-database.html#gnome-vfs-mime-application-copy" title="gnome_vfs_mime_application_copy ()">gnome_vfs_mime_application_copy</a>

101

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

102

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

103

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-application-list-free" title="gnome_vfs_mime_application_list_free ()">gnome_vfs_mime_application_list_free</a>

104

(GList *list);

105

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-component-list-free" title="gnome_vfs_mime_component_list_free ()">gnome_vfs_mime_component_list_free</a> (GList *list);

106

</pre>

107

</div>

108

109

<a name="gnome-vfs-2.0-gnome-vfs-mime-database.description"></a><h2>Description</h2>

110

<p>

111

This API can be used to query the applications and components associated with particular MIME types,

112

and to collect extra information about them, and also provides a convenience function for launching

113

them.

114

Applications can register themselves for particular MIME types by adhering to the

115

116

Freedesktop.Org Desktop Entry Specification</a>.

117

</p>

118

</div>

119

120

<a name="gnome-vfs-2.0-gnome-vfs-mime-database.details"></a><h2>Details</h2>

121

122

<a name="GnomeVFSMimeApplication"></a><h3>GnomeVFSMimeApplication</h3>

123

<pre class="programlisting">typedef struct {

124

char *id;

125

char *name;

126

} GnomeVFSMimeApplication;

127

</pre>

128

<p>

129

A struct encapsulating information about an

130

application known to the MIME database.

131

</p>

132

<p>

133

Only very few fields of this information are actually

134

public, most of them must be queried using the

135

<code class="literal">gnome_vfs_mime_application_*()</code>

136

API.</p>

137

<p>

138

</p>

139

140

141

<tbody>

142

<tr>

143

144

<td> The desktop ID of the application.

145

</td>

146

</tr>

147

<tr>

148

149

<td> The user-visible name of the application.

150

</td>

151

</tr>

152

</tbody>

153

</table></div>

154

</div>

155

<hr>

156

157

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

158

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

159

(const char *mime_type);</pre>

160

<p>

161

Query the MIME database for the application to be executed on files of MIME type

162

<em class="parameter"><code>mime_type</code></em> by default.

163

</p>

164

<p>

165

If you know the actual uri of the file you should use gnome_vfs_mime_get_default_application_for_uri

166

instead, as it will then be able to pick a better app. For instance it won't pick

167

an app that claims to only handle local files for a remote uri.</p>

168

<p>

169

</p>

170

171

172

<tbody>

173

<tr>

174

175

<td> a const char * containing a mime type, e.g. "image/png".

176

</td>

177

</tr>

178

<tr>

179

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

180

<td> a <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication"><span class="type">GnomeVFSMimeApplication</span></a> representing the default handler of <em class="parameter"><code>mime_type</code></em>.

181

</td>

182

</tr>

183

</tbody>

184

</table></div>

185

</div>

186

<hr>

187

188

<a name="gnome-vfs-mime-get-default-application-for-uri"></a><h3>gnome_vfs_mime_get_default_application_for_uri ()</h3>

189

190

(const char *uri,

191

const char *mime_type);</pre>

192

<p>

193

</p>

194

195

196

<tbody>

197

<tr>

198

199

<td>

200

</td>

201

</tr>

202

<tr>

203

204

<td>

205

</td>

206

</tr>

207

<tr>

208

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

209

<td>

210

</td>

211

</tr>

212

</tbody>

213

</table></div>

214

</div>

215

<hr>

216

217

<a name="gnome-vfs-mime-get-all-applications"></a><h3>gnome_vfs_mime_get_all_applications ()</h3>

218

<pre class="programlisting">GList * gnome_vfs_mime_get_all_applications (const char *mime_type);</pre>

219

<p>

220

Return an alphabetically sorted list of <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication"><span class="type">GnomeVFSMimeApplication</span></a>

221

data structures representing all applications in the MIME database registered

222

to handle files of MIME type <em class="parameter"><code>mime_type</code></em> (and supertypes).</p>

223

<p>

224

</p>

225

226

227

<tbody>

228

<tr>

229

230

<td> a const char * containing a mime type, e.g. "image/png".

231

</td>

232

</tr>

233

<tr>

234

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

235

<td> a <span class="type">GList</span> * where the elements are <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication"><span class="type">GnomeVFSMimeApplication</span></a> *

236

representing applications that handle MIME type <em class="parameter"><code>mime_type</code></em>.

237

</td>

238

</tr>

239

</tbody>

240

</table></div>

241

</div>

242

<hr>

243

244

<a name="gnome-vfs-mime-get-all-applications-for-uri"></a><h3>gnome_vfs_mime_get_all_applications_for_uri ()</h3>

245

<pre class="programlisting">GList * gnome_vfs_mime_get_all_applications_for_uri

246

(const char *uri,

247

const char *mime_type);</pre>

248

<p>

249

250

data structures representing all applications in the MIME database able

251

to handle the file identified by <em class="parameter"><code>uri</code></em> of <em class="parameter"><code>mime_type</code></em> (and supertypes).</p>

252

<p>

253

</p>

254

255

256

<tbody>

257

<tr>

258

259

<td> a stringified uri.

260

</td>

261

</tr>

262

<tr>

263

264

<td> a const char * containing a mime type, e.g. "application/x-php".

265

</td>

266

</tr>

267

<tr>

268

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

269

270

representing all possible handlers

271

272

</td>

273

</tr>

274

</tbody>

275

</table></div>

276

<p class="since">Since 2.10</p>

277

</div>

278

<hr>

279

280

<a name="gnome-vfs-mime-get-all-desktop-entries"></a><h3>gnome_vfs_mime_get_all_desktop_entries ()</h3>

281

<pre class="programlisting">GList * gnome_vfs_mime_get_all_desktop_entries

282

(const char *mime_type);</pre>

283

284

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

285

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

286

</div>

287

<p>

288

Returns all the desktop filenames for <em class="parameter"><code>mime_type</code></em>. The desktop files

289

are listed in an order so that default applications are listed before

290

non-default ones, and handlers for inherited mimetypes are listed

291

after the base ones.</p>

292

<p>

293

</p>

294

295

296

<tbody>

297

<tr>

298

299

<td> a mime type.

300

</td>

301

</tr>

302

<tr>

303

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

304

<td> a <span class="type">GList</span> containing the desktop filenames containing the

305

<em class="parameter"><code>mime_type</code></em>.

306

</td>

307

</tr>

308

</tbody>

309

</table></div>

310

</div>

311

<hr>

312

313

<a name="gnome-vfs-mime-get-default-desktop-entry"></a><h3>gnome_vfs_mime_get_default_desktop_entry ()</h3>

314

<pre class="programlisting">gchar * gnome_vfs_mime_get_default_desktop_entry

315

(const char *mime_type);</pre>

316

317

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

318

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

319

</div>

320

<p>

321

Returns the default desktop filename for <em class="parameter"><code>mime_type</code></em>.</p>

322

<p>

323

</p>

324

325

326

<tbody>

327

<tr>

328

329

<td> a mime type.

330

</td>

331

</tr>

332

<tr>

333

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

334

<td> the default desktop filename for <em class="parameter"><code>mime_type</code></em>.

335

</td>

336

</tr>

337

</tbody>

338

</table></div>

339

</div>

340

<hr>

341

342

<a name="gnome-vfs-mime-get-default-component"></a><h3>gnome_vfs_mime_get_default_component ()</h3>

343

<pre class="programlisting">Bonobo_ServerInfo * gnome_vfs_mime_get_default_component

344

(const char *mime_type);</pre>

345

346

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

347

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

348

</div>

349

<p>

350

</p>

351

352

353

<tbody>

354

<tr>

355

356

<td>

357

</td>

358

</tr>

359

<tr>

360

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

361

<td>

362

</td>

363

</tr>

364

</tbody>

365

</table></div>

366

</div>

367

<hr>

368

369

<a name="gnome-vfs-mime-get-all-components"></a><h3>gnome_vfs_mime_get_all_components ()</h3>

370

<pre class="programlisting">GList * gnome_vfs_mime_get_all_components (const char *mime_type);</pre>

371

372

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

373

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

374

</div>

375

<p>

376

</p>

377

378

379

<tbody>

380

<tr>

381

382

<td>

383

</td>

384

</tr>

385

<tr>

386

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

387

<td>

388

</td>

389

</tr>

390

</tbody>

391

</table></div>

392

</div>

393

<hr>

394

395

<a name="gnome-vfs-mime-get-icon"></a><h3>gnome_vfs_mime_get_icon ()</h3>

396

<pre class="programlisting">const char * gnome_vfs_mime_get_icon (const char *mime_type);</pre>

397

398

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

399

<p><code class="literal">gnome_vfs_mime_get_icon</code> is deprecated and should not be used in newly-written code. Use <code class="function">gnome_icon_lookup()</code> function in libgnomeui instead.</p>

400

</div>

401

<p>

402

Query the MIME database for an icon representing the <em class="parameter"><code>mime_type</code></em>.

403

</p>

404

<p>

405

It usually returns a filename without path information, e.g. "i-chardev.png", and sometimes

406

does not have an extension, e.g. "i-regular" if the icon is supposed to be image

407

type agnostic between icon themes. Icons are generic and not theme specific. These

408

will not necessarily match with the icons a user sees in Nautilus, you have been warned.</p>

409

<p>

410

</p>

411

412

413

<tbody>

414

<tr>

415

416

<td> a const char * containing a MIME type.

417

</td>

418

</tr>

419

<tr>

420

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

421

<td> The filename of the icon as listed in the MIME database.

422

423

</td>

424

</tr>

425

</tbody>

426

</table></div>

427

</div>

428

<hr>

429

430

<a name="gnome-vfs-mime-get-description"></a><h3>gnome_vfs_mime_get_description ()</h3>

431

<pre class="programlisting">const char * gnome_vfs_mime_get_description (const char *mime_type);</pre>

432

<p>

433

Query the MIME database for a description of the <em class="parameter"><code>mime_type</code></em>.</p>

434

<p>

435

</p>

436

437

438

<tbody>

439

<tr>

440

441

<td> the mime type.

442

</td>

443

</tr>

444

<tr>

445

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

446

<td> description of MIME type <em class="parameter"><code>mime_type</code></em>.

447

</td>

448

</tr>

449

</tbody>

450

</table></div>

451

</div>

452

<hr>

453

454

<a name="gnome-vfs-mime-can-be-executable"></a><h3>gnome_vfs_mime_can_be_executable ()</h3>

455

<pre class="programlisting">gboolean gnome_vfs_mime_can_be_executable (const char *mime_type);</pre>

456

<p>

457

Check whether files of <em class="parameter"><code>mime_type</code></em> might conceivably be executable.

458

Default for known types if <code class="literal">FALSE</code>. Default for unknown types is <code class="literal">TRUE</code>.</p>

459

<p>

460

</p>

461

462

463

<tbody>

464

<tr>

465

466

<td> a const char * containing a mime type.

467

</td>

468

</tr>

469

<tr>

470

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

471

<td> <code class="literal">TRUE</code> if files of <em class="parameter"><code>mime_type</code></em>

472

can be executable, <code class="literal">FALSE</code> otherwise.

473

</td>

474

</tr>

475

</tbody>

476

</table></div>

477

</div>

478

<hr>

479

480

<a name="gnome-vfs-mime-application-new-from-desktop-id"></a><h3>gnome_vfs_mime_application_new_from_desktop_id ()</h3>

481

482

(const char *id);</pre>

483

<p>

484

Returns a new <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication"><span class="type">GnomeVFSMimeApplication</span></a> for the <em class="parameter"><code>id</code></em>.</p>

485

<p>

486

</p>

487

488

489

<tbody>

490

<tr>

491

492

<td> the identifier of a desktop entry.

493

</td>

494

</tr>

495

<tr>

496

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

497

<td> a <span class="type">GnomeVFSMimeApplication.</span>

498

499

</td>

500

</tr>

501

</tbody>

502

</table></div>

503

<p class="since">Since 2.10</p>

504

</div>

505

<hr>

506

507

<a name="gnome-vfs-mime-application-launch"></a><h3>gnome_vfs_mime_application_launch ()</h3>

508

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-result.html#GnomeVFSResult" title="enum GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_application_launch (<a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *app,

509

GList *uris);</pre>

510

<p>

511

Launches the given mime application with the given parameters.

512

Command line parameters will be expanded as required by the

513

application. The application will also be launched in a terminal

514

if that is required. If the application only supports one argument

515

per instance then multiple instances of the application will be

516

launched.</p>

517

<p>

518

</p>

519

520

521

<tbody>

522

<tr>

523

524

<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication"><span class="type">GnomeVFSMimeApplication</span></a> to launch.

525

</td>

526

</tr>

527

<tr>

528

529

<td> parameters for the <span class="type">GnomeVFSMimeApplication.</span>

530

</td>

531

</tr>

532

<tr>

533

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

534

<td>

535

<a class="link" href="gnome-vfs-2.0-gnome-vfs-result.html#GNOME-VFS-OK:CAPS"><code class="literal">GNOME_VFS_OK</code></a> if the application was launched.

536

<a class="link" href="gnome-vfs-2.0-gnome-vfs-result.html#GNOME-VFS-ERROR-NOT-SUPPORTED:CAPS"><code class="literal">GNOME_VFS_ERROR_NOT_SUPPORTED</code></a> if the uri protocol is not

537

supported by the application.

538

<a class="link" href="gnome-vfs-2.0-gnome-vfs-result.html#GNOME-VFS-ERROR-PARSE:CAPS"><code class="literal">GNOME_VFS_ERROR_PARSE</code></a> if the application command can not

539

be parsed.

540

<a class="link" href="gnome-vfs-2.0-gnome-vfs-result.html#GNOME-VFS-ERROR-LAUNCH:CAPS"><code class="literal">GNOME_VFS_ERROR_LAUNCH</code></a> if the application command can not

541

be launched.

542

<a class="link" href="gnome-vfs-2.0-gnome-vfs-result.html#GNOME-VFS-ERROR-INTERNAL:CAPS"><code class="literal">GNOME_VFS_ERROR_INTERNAL</code></a> for other internal and GConf errors.

543

544

</td>

545

</tr>

546

</tbody>

547

</table></div>

548

<p class="since">Since 2.4</p>

549

</div>

550

<hr>

551

552

<a name="gnome-vfs-mime-application-launch-with-env"></a><h3>gnome_vfs_mime_application_launch_with_env ()</h3>

553

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-result.html#GnomeVFSResult" title="enum GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_application_launch_with_env

554

(<a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *app,

555

GList *uris,

556

char **envp);</pre>

557

<p>

558

Same as <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-application-launch" title="gnome_vfs_mime_application_launch ()"><code class="function">gnome_vfs_mime_application_launch()</code></a> except that

559

the application will be launched with the given environment.</p>

560

<p>

561

</p>

562

563

564

<tbody>

565

<tr>

566

567

<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication"><span class="type">GnomeVFSMimeApplication</span></a> to launch.

568

</td>

569

</tr>

570

<tr>

571

572

<td> parameters for the <span class="type">GnomeVFSMimeApplication.</span>

573

</td>

574

</tr>

575

<tr>

576

577

<td> the environment to use for the application.

578

</td>

579

</tr>

580

<tr>

581

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

582

<td> same as <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-application-launch" title="gnome_vfs_mime_application_launch ()"><code class="function">gnome_vfs_mime_application_launch()</code></a>.

583

584

</td>

585

</tr>

586

</tbody>

587

</table></div>

588

<p class="since">Since 2.4</p>

589

</div>

590

<hr>

591

592

<a name="gnome-vfs-mime-application-get-desktop-id"></a><h3>gnome_vfs_mime_application_get_desktop_id ()</h3>

593

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

594

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

595

<p>

596

Returns the identifier of the desktop entry.</p>

597

<p>

598

</p>

599

600

601

<tbody>

602

<tr>

603

604

<td> a <span class="type">GnomeVFSMimeApplication.</span>

605

</td>

606

</tr>

607

<tr>

608

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

609

<td> the identifier of the desktop entry.

610

611

</td>

612

</tr>

613

</tbody>

614

</table></div>

615

<p class="since">Since 2.10</p>

616

</div>

617

<hr>

618

619

<a name="gnome-vfs-mime-application-get-desktop-file-path"></a><h3>gnome_vfs_mime_application_get_desktop_file_path ()</h3>

620

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

621

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

622

<p>

623

Returns the path of the desktop entry, a configuration

624

file describing the properties of a particular program like

625

it's name, how it is to be launched, how it appears in menus.</p>

626

<p>

627

</p>

628

629

630

<tbody>

631

<tr>

632

633

<td> a <span class="type">GnomeVFSMimeApplication.</span>

634

</td>

635

</tr>

636

<tr>

637

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

638

<td> the path of the .desktop file.

639

640

</td>

641

</tr>

642

</tbody>

643

</table></div>

644

<p class="since">Since 2.10</p>

645

</div>

646

<hr>

647

648

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

649

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

650

<p>

651

Returns the name of the application <em class="parameter"><code>app</code></em></p>

652

<p>

653

</p>

654

655

656

<tbody>

657

<tr>

658

659

<td> a <span class="type">GnomeVFSMimeApplication.</span>

660

</td>

661

</tr>

662

<tr>

663

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

664

<td> the name of the application.

665

666

</td>

667

</tr>

668

</tbody>

669

</table></div>

670

<p class="since">Since 2.10</p>

671

</div>

672

<hr>

673

674

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

675

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

676

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

677

<p>

678

Returns the generic name of the application.</p>

679

<p>

680

</p>

681

682

683

<tbody>

684

<tr>

685

686

<td> a <span class="type">GnomeVFSMimeApplication.</span>

687

</td>

688

</tr>

689

<tr>

690

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

691

<td> the generic name of the application.

692

693

</td>

694

</tr>

695

</tbody>

696

</table></div>

697

<p class="since">Since 2.10</p>

698

</div>

699

<hr>

700

701

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

702

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

703

<p>

704

Returns an icon representing the specified application.</p>

705

<p>

706

</p>

707

708

709

<tbody>

710

<tr>

711

712

<td> a <span class="type">GnomeVFSMimeApplication.</span>

713

</td>

714

</tr>

715

<tr>

716

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

717

<td> the filename of the icon usually without path information,

718

e.g. "gedit-icon.png", and sometimes does not have an extension,

719

e.g. "gnome-pdf" if the icon is supposed to be image type agnostic between

720

icon themes. Icons are generic, and not theme specific.

721

722

</td>

723

</tr>

724

</tbody>

725

</table></div>

726

<p class="since">Since 2.10</p>

727

</div>

728

<hr>

729

730

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

731

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

732

<p>

733

Returns the program to execute, possibly with arguments

734

and parameter variables, as specified by the

735

736

Desktop Entry Specification</a>.</p>

737

<p>

738

</p>

739

740

741

<tbody>

742

<tr>

743

744

<td> a <span class="type">GnomeVFSMimeApplication.</span>

745

</td>

746

</tr>

747

<tr>

748

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

749

<td> the command line to execute.

750

751

</td>

752

</tr>

753

</tbody>

754

</table></div>

755

<p class="since">Since 2.10</p>

756

</div>

757

<hr>

758

759

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

760

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

761

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

762

<p>

763

Returns the binary name of the specified application.

764

Useful to implement startup notification.

765

Note that this only provides partial information about

766

application execution, it misses arguments and macros.

767

DO NOT USE it to launch the application.

768

Use gnome_vfs_mime_application_launch or

769

<a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#gnome-vfs-mime-application-get-exec" title="gnome_vfs_mime_application_get_exec ()"><code class="function">gnome_vfs_mime_application_get_exec()</code></a> if you really

770

need to write a custom launcher.</p>

771

<p>

772

</p>

773

774

775

<tbody>

776

<tr>

777

778

<td> a <span class="type">GnomeVFSMimeApplication.</span>

779

</td>

780

</tr>

781

<tr>

782

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

783

<td> the application's binary name.

784

785

</td>

786

</tr>

787

</tbody>

788

</table></div>

789

<p class="since">Since 2.10</p>

790

</div>

791

<hr>

792

793

<a name="gnome-vfs-mime-application-requires-terminal"></a><h3>gnome_vfs_mime_application_requires_terminal ()</h3>

794

<pre class="programlisting">gboolean gnome_vfs_mime_application_requires_terminal

795

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

796

<p>

797

Returns whether the application runs in a terminal window.</p>

798

<p>

799

</p>

800

801

802

<tbody>

803

<tr>

804

805

<td> a <span class="type">GnomeVFSMimeApplication.</span>

806

</td>

807

</tr>

808

<tr>

809

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

810

<td> <code class="literal">TRUE</code> if the application runs in a terminal.

811

812

</td>

813

</tr>

814

</tbody>

815

</table></div>

816

<p class="since">Since 2.10</p>

817

</div>

818

<hr>

819

820

<a name="gnome-vfs-mime-application-supports-uris"></a><h3>gnome_vfs_mime_application_supports_uris ()</h3>

821

<pre class="programlisting">gboolean gnome_vfs_mime_application_supports_uris

822

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

823

<p>

824

Returns whether the application accept uris as command

825

lines arguments.</p>

826

<p>

827

</p>

828

829

830

<tbody>

831

<tr>

832

833

<td> a <span class="type">GnomeVFSMimeApplication.</span>

834

</td>

835

</tr>

836

<tr>

837

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

838

<td> <code class="literal">TRUE</code> if the application can handle uris.

839

840

</td>

841

</tr>

842

</tbody>

843

</table></div>

844

<p class="since">Since 2.10</p>

845

</div>

846

<hr>

847

848

<a name="gnome-vfs-mime-application-supports-startup-notification"></a><h3>gnome_vfs_mime_application_supports_startup_notification ()</h3>

849

<pre class="programlisting">gboolean gnome_vfs_mime_application_supports_startup_notification

850

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

851

<p>

852

Returns whether the application supports startup notification.

853

If true, it is KNOWN that the application will send a

854

"remove" message when started with the DESKTOP_LAUNCH_ID

855

environment variable set.</p>

856

<p>

857

</p>

858

859

860

<tbody>

861

<tr>

862

863

<td> a <span class="type">GnomeVFSMimeApplication.</span>

864

</td>

865

</tr>

866

<tr>

867

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

868

<td> <code class="literal">TRUE</code> if the application supports startup notification.

869

870

</td>

871

</tr>

872

</tbody>

873

</table></div>

874

<p class="since">Since 2.10</p>

875

</div>

876

<hr>

877

878

<a name="gnome-vfs-mime-application-get-startup-wm-class"></a><h3>gnome_vfs_mime_application_get_startup_wm_class ()</h3>

879

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

880

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

881

<p>

882

Returns the WM class of the main window of the application.</p>

883

<p>

884

</p>

885

886

887

<tbody>

888

<tr>

889

890

<td> a <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication"><span class="type">GnomeVFSMimeApplication</span></a>

891

</td>

892

</tr>

893

<tr>

894

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

895

<td> The WM class of the application's window

896

897

</td>

898

</tr>

899

</tbody>

900

</table></div>

901

<p class="since">Since 2.10</p>

902

</div>

903

<hr>

904

905

<a name="gnome-vfs-mime-application-equal"></a><h3>gnome_vfs_mime_application_equal ()</h3>

906

<pre class="programlisting">gboolean gnome_vfs_mime_application_equal (<a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *app_a,

907

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

908

<p>

909

Compare <em class="parameter"><code>app_a</code></em> and <em class="parameter"><code>app_b</code></em>.</p>

910

<p>

911

</p>

912

913

914

<tbody>

915

<tr>

916

917

<td> a <span class="type">GnomeVFSMimeApplication.</span>

918

</td>

919

</tr>

920

<tr>

921

922

<td> a <span class="type">GnomeVFSMimeApplication.</span>

923

</td>

924

</tr>

925

<tr>

926

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

927

<td> <code class="literal">TRUE</code> if <em class="parameter"><code>app_a</code></em> and <em class="parameter"><code>app_b</code></em> are equal, <code class="literal">FALSE</code> otherwise.

928

929

</td>

930

</tr>

931

</tbody>

932

</table></div>

933

<p class="since">Since 2.10</p>

934

</div>

935

<hr>

936

937

<a name="gnome-vfs-mime-application-copy"></a><h3>gnome_vfs_mime_application_copy ()</h3>

938

939

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

940

<p>

941

Creates a newly referenced copy of a <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication"><span class="type">GnomeVFSMimeApplication</span></a> object.</p>

942

<p>

943

</p>

944

945

946

<tbody>

947

<tr>

948

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

949

950

</td>

951

</tr>

952

<tr>

953

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

954

<td> a copy of <em class="parameter"><code>application</code></em>.

955

</td>

956

</tr>

957

</tbody>

958

</table></div>

959

</div>

960

<hr>

961

962

<a name="gnome-vfs-mime-application-free"></a><h3>gnome_vfs_mime_application_free ()</h3>

963

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

964

<p>

965

Frees a <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication"><span class="type">GnomeVFSMimeApplication</span></a> *.</p>

966

<p>

967

</p>

968

969

970

971

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

972

<td> a <a class="link" href="gnome-vfs-2.0-gnome-vfs-mime-database.html#GnomeVFSMimeApplication" title="GnomeVFSMimeApplication"><span class="type">GnomeVFSMimeApplication</span></a> to be freed.

973

</td>

974

</tr></tbody>

975

</table></div>

976

</div>

977

<hr>

978

979

<a name="gnome-vfs-mime-application-list-free"></a><h3>gnome_vfs_mime_application_list_free ()</h3>

980

<pre class="programlisting">void gnome_vfs_mime_application_list_free

981

(GList *list);</pre>

982

<p>

983

Frees lists of <span class="type">GnomeVFSApplications</span>, as returned from functions such

984

as <code class="function">gnome_vfs_get_all_applications()</code>.</p>

985

<p>

986

</p>

987

988

989

990

991

<td> a <span class="type">GList</span> of <span class="type">GnomeVFSApplication</span> * to be freed.

992

</td>

993

</tr></tbody>

994

</table></div>

995

</div>

996

<hr>

997

998

<a name="gnome-vfs-mime-component-list-free"></a><h3>gnome_vfs_mime_component_list_free ()</h3>

999

<pre class="programlisting">void gnome_vfs_mime_component_list_free (GList *list);</pre>

1000

1001

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

1002

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

1003

</div>

1004

<p>

1005

</p>

1006

1007

1008

1009

1010

<td>

1011

</td>

1012

</tr></tbody>

1013

</table></div>

1014

</div>

1015

</div>

1016

</div>

1017

1018

<hr>

1019

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

1020

</body>

1021

</html>

Older »