RemoteFileChooserDialog

RemoteFileChooserDialog — A SandboxFileChooserDialog for client applications to access a remote privileged server

Stability Level

Unstable, unless otherwise indicated

Functions

Object Hierarchy

    GObject
    ╰── SandboxFileChooserDialog
        ╰── RemoteFileChooserDialog

Includes

#include <sandboxutils.h>

Description

See also: SandboxFileChooserDialog

RemoteFileChooserDialog is a private class, that implements the SandboxFileChooserDialog API. This class redirects all of its methods over GDBus to a remote server that spawns and processes actual GTK+ dialogs. RemoteFileChooserDialog can only be used if such a server is present, which is normally the case only for sandboxed applications.

RemoteFileChooserDialog exposes fewer constructors than LocalFileChooserDialog because it is only meant to be called by SandboxFileChooserDialog's sfcd_new() in cases where remote dialogs should be used (such as being jailed in a sandbox with a server).

Functions

rfcd_get_type ()

GType
rfcd_get_type (void);

rfcd_new_valist ()

SandboxFileChooserDialog *
rfcd_new_valist (const gchar *title,
                 GtkWindow *parent,
                 GtkFileChooserAction action,
                 const gchar *first_button_text,
                 va_list varargs);

Creates a new RemoteFileChooserDialog. You usually should not use this function. In a normal application, you almost always want to use sfcd_new().

The parent parameter will not be made transient out of the box in a RemoteFileChooserDialog, because the actual GTK+ dialog is controlled by a remote process. As of 0.5.0, there is no convention or standard on what this parameter should represent, and no servers or compositors implementing it. It will be used in future releases.

This is equivalent to gtk_file_chooser_dialog_new() in the GTK+ API.

Parameters

title

Title of the dialog, or NULL.

[allow-none]

parent

Transient parent of the dialog, or NULL.

[allow-none]

action

Open or save mode for the dialog (see GtkFileChooserAction)

 

first_button_text

stock ID or text to go in the first button, or NULL.

[allow-none]

varargs

response ID for the first button, then additional (button, id) pairs, ending with NULL

 

Returns

a new SandboxFileChooserDialog

See also: rfcd_new() to create a RemoteFileChooserDialog, and sfcd_new() to create a SandboxFileChooserDialog regardless of whether local or remote.

Since 0.5


rfcd_new ()

SandboxFileChooserDialog *
rfcd_new (const gchar *title,
          GtkWindow *parent,
          GtkFileChooserAction action,
          const gchar *first_button_text,
          ...);

Creates a new RemoteFileChooserDialog. You usually should not use this function. In a normal application, you almost always want to use sfcd_new().

The parent parameter will not be made transient out of the box in a RemoteFileChooserDialog, because the actual GTK+ dialog is controlled by a remote process. As of 0.5.0, there is no convention or standard on what this parameter should represent, and no servers or compositors implementing it. It will be used in future releases.

This is equivalent to gtk_file_chooser_dialog_new() in the GTK+ API.

Parameters

title

Title of the dialog, or NULL.

[allow-none]

parent

Transient parent of the dialog, or NULL.

[allow-none]

action

Open or save mode for the dialog (see GtkFileChooserAction)

 

first_button_text

stock ID or text to go in the first button, or NULL.

[allow-none]

...

response ID for the first button, then additional (button, id) pairs, ending with NULL

 

Returns

a new SandboxFileChooserDialog

See also: rfcd_new() to create a RemoteFileChooserDialog, and sfcd_new() to create a SandboxFileChooserDialog regardless of whether local or remote.

Since 0.5

Types and Values