manpagez: man pages & more
html files: goffice-0.10
Home | html | info | man

GOFileOpeners

GOFileOpeners

Properties

gchar * description Read / Write
gchar * id Read
gboolean interactive-only Read / Write

Types and Values

Object Hierarchy

    GObject
    ╰── GOFileOpener

Description

Functions

GOFileOpenerOpenFunc ()

void
(*GOFileOpenerOpenFunc) (GOFileOpener const *fo,
                         GOIOContext *io_context,
                         GoView *view,
                         GsfInput *input);


GOFileOpenerOpenFuncWithEnc ()

void
(*GOFileOpenerOpenFuncWithEnc) (GOFileOpener const *fo,
                                gchar const *enc,
                                GOIOContext *io_context,
                                GoView *view,
                                GsfInput *input);


GOFileOpenerProbeFunc ()

gboolean
(*GOFileOpenerProbeFunc) (GOFileOpener const *fo,
                          GsfInput *input,
                          GOFileProbeLevel pl);

Returns


go_file_opener_can_probe ()

gboolean
go_file_opener_can_probe (GOFileOpener const *fo,
                          GOFileProbeLevel pl);

Returns


go_file_opener_for_id ()

GOFileOpener *
go_file_opener_for_id (char const *id);

Searches for file opener with given id , registered using go_file_opener_register

Parameters

id

File opener's ID

 

Returns

GOFileOpener object or NULL if opener cannot be found.

[transfer none]


go_file_opener_get_description ()

char const *
go_file_opener_get_description (GOFileOpener const *fo);

Returns


go_file_opener_get_id ()

char const *
go_file_opener_get_id (GOFileOpener const *fo);

Returns


go_file_opener_get_mimes ()

GSList const *
go_file_opener_get_mimes (GOFileOpener const *fo);

Parameters

fo

GOFileOpener

 

Returns

the supported mime types.

[element-type char][transfer none]


go_file_opener_get_suffixes ()

GSList const *
go_file_opener_get_suffixes (GOFileOpener const *fo);

Parameters

fo

GOFileOpener

 

Returns

the suffixes for the supporte file types.

[element-type char][transfer none]


go_file_opener_is_encoding_dependent ()

gboolean
go_file_opener_is_encoding_dependent (GOFileOpener const *fo);

Returns


go_file_opener_new ()

GOFileOpener *
go_file_opener_new (char const *id,
                    char const *description,
                    GSList *suffixes,
                    GSList *mimes,
                    GOFileOpenerProbeFunc probe_func,
                    GOFileOpenerOpenFunc open_func);

Creates new GOFileOpener object. Optional id will be used after registering it with go_file_opener_register function.

Parameters

id

Optional ID of the opener (or NULL)

 

description

Description of supported file format

 

suffixes

List of suffixes to associate with the opener.

[element-type char]

mimes

List of mime types to associate with the opener.

[element-type char]

probe_func

Optional pointer to "probe" function (or NULL).

[scope async]

open_func

Pointer to "open" function.

[scope async]

Returns

newly created GOFileOpener object.

[transfer full]


go_file_opener_new_with_enc ()

GOFileOpener *
go_file_opener_new_with_enc (char const *id,
                             char const *description,
                             GSList *suffixes,
                             GSList *mimes,
                             GOFileOpenerProbeFunc probe_func,
                             GOFileOpenerOpenFuncWithEnc open_func);

Creates new GOFileOpener object. Optional id will be used after registering it with go_file_opener_register function.

Parameters

id

Optional ID of the opener (or NULL)

 

description

Description of supported file format

 

suffixes

List of suffixes to associate with the opener.

[element-type char]

mimes

List of mime types to associate with the opener.

[element-type char]

probe_func

Optional pointer to "probe" function (or NULL).

[scope async]

open_func

Pointer to "open" function.

[scope async]

Returns

newly created GOFileOpener object.

[transfer full]


go_file_opener_open ()

void
go_file_opener_open (GOFileOpener const *fo,
                     gchar const *opt_enc,
                     GOIOContext *io_context,
                     GoView *view,
                     GsfInput *input);

Reads content of file_name file into workbook wbv is attached to. Results are reported using io_context object, use go_io_error_occurred to find out if operation was successful. The state of wbv and its workbook is undefined if operation fails, you should destroy them in that case.

Parameters

fo

GOFileOpener object

 

opt_enc

Optional encoding

 

io_context

Context for i/o operation

 

view

GoView

 

input

Gsf input stream

 

go_file_opener_probe ()

gboolean
go_file_opener_probe (GOFileOpener const *fo,
                      GsfInput *input,
                      GOFileProbeLevel pl);

Checks if a given file is supported by the opener.

Parameters

fo

GOFileOpener

 

input

GsfInput

 

pl

GOFileProbeLevel

 

Returns

TRUE, if the opener can read given file and FALSE otherwise.


go_file_opener_register ()

void
go_file_opener_register (GOFileOpener *fo,
                         gint priority);

Adds fo opener to the list of available file openers, making it available for Gnumeric i/o routines. The opener is registered with given priority . The priority is used to determine the order in which openers will be tried when reading a file. The higher the priority, the sooner it will be tried. Default XML-based Gnumeric file opener is registered at priority 50. Recommended range for priority is [0, 100]. Reference count for the opener is incremented inside the function, but you don't have to (and shouldn't) call g_object_unref on it if it's floating object (for example, when you pass object newly created with go_file_opener_new and not referenced anywhere).

Parameters

fo

GOFileOpener object

 

priority

Opener's priority

 

go_file_opener_unregister ()

void
go_file_opener_unregister (GOFileOpener *fo);

Removes fo opener from list of available file openers. Reference count for the opener is decremented inside the function.

Parameters

fo

GOFileOpener object previously registered using go_file_opener_register

 

Types and Values

GOFileOpener

typedef struct _GOFileOpener GOFileOpener;


GOFileOpenerClass

typedef struct {
	GObjectClass parent_class;

	/* private */
	gboolean  (*can_probe) (GOFileOpener const *fo,
				GOFileProbeLevel pl);
	gboolean  (*probe) (GOFileOpener const *fo,
	                    GsfInput *input,
	                    GOFileProbeLevel pl);
	void      (*open)  (GOFileOpener const *fo,
			    gchar const *opt_enc,
	                    GOIOContext *io_context,
	                    GoView *view,
	                    GsfInput *input);
} GOFileOpenerClass;

File opener base class.

Members

GObjectClass parent_class;

parent class.

 

can_probe ()

returns TRUE if the files can be probed.

 

probe ()

probes the file.

 

open ()

opens and reads the file.

 

Property Details

The “description” property

  “description”              gchar *

The description of the opener.

Flags: Read / Write

Default value: NULL


The “id” property

  “id”                       gchar *

The identifier of the opener.

Flags: Read

Default value: NULL


The “interactive-only” property

  “interactive-only”         gboolean

TRUE if this opener requires interaction.

Flags: Read / Write

Default value: FALSE

© manpagez.com 2000-2025
Individual documents may contain additional copyright information.