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, управляющий этой кнопкой.

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