GtkLockButton

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

Функции

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

Свойства

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

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

GtkLockButton

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkButton
                ╰── GtkLockButton

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

GtkLockButton реализует GtkAccessible, GtkBuildable, GtkConstraintTarget и GtkActionable.

Включения

#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

a GPermission.

[allow-none]

Возвращает

новый GtkLockButton

gtk_lock_button_get_permission ()

GPermission *
gtk_lock_button_get_permission (GtkLockButton *button);

Получает объект GPermission, который контролирует button.

Параметры

button

a GtkLockButton

Возвращает

GPermission объекта button .

[transfer none]

gtk_lock_button_set-permission ()

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

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

Параметры

button	a GtkLockButton
permission	объект GPermission или `NULL`.	[allow-none]

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

GtkLockButton

typedef struct _GtkLockButton GtkLockButton;

Подробности свойств

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

  “permission”               GPermission *

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

Владелец: GtkLockButton

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