Package: gtk

Class gtk:lock-button

Superclasses

Documented Subclasses

None

Direct Slots

permission
The permission property of type g:permission (Read / Write)
The permission controlling this button.
text-lock
The text-lock property of type :string (Read / Write / Construct)
The text to display when prompting the user to lock.
Default value: "Lock"
text-unlock
The text-unlock property of type :string (Read / Write / Construct)
The text to display when prompting the user to unlock.
Default value: "Unlock"
tooltip-lock
The tooltip-lock property of type :string (Read / Write / Construct)
The tooltip to display when prompting the user to lock.
Default value: "Dialog is unlocked.\n Click to prevent further changes"
tooltip-not-authorized
The tooltip-not-authorized property of type :string (Read / Write / Construct)
The tooltip to display when prompting the user cannot obtain authorization.
Default value: "System policy prevents changes. \nContact your system administrator"
tooltip-unlock
The tooltip-unlock property of type :string (Read / Write / Construct)
The tooltip to display when prompting the user to unlock.
Default value: "Dialog is locked.\nClick to make changes"

Details

The gtk:lock-button widget is a widget that can be used in control panels or preference dialogs to allow users to obtain and revoke authorizations needed to operate the controls.

Figure: GtkLockButton

The required authorization is represented by a g:permission object. Concrete implementations of the g:permission class may use the PolicyKit library or some other authorization framework. To obtain a PolicyKit-based g:permission object, use the polkit_permission_new() function.

Warning

The gtk:lock-button implementation has been deprecated since version 4.10 and should not be used in newly written code. This widget will be removed in GTK 5.
 

Returned by

Slot Access Functions

Inherited Slot Access Functions

See also

2024-5-2