GtkLockButton

GtkLockButton — Виджет для разблокировки или блокировки привилегированных операций

Функции

GtkWidget *	gtk_lock_button_new ()
GPermission *	gtk_lock_button_get_permission ()
void	gtk_lock_button_set_permission ()

Свойства

GPermission *	permission	Чтение / Запись
gchar *	text-lock	Чтение / Запись / Создание
gchar *	text-unlock	Чтение / Запись / Создание
gchar *	tooltip-lock	Чтение / Запись / Создание
gchar *	tooltip-not-authorized	Чтение / Запись / Создание
gchar *	tooltip-unlock	Чтение / Запись / Создание

Типы и значения

struct	GtkLockButton
struct	GtkLockButtonClass

Иерархия объектов

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkButton
                        ╰── GtkLockButton

Реализованные интерфейсы

GtkLockButton реализует AtkImplementorIface, GtkBuildable, GtkActionable и GtkActivatable.

Файлы заголовков

#include <gtk/gtk.h>

Описание

GtkLockButton — это виджет, который можно использовать в панелях управления или диалоговых окнах настроек, чтобы позволить пользователям получать и отзывать разрешения, необходимые для работы с элементами управления. Требуемое разрешение представлено объектом GPermission. Конкретные реализации GPermission могут использовать PolicyKit или другую систему авторизации. Для получения GPermission на основе PolicyKit используйте polkit_permission_new().

Если пользователю в данный момент не разрешено выполнять действие, но он может получить разрешение, виджет выглядит следующим образом:

и пользователь может нажать кнопку, чтобы запросить разрешение. В зависимости от платформы, это может вызвать диалоговое окно аутентификации или попросить пользователя пройти аутентификацию каким-либо другим способом. После того, как пользователь получил разрешение, виджет меняется следующим образом:

и разрешение можно снова снять, нажав на кнопку. Если пользователь вообще не может получить разрешение, виджет выглядит следующим образом:

Если у пользователя есть разрешение и он не может его снять, кнопка скрывается.

Текст (и всплывающие подсказки), отображаемые в разных случаях, можно настроить с помощью свойств “text-lock”, “text-unlock”, “tooltip-lock”, “tooltip-unlock” и “tooltip-not-authorized”.

Функции

gtk_lock_button_new ()

GtkWidget *
gtk_lock_button_new (GPermission *permission);

Создаёт новую кнопку блокировки, которая отражает permission.

Параметры

permission

GPermission.

[allow-none]

Возвращает

новую GtkLockButton.

С: 3.2

gtk_lock_button_get_permission ()

GPermission *
gtk_lock_button_get_permission (GtkLockButton *button);

Получает объект GPermission, который управляет button.

Параметры

button

GtkLockButton.

Возвращает

GPermission объекта button.

[transfer none]

С: 3.2

gtk_lock_button_set-permission ()

void
gtk_lock_button_set_permission (GtkLockButton *button,
                                GPermission *permission);

Устанавливает объект GPermission, который управляет button.

Параметры

button	GtkLockButton.
permission	GPermission или `NULL`.	[allow-none]

С: 3.2

Типы и значения

struct GtkLockButton

struct GtkLockButton;

struct GtkLockButtonClass

struct GtkLockButtonClass {
  GtkButtonClass parent_class;
};

Члены

Подробное описание свойств

Свойство `“permission”`

  “permission”               GPermission *

Объект GPermission, управляющий этой кнопкой.

Флаги: Чтение / Запись