Riferimenti per il file brain_mime.c

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <gtk/gtk.h>
#include <glib.h>
#include <libxfcegui4/libxfcegui4.h>
#include <brain_db.h>
#include "brain_mime.h"
#include <gtk_common/gtk_common.h>

Funzioni
void	brain_mime_set_app_by_mime (gchar *mime, gchar *app)
	Per aggiornare una associazione applicazione/mimetype.
void	brain_mime_get_mime_by_path (gchar *file_path, gchar *ret, int ret_len)
	Per ottenere il mimetype di un file.
void	brain_mime_add_app (gchar *name, gchar *path, gchar *icon)
	Aggiunge una applicazione nella lista di quelle registrate.
void	brain_mime_set_app (gchar *ex_name, gchar *name, gchar *path, gchar *icon)
	Aggiorna i parametri relativi ad una applicazione.
gchar *	brain_mime_app_executable (gchar *app_name)
	Dato il nome simbolico di una applicazione, ritorna il path del relativo eseguibile.
gchar *	brain_mime_app_icon (gchar *app_name)
	Dato il nome simbolico di una applicazione, ritorna la sua icona associata.
gchar *	brain_mime_get_app_by_mime (gchar *mime)
	Per sapere quale applicazione usare per aprire un certo tipo di files.
gchar *	brain_mime_get_app_by_path (gchar *path)
	Per sapere quale applicazione usare per aprire un file.
gchar *	brain_mime_get_all_apps ()
	Preleva la lista completa di applicazioni registrate.
gchar *	brain_mime_get_all_types_for_section (gchar *main)
	Restituisce tutti i sottotipi per un dato tipo primario.
GtkTreeStore *	model_with_all_registered_applications ()
gchar *	brain_mime_choose_association_dialog_by_mime (gchar *mime, gboolean file)
	Pannello per una nuova associazione mimetype / applicazione.
gboolean	brain_mime_choose_association_dialog_by_path (gchar *file_path, gchar *opts)
	Pannello per associare uno specifico file ad una applicazione.
gchar *	brain_mime_choose_application_dialog ()
	Pannello per la selezione di una applicazione nella lista di quelle disponibili.

Documentazione delle funzioni

void brain_mime_set_app_by_mime (  gchar *  mime, gchar *  app )

Per aggiornare una associazione applicazione/mimetype. Usata per manipolare l'applicazione incaricata di default ad aprire un certo tipo di file. Nel caso in cui il mimetype selezionato non esiste, viene aggiunto al DB. Parametri: mime  Il tipo mime contemplato: viene passato nella forma "main/tipo" app  Identificativo dell'applicazione

void brain_mime_get_mime_by_path (  gchar *  file_path, gchar *  ret, int  ret_len )

Per ottenere il mimetype di un file. Con questa funzione posso risalire al mimetype di un file conoscendo il suo path. Avvertimento: Passare sempre il path assoluto dei file che si vogliono esaminare Restituisce: Il formato mime del file, nella forma "main/tipo"

void brain_mime_add_app (  gchar *  name, gchar *  path, gchar *  icon )

Aggiunge una applicazione nella lista di quelle registrate. Aggiunge una nuova applicazione nella lista Parametri: name  Il nome simbolico della nuova applicazione path  Il path ove reperire l'eseguibile dell'applicazione icon  Icona che rappresenta l'applicazione

void brain_mime_set_app (  gchar *  ex_name, gchar *  name, gchar *  path, gchar *  icon )

Aggiorna i parametri relativi ad una applicazione. Aggiorna i dati relativi ad una applicazione nel DB Parametri: ex_name  Vecchio nome dell'applicazione. Da passare anche se il nome non e' stato variato name  Nuovo nome simbolico dell'applicazione path  Nuovo path ove reperire l'eseguibile icon  Nuova icona rappresentativa dell'applicazione

gchar* brain_mime_app_executable (  gchar *  app_name  )

Dato il nome simbolico di una applicazione, ritorna il path del relativo eseguibile. Per aumentare il grado di astrazione, in BrainTop anche le applicazioni sono rappresentate con nomi simbolici e con essi vengono rappresentate in tutto il DB. Questa funzione permette di risalire all'eseguibile vero e proprio del programma partendo dal suo nome simbolico Parametri: app_name  Nome simbolico dell'applicazione di cui si vuole conoscere il path dell'eseguibile Restituisce: Il path dell'eseguibile per l'applicazione, o NULL se non esiste l'applicazione cercata

