gio.MountOperation — Authentication methods for mountable locations.
class gio.MountOperation(gobject.GObject): |
|
gobject.GObject Signal Prototypes
def callback( | |
def callback( | |
def callback( | |
def callback( |
The gio.MountOperation
provides a mechanism for authenticating mountable operations, such as loop mounting files,
hard drive partitions or server locations.
Mounting operations are handed a
gio.MountOperation
that then can use if they require any privileges or authentication for their volumes to be
mounted (e.g. a hard disk partition or an encrypted filesystem), or if they are implementing
a remote server protocol which requires user credentials such as FTP or WebDAV.
Users should instantiate a subclass of this that implements all the various callbacks
to show the required dialogs, such as
gtk.MountOperation
def get_anonymous()
Returns : | True if mount operation is anonymous.
|
The get_anonymous
() method check to see whether
the mount operation is being used for an anonymous user
def get_choice()
Returns : | an integer containing an index of the user's choice from the choice's list, or 0. |
The get_anonymous
() method gets a choice
from the mount operation.
def get_domain()
Returns : | a string set to the domain. |
The get_domain
() method gets the domain
of the mount operation.
def get_password()
Returns : | a string containing the password within the mountoperation. |
The get_password
() method gets a password
from the mount operation.
def get_password_save()
Returns : | a Gio Password Save Constants flag. |
The get_password_save
() method gets the state
of saving passwords for the mount operation.
def get_username()
Returns : | a string containing the user name. |
The get_username
() method get the user
name from the mount operation.
def reply(result
)
| a Gio Mount Operation Result Constants |
The reply
() method emits the "reply" signal.
def set_anonymous(anonymous
)
| boolean value. |
The set_anonymous
() method sets the mount operation
to use an anonymous user if anonymous is True
.
def set_choice(choice
)
| an integer. |
The set_choice
() method sets a default choice for the mount operation.
def set_domain(domain
)
| the domain to set. |
The set_domain
() method sets the mount operation's domain.
def set_password(password
)
| password to set. |
The set_password
() method sets the mount
operation's password to password.
def set_password_save(save
)
| a set of Gio Password Save Constants |
The set_password_save
() method sets the state
of saving passwords for the mount operation.
def callback(mountoperation
, user_param1
, ...
)
| the mountoperation |
| the first user parameter (if any) specified
with the connect ()
method |
| additional user parameters (if any) |
Emitted by the backend when e.g. a device becomes unavailable while a mount operation is in progress.
Implementations of gio.MountOperation
should handle this signal by dismissing open password dialogs.
def callback(mountoperation
, message
, default_user
, default_domain
, flags
, user_param1
, ...
)
| the mountoperation |
| string containing a message to display to the user. |
| string containing the default user name. |
| string containing the default domain. |
| a set of Gio Ask Password Flags Constants |
| the first user parameter (if any) specified
with the connect ()
method |
| additional user parameters (if any) |
This signal is emitted when a mount operation asks the user for a password.
If the message contains a line break, the first line should be presented as a heading.
For example, it may be used as the primary text in a
gtk.MessageDialog
def callback(mountoperation
, message
, choices
, user_param1
, ...
)
| the mountoperation |
| string containing a message to display to the user. |
| a list of strings for each possible choice. |
| the first user parameter (if any) specified
with the connect ()
method |
| additional user parameters (if any) |
This signal is emitted when asking the user a question and gives a list of choices
for the user to choose from. If the message contains a line break, the first line should be
presented as a heading. For example, it may be used as the primary text in a
gtk.MessageDialog
def callback(mountoperation
, result
, user_param1
, ...
)
| the mountoperation |
| a Gio Mount Operation Result Constants indicating how the request was handled |
| the first user parameter (if any) specified
with the connect ()
method |
| additional user parameters (if any) |
This signal is emitted when the user has replied to the mount operation.