GnomeMultiScreen

GnomeMultiScreen

Synopsis

#include <libgnomeui/libgnomeui.h>

gboolean            gnome_url_show_on_screen            (const char *url,
                                                         GdkScreen *screen,
                                                         GError **error);
gboolean            gnome_help_display_on_screen        (const char *file_name,
                                                         const char *link_id,
                                                         GdkScreen *screen,
                                                         GError **error);
gboolean            gnome_help_display_with_doc_id_on_screen
                                                        (GnomeProgram *program,
                                                         const char *doc_id,
                                                         const char *file_name,
                                                         const char *link_id,
                                                         GdkScreen *screen,
                                                         GError **error);
gboolean            gnome_help_display_desktop_on_screen
                                                        (GnomeProgram *program,
                                                         const char *doc_id,
                                                         const char *file_name,
                                                         const char *link_id,
                                                         GdkScreen *screen,
                                                         GError **error);
gboolean            gnome_help_display_uri_on_screen    (const char *help_uri,
                                                         GdkScreen *screen,
                                                         GError **error);

Description

Details

gnome_url_show_on_screen ()

gboolean            gnome_url_show_on_screen            (const char *url,
                                                         GdkScreen *screen,
                                                         GError **error);

Like gnome_url_show(), but ensures that the viewer application appears on screen.

url :

The url to display. Should begin with the protocol to use (e.g. "http:", "ghelp:", etc)

screen :

a GdkScreen.

error :

Used to store any errors that result from trying to display the url.

Returns :

TRUE if everything went fine, FALSE otherwise (in which case error will contain the actual error).

Since 2.6


gnome_help_display_on_screen ()

gboolean            gnome_help_display_on_screen        (const char *file_name,
                                                         const char *link_id,
                                                         GdkScreen *screen,
                                                         GError **error);

Like gnome_help_display(), but ensures that the help viewer application appears on screen.

file_name :

The name of the help document to display.

link_id :

Can be NULL. If set, refers to an anchor or section id within the requested document.

screen :

a GdkScreen.

error :

A GError instance that will hold the specifics of any error which occurs during processing, or NULL

Returns :

TRUE on success, FALSE otherwise (in which case error will contain the actual error).

Since 2.6


gnome_help_display_with_doc_id_on_screen ()

gboolean            gnome_help_display_with_doc_id_on_screen
                                                        (GnomeProgram *program,
                                                         const char *doc_id,
                                                         const char *file_name,
                                                         const char *link_id,
                                                         GdkScreen *screen,
                                                         GError **error);

Like gnome_help_display_with_doc_id(), but ensures that the help viewer application appears on screen.

program :

The current application object, or NULL for the default one.

doc_id :

The document identifier, or NULL to default to the application ID (app_id) of the specified program.

file_name :

The name of the help document to display.

link_id :

Can be NULL. If set, refers to an anchor or section id within the requested document.

screen :

a GdkScreen.

error :

A GError instance that will hold the specifics of any error which occurs during processing, or NULL

Returns :

TRUE on success, FALSE otherwise (in which case error will contain the actual error).

Since 2.6


gnome_help_display_desktop_on_screen ()

gboolean            gnome_help_display_desktop_on_screen
                                                        (GnomeProgram *program,
                                                         const char *doc_id,
                                                         const char *file_name,
                                                         const char *link_id,
                                                         GdkScreen *screen,
                                                         GError **error);

Like gnome_help_display_desktop(), but ensures that the help viewer application appears on screen.

program :

The current application object, or NULL for the default one.

doc_id :

The name of the help file relative to the system's help domain (GNOME_FILE_DOMAIN_HELP).

file_name :

The name of the help document to display.

link_id :

Can be NULL. If set, refers to an anchor or section id within the requested document.

screen :

a GdkScreen.

error :

A GError instance that will hold the specifics of any error which occurs during processing, or NULL

Returns :

TRUE on success, FALSE otherwise (in which case error will contain the actual error).

Since 2.6


gnome_help_display_uri_on_screen ()

gboolean            gnome_help_display_uri_on_screen    (const char *help_uri,
                                                         GdkScreen *screen,
                                                         GError **error);

Like gnome_help_display_uri(), but ensures that the help viewer application appears on screen.

help_uri :

The URI to display.

screen :

a GdkScreen.

error :

A GError instance that will hold the specifics of any error which occurs during processing, or NULL

Returns :

TRUE on success, FALSE otherwise (in which case error will contain the actual error).

Since 2.6