Spec-Zone.ru › GTK 4.0

GtkPasswordEntry

GtkPasswordEntry — Поле ввода для секретных данных

Функции

GtkWidget * gtk_password_entry_new ()
void gtk_password_entry_set_show_peek-icon ()
gboolean gtk_password_entry_get_show_peek-icon ()
void gtk_password_entry_set_extra-menu ()
GMenuModel * gtk_password_entry_get_extra-menu ()

Свойства

gboolean activates-default Чтение / Запись
GMenuModel * extra-menu Чтение / Запись
char * placeholder-text Чтение / Запись
gboolean show-peek-icon Чтение / Запись

Сигналы

void activate Действие

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

GtkPasswordEntry

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkPasswordEntry

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

GtkPasswordEntry реализует GtkAccessible, GtkBuildable, GtkConstraintTarget и GtkEditable.

Файлы включения

#include <gtk/gtk.h>

Описание

GtkPasswordEntry — поле ввода, предназначенное для ввода конфиденциальных данных. Оно не отображает содержимое в открытом виде, не позволяет копировать его в буфер обмена и выводит предупреждение при включенном Caps Lock. Если позволяет платформа, GtkPasswordEntry поместит текст в нестраничную область памяти, чтобы избежать записи на диск операционной системой.

По желанию, он может предложить способ отображения содержимого в открытом виде.

GtkPasswordEntry предоставляет только минимальный API и должен использоваться с API GtkEditable.

CSS-узлы

entry.password
╰── text
    ├── image.caps-lock-indicator
    ┊

GtkPasswordEntry содержит один CSS-узел с именем entry, который имеет класс .passwordstyle. Узел текста ниже содержит дочерний элемент с именем image и классом стиля .caps-lock-indicator для значка Caps Lock и, возможно, другие дочерние элементы.

Удобство использования

GtkPasswordEntry использует роль GTK_ACCESSIBLE_ROLE_TEXT_BOX.

Подробное описание функций

gtk_password_entry_new ()

GtkWidget *
gtk_password_entry_new (void);

Создаёт GtkPasswordEntry.

Возвращаемое значение

новый GtkPasswordEntry

gtk_password_entry_set_show_peek-icon ()

void
gtk_password_entry_set_show_peek_icon (GtkPasswordEntry *entry,
                                       gboolean show_peek_icon);

Устанавливает, должен ли элемент управления иметь нажимаемый значок для отображения содержимого поля ввода в открытом виде.

Установив это в FALSE, содержимое также скрывается снова.

Параметры

entry

a GtkPasswordEntry

show_peek_icon

отображать значок peek

gtk_password_entry_get_show_peek-icon ()

gboolean
gtk_password_entry_get_show_peek_icon (GtkPasswordEntry *entry);

Возвращает, отображается ли значок, позволяющий раскрыть содержимое поля ввода в открытом виде.

Параметры

entry

a GtkPasswordEntry

Возвращаемое значение

TRUE если значок отображается

gtk_password_entry_set_extra-menu ()

void
gtk_password_entry_set_extra_menu (GtkPasswordEntry *entry,
                                   GMenuModel *model);

Устанавливает модель меню для добавления при построении контекстного меню для entry .

Параметры

entry

a GtkPasswordEntry

model

a GMenuModel.

[allow-none]

gtk_password_entry_get_extra-menu ()

GMenuModel *
gtk_password_entry_get_extra_menu (GtkPasswordEntry *entry);

Получает модель меню, установленную с помощью gtk_password_entry_set_extra_menu().

Параметры

entry

a GtkText

Возвращаемое значение

(nullable): модель меню.

[transfer none]

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

GtkPasswordEntry

typedef struct _GtkPasswordEntry GtkPasswordEntry;

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

Свойство “activates-default”

  “activates-default”        gboolean

Устанавливает, активировать ли виджет по умолчанию (например, кнопку по умолчанию в диалоговом окне) при нажатии клавиши Enter.

Владелец: GtkPasswordEntry

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

Значение по умолчанию: FALSE

Свойство “extra-menu”

  “extra-menu”               GMenuModel *

Модель меню, содержимое которой будет добавлено в контекстное меню.

Владелец: GtkPasswordEntry

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

Свойство “placeholder-text”

  “placeholder-text”         char *

Показывает текст в поле ввода, когда оно пустое и неактивное.

Владелец: GtkPasswordEntry

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

Значение по умолчанию: NULL

Свойство “show-peek-icon”

  “show-peek-icon”           gboolean

Определяет, отображать ли значок для отображения содержимого.

Владелец: GtkPasswordEntry

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

Значение по умолчанию: FALSE

Подробности о сигналах

Сигнал “activate”

void
user_function (GtkPasswordEntry *passwordentry,
               gpointer          user_data)

Флаги: Действие

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkPasswordEntry.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API