GtkLockButton

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

Функции

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

Свойства

GPermission *	разрешение	Чтение / Запись
char *	текст-блокировка	Чтение / Запись / Создание
char *	текст-разблокировка	Чтение / Запись / Создание
char *	подсказка-блокировка	Чтение / Запись / Создание
char *	подсказка-нет-разрешения	Чтение / Запись / Создание
char *	подсказка-разблокировка	Чтение / Запись / Создание

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

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().

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

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

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

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

Текст (и всплывающие подсказки), отображаемые в различных случаях, можно настроить с помощью свойств «текст-блокировка», «текст-разблокировка», «подсказка-блокировка», «подсказка-разблокировка» и «подсказка-нет-разрешения».

Функции

gtk_lock_button_new ()

GtkWidget *
gtk_lock_button_new (GPermission *permission);

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

Параметры

разрешение

a GPermission.

[allow-none]

Возвращает

новый GtkLockButton

Since: 3.2

gtk_lock_button_get_permission ()

GPermission *
gtk_lock_button_get_permission (GtkLockButton *button);

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

Параметры

кнопка

a GtkLockButton

Возвращает

объект GPermission для button .

[transfer none]

Since: 3.2

gtk_lock_button_set_permission ()

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

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

Параметры

кнопка	a GtkLockButton
разрешение	объект GPermission или `NULL`.	[allow-none]

Since: 3.2

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

struct GtkLockButton

struct GtkLockButton;

struct GtkLockButtonClass

struct GtkLockButtonClass {
  GtkButtonClass parent_class;
};

Члены

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

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

  “permission”               GPermission *

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

Владелец: GtkLockButton

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