Класс QWebEngineUrlScheme

Класс QWebEngineUrlScheme настраивает пользовательскую схему URL. Подробнее...

• Список всех членов, включая унаследованные

Открытые типы

Открытые функции

Статические открытые члены

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

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

Пользовательские схемы URL должны быть настроены на ранней стадии запуска приложения, до создания любых классов Qt WebEngine. Как правило, это означает, что схемы необходимо настроить до создания экземпляра QGuiApplication или QApplication.

Каждая зарегистрированная конфигурация схемы применяется глобально ко всем профилям.

int main(int argc, char **argv)
{
    QWebEngineUrlScheme scheme("myscheme");
    scheme.setSyntax(QWebEngineUrlScheme::Syntax::HostAndPort);
    scheme.setDefaultPort(2345);
    scheme.setFlags(QWebEngineUrlScheme::SecureScheme);
    QWebEngineUrlScheme::registerScheme(scheme);
    ...
}

Чтобы фактически использовать пользовательскую схему URL, необходимо создать QWebEngineUrlSchemeHandler и зарегистрировать его в профиле.

См. также QWebEngineUrlSchemeHandler.

Документация по типам членов

перечисление QWebEngineUrlScheme::Flagфлаги QWebEngineUrlScheme::Flags

Этот тип перечисления определяет параметры безопасности, которые должны применяться к схеме URL.

Тип Flags является псевдонимом для QFlags<Flag>. Он хранит результат побитового ИЛИ флагов типа Flag.

перечисление QWebEngineUrlScheme::SpecialPort

Этот тип перечисления определяет специальные значения для defaultPort.

перечисление QWebEngineUrlScheme::Syntax

Этот тип перечисления перечисляет типы синтаксиса URL.

Чтобы применить политику «одинаковый источник» к пользовательской схеме URL, WebEngine должен уметь вычислять источник (комбинацию хоста и порта) URL. Опции Host... указывают, что схема URL соответствует стандартному синтаксису URL (например, http) и автоматически включают политику «одинаковый источник». Опция Path указывает, что схема URL использует нестандартный синтаксис, и политика «одинаковый источник» не может быть применена.

Документация функций-членов

QWebEngineUrlScheme::QWebEngineUrlScheme(QWebEngineUrlScheme &&that)

Перемещает that.

QWebEngineUrlScheme::QWebEngineUrlScheme(const QWebEngineUrlScheme &that)

Копирует that.

QWebEngineUrlScheme::QWebEngineUrlScheme(const QByteArray &name)

Создаёт схему URL веб-движка с заданным именем name.

QWebEngineUrlScheme::QWebEngineUrlScheme()

Создаёт схему URL веб-движка со значениями по умолчанию.

QWebEngineUrlScheme &QWebEngineUrlScheme::operator=(QWebEngineUrlScheme &&that)

Перемещает that.

QWebEngineUrlScheme &QWebEngineUrlScheme::operator=(const QWebEngineUrlScheme &that)

Копирует that.

QWebEngineUrlScheme::~QWebEngineUrlScheme()

Деструктор этого объекта.

int QWebEngineUrlScheme::defaultPort() const

Возвращает порт по умолчанию для этой схемы URL.

Значение по умолчанию — PortUnspecified.

См. также setDefaultPort().

QWebEngineUrlScheme::Flags QWebEngineUrlScheme::flags() const

Возвращает флаги для этой схемы URL.

Значение по умолчанию — пустой набор флагов.

См. также Флаги и setFlags().

QByteArray QWebEngineUrlScheme::name() const

Возвращает имя этой схемы URL.

Значение по умолчанию — пустая строка.

См. также setName().

[static] void QWebEngineUrlScheme::registerScheme(const QWebEngineUrlScheme &scheme)

Регистрирует scheme в парсере URL и модели безопасности веб-движка.

Рекомендуется регистрировать все пользовательские схемы URL с помощью этой функции при запуске приложения, даже если нужно использовать значения по умолчанию.

См. также schemeByName().

[static] QWebEngineUrlScheme QWebEngineUrlScheme::schemeByName(const QByteArray &name)

Возвращает схему URL веб-движка с заданным именем name или схему по умолчанию.

См. также registerScheme().

void QWebEngineUrlScheme::setDefaultPort(int newValue)

Устанавливает порт по умолчанию для этой схемы URL в newValue.

См. также defaultPort().

void QWebEngineUrlScheme::setFlags(QWebEngineUrlScheme::Flags newValue)

Устанавливает флаги для этой схемы URL в newValue.

См. также Флаги и flags().

void QWebEngineUrlScheme::setName(const QByteArray &newValue)

Устанавливает имя этой схемы URL в newValue.

См. также name().

void QWebEngineUrlScheme::setSyntax(QWebEngineUrlScheme::Syntax newValue)

Устанавливает тип синтаксиса этой схемы URL в newValue.

См. также Синтаксис и syntax().

QWebEngineUrlScheme::Syntax QWebEngineUrlScheme::syntax() const

Возвращает тип синтаксиса этой схемы URL.

Значение по умолчанию — Path.

См. также Синтаксис и setSyntax().

bool QWebEngineUrlScheme::operator!=(const QWebEngineUrlScheme &that) const

Возвращает true, если этот и that объекты не равны.

bool QWebEngineUrlScheme::operator==(const QWebEngineUrlScheme &that) const

Возвращает true, если этот и that объекты равны.