Класс ConsolePrompt

Сигналы

void	finished ()

Публичные функции

	ConsolePrompt (QObject *parent=nullptr)
void	getChar ()
void	getHidden (const QString &promptStr)
void	getLine (const QString &promptStr)
SecureArray	result () const
QChar	resultChar () const
QString	resultLine () const
void	waitForFinished ()

Дружественные функции и классы

class

Private

Подробное описание

Обработчик подсказок Console.

Этот класс обеспечивает удобный способ безопасного получения пользовательского ввода, как показано ниже:

QCA::ConsolePrompt prompt;
prompt.getHidden("Passphrase");
prompt.waitForFinished();
QCA:SecureArray pass = prompt.result();

Примечание.

Нет необходимости использовать waitForFinished(), так как достаточно подключить сигнал finished() к нужному методу, однако приложения командной строки (консольные) часто требуют использования waitForFinished().

Примеры

keyloader.cpp и saslclient.cpp.

Описание конструкторов и деструктора

ConsolePrompt()

QCA::ConsolePrompt::ConsolePrompt (QObject * parent = nullptr)

Стандартный конструктор.

Параметры

parent

Родительский объект для этого экземпляра

Описание методов

getHidden()

void QCA::ConsolePrompt::getHidden (const QString & promptStr)

Разрешает пользователю вводить данные без вывода их в терминал.

Эта функциональность особенно полезна для ввода паролей, кодовых фраз и ПИН-кодов.

Параметры

promptStr

Подсказка для отображения пользователю

См. также result() о том, как возвращать ввод.

Примеры

keyloader.cpp и saslclient.cpp.

getLine()

void QCA::ConsolePrompt::getLine (const QString & promptStr)

Разрешает пользователю вводить строковые данные.

Эта функциональность особенно полезна для ввода идентификаторов хранилища ключей и названий записей.

Параметры

promptStr

Подсказка для отображения пользователю

См. также resultLine() о том, как возвращать ввод.

getChar()

void QCA::ConsolePrompt::getChar ()

Принимает один символ от пользователя.

См. также resultChar() о том, как возвращать ввод.

waitForFinished()

void QCA::ConsolePrompt::waitForFinished ()

Блокируется, ожидая ввода пользователя.

Следует использовать сигнал finished(), чтобы избежать блокировки.

Примеры

keyloader.cpp и saslclient.cpp.

result()

SecureArray QCA::ConsolePrompt::result () const

Получает результат пользовательского ввода.

Этот метод обычно вызывается для получения данных от пользователя, запрошенных вызовом getHidden().

Примеры

keyloader.cpp и saslclient.cpp.

resultLine()

QString QCA::ConsolePrompt::resultLine () const

Получает результат пользовательского ввода.

Этот метод обычно вызывается для получения данных от пользователя, запрошенных вызовом getLine().

resultChar()

QChar QCA::ConsolePrompt::resultChar () const

Получает результат пользовательского ввода.

Этот метод обычно вызывается для получения данных от пользователя, запрошенных вызовом getChar().

finished

void QCA::ConsolePrompt::finished ()

signal

Вызывается, когда действие ввода пользователя было завершено.

Эта функциональность соответствует предоставлению строки для getHidden() или одного символа для getChar().

См. также waitForFinished