gchar* brain_mime_app_icon (  gchar *  app_name  )

Dato il nome simbolico di una applicazione, ritorna la sua icona associata. Restituisce l'icona rappresentativa di una data applicazione Parametri: app_name  Nome simbolico dell'applicazione Restituisce: Path dell'icona per l'applicazione, o NULL se non e' stata definita alcuna icona

gchar* brain_mime_get_app_by_mime (  gchar *  mime  )

Per sapere quale applicazione usare per aprire un certo tipo di files. Restituisce il nome simbolico dell'applicazione atta ad aprire un certo tipo di files Parametri: mime  Il tipo mime contemplato: viene passato nella forma "main/tipo" Restituisce: Il nome simbolico del'applicazione dedicata ad aprire i files del dato tipo MIME, o NULL se nessuna ne e' stata associata

gchar* brain_mime_get_app_by_path (  gchar *  path  )

Per sapere quale applicazione usare per aprire un file. Restituisce il nome simbolico dell'applicazione atta ad aprire uno specifico file. Attenzione: questa e' solo una funzione di comodo, identica a brain_mime_get_mime_by_path + brain_mime_get_app_by_mime, e non prende in considerazione eventuali assegnazioni speciali fatte allo specifico file (e contemplate solo ad alto livello, ad esempio nella FileList) Parametri: path  Path assoluto del file da analizzare Restituisce: Nome simbolico dell'applicazione dedicata ad aprire i files con il tipo MIME del file specificato, o NULL in caso di errore

gchar* brain_mime_get_all_apps (   )

Preleva la lista completa di applicazioni registrate. Deprecato: Funzione ad uso interno del modulo Restituisce tutti gli identificativi delle applicazioni registrate per trattare i tipi MIME Restituisce: La lista dei nomi simbolici delle applicazioni registrate, separati da un carattere di newline Avvertimento: Liberare la stringa tornata quando non piu' usata

gchar* brain_mime_get_all_types_for_section (  gchar *  main  )

Restituisce tutti i sottotipi per un dato tipo primario. Deprecato: Funzione ad uso interno del modulo Restituisce tutti i tipi MIME registrati nel DB per un particolare tipo primario Parametri: main  Il tipo primario di cui si desiderano conoscere i sottotipi Restituisce: La lista completa dei sottotipi per il tipo definito, separati da un carattere di newline Avvertimento: Liberare la stringa tornata quando non piu' usata

GtkTreeStore* model_with_all_registered_applications (   )

Da fare: Aggiungere lo spazio per l'icona relativa all'applicazione

gchar* brain_mime_choose_association_dialog_by_mime (  gchar *  mime, gboolean  file )

Pannello per una nuova associazione mimetype / applicazione. Pannello di selezione di una applicazione da associare ad un tipo di file. Preleva la lista delle applicazioni dal DB Parametri: mime  Stringa rappresentativa del mimetype, nella forma "tipo/sottotipo" file  TRUE se si vuole associare l'applicazione selezionata ad uno specifico file, di cui viene passato solo il mimetype Restituisce: Se e solo se "file" == TRUE ed e' stato scelto di associare l'applicazione ad un solo file, la funzione ritorna la stringa rappresentativa dell'applicazione. Altrimenti, torna NULL

gboolean brain_mime_choose_association_dialog_by_path (  gchar *  file_path, gchar *  opts )

Pannello per associare uno specifico file ad una applicazione. Per associare uno specifico file ad una applicazione Parametri: file_path  La path assoluta del file scelto opts  Stringa delle opzioni per il file. Vedi "ActElement" nella documentazione della brainfilelist Restituisce: TRUE se e solo se e' stato scelto di associare l'applicazione selezionata solo al file scelto, FALSE altrimenti. Cio' implica che, se e' stato tornato FALSE, occorre ripetere la ricerca sul database dei mimetypes per accertarsi dell'avvenuta associazione almeno del tipo MIME

gchar* brain_mime_choose_application_dialog (   )

Pannello per la selezione di una applicazione nella lista di quelle disponibili.

Generato il Sun Apr 16 01:36:44 2006 per BrainTop da  1.4.6