Класс QWebEngineSettings
Класс QWebEngineSettings предоставляет объект для хранения настроек, используемых классом QWebEnginePage. Подробнее...
| Заголовок: | #include <QWebEngineSettings> |
| qmake: | QT += webenginewidgets |
| С тех пор: | Qt 5.4 |
Типы public
| перечисление | FontFamily { СтандартныйШрифт, ШрифтСФиксированнымКеглем, ШрифтССерлифами, ШрифтБезСерлифов, ..., ШрифтПиктограмм } |
| перечисление | FontSize { МинимальныйРазмерШрифта, МинимальныйЛогическийРазмерШрифта, РазмерШрифтаПоУмолчанию, РазмерШрифтаПоУмолчаниюСФиксированнымКеглем } |
| перечисление | UnknownUrlSchemePolicy { ЗапретитьНеизвестныеСхемыUrl, РазрешитьНеизвестныеСхемыUrlИзВзаимодействияСПользователем, РазрешитьВсеНеизвестныеСхемыUrl } |
| перечисление | WebAttribute { АвтоматическаяЗагрузкаИзображений, ВключитьJavascript, JavascriptМожетОткрыватьОкна, JavascriptМожетДоступатьКБуферуОбмена, ..., WebRTCPublicInterfacesOnly } |
Функции public
| QString | defaultTextEncoding() const |
| QString | fontFamily(QWebEngineSettings::FontFamily which) const |
| int | fontSize(QWebEngineSettings::FontSize type) const |
| void | resetAttribute(QWebEngineSettings::WebAttribute attribute) |
| void | resetFontFamily(QWebEngineSettings::FontFamily which) |
| void | resetFontSize(QWebEngineSettings::FontSize type) |
| void | resetUnknownUrlSchemePolicy() |
| void | setAttribute(QWebEngineSettings::WebAttribute attribute, bool on) |
| void | setDefaultTextEncoding(const QString &encoding) |
| void | setFontFamily(QWebEngineSettings::FontFamily which, const QString &family) |
| void | setFontSize(QWebEngineSettings::FontSize type, int size) |
| void | setUnknownUrlSchemePolicy(QWebEngineSettings::UnknownUrlSchemePolicy policy) |
| bool | testAttribute(QWebEngineSettings::WebAttribute attribute) const |
| QWebEngineSettings::UnknownUrlSchemePolicy | unknownUrlSchemePolicy() const |
Статические public члены
| QWebEngineSettings * | defaultSettings() |
Подробное описание
Класс QWebEngineSettings предоставляет объект для хранения настроек, используемых классом QWebEnginePage.
QWebEngineSettings позволяет настроить свойства браузера, такие как размеры и начертания шрифтов, расположение пользовательского стилевого файла и общие атрибуты, такие как поддержка JavaScript. Отдельные атрибуты устанавливаются с помощью функции setAttribute(). Перечисление WebAttribute дополнительно описывает каждый атрибут.
Каждый объект QWebEnginePage имеет собственный объект QWebEngineSettings, который настраивает настройки для этой страницы. Если настройка не настроена для страницы веб-движка, она ищется в настройках профиля, к которому принадлежит страница.
См. также QWebEnginePage::settings() и QWebEngineView::settings().
Документация по типам членов
перечисление QWebEngineSettings::FontFamily
Это перечисление описывает общие начертания шрифтов, определённые в CSS 2. Для получения дополнительной информации см. стандарт CSS.
| Константа | Значение | Описание |
|---|---|---|
QWebEngineSettings::StandardFont |
0 |
|
QWebEngineSettings::FixedFont |
1 |
|
QWebEngineSettings::SerifFont |
2 |
|
QWebEngineSettings::SansSerifFont |
3 |
|
QWebEngineSettings::CursiveFont |
4 |
|
QWebEngineSettings::FantasyFont |
5 |
|
QWebEngineSettings::PictographFont |
6 |
(добавлено в Qt 5.7) |
перечисление QWebEngineSettings::FontSize
Это перечисление описывает размеры шрифтов, настраиваемые через QWebEngineSettings:
| Константа | Значение | Описание |
|---|---|---|
QWebEngineSettings::MinimumFontSize |
0 |
Минимальный размер шрифта. |
QWebEngineSettings::MinimumLogicalFontSize |
1 |
Минимальный логический размер шрифта, применяемый при масштабировании уменьшения. |
QWebEngineSettings::DefaultFontSize |
2 |
Размер шрифта по умолчанию для обычного текста. |
QWebEngineSettings::DefaultFixedFontSize |
3 |
Размер шрифта по умолчанию для текста с фиксированным кеглем. |
перечисление QWebEngineSettings::UnknownUrlSchemePolicy
Это перечисление описывает, как обрабатываются запросы навигации по URL-адресам с неизвестными схемами.
| Константа | Значение | Описание |
|---|---|---|
QWebEngineSettings::DisallowUnknownUrlSchemes |
1 |
Запрещает все запросы навигации по URL-адресам с неизвестными схемами. |
QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction |
2 |
Разрешает запросы навигации по URL-адресам с неизвестными схемами, которые выполняются при взаимодействии пользователя (например, щелчок мышью), в то время как другие запросы навигации (например, из JavaScript) подавляются. |
QWebEngineSettings::AllowAllUnknownUrlSchemes |
3 |
Разрешает все запросы навигации по URL-адресам с неизвестными схемами. |
Это перечисление было введено или изменено в Qt 5.11.
См. также unknownUrlSchemePolicy, setUnknownUrlSchemePolicy и resetUnknownUrlSchemePolicy.
перечисление QWebEngineSettings::WebAttribute
Этот тип перечисления задает параметры для веб-страниц:
| Константа | Значение | Описание |
|---|---|---|
QWebEngineSettings::AutoLoadImages |
0 |
Автоматически загружает изображения для веб-страниц. При отключении этого параметра изображения загружаются из кэша. Включено по умолчанию. |
QWebEngineSettings::JavascriptEnabled |
1 |
Включает выполнение программ на языке JavaScript. Включено по умолчанию. |
QWebEngineSettings::JavascriptCanOpenWindows |
2 |
Разрешает программам на JavaScript открывать всплывающие окна без взаимодействия с пользователем. Включено по умолчанию. |
QWebEngineSettings::JavascriptCanAccessClipboard |
3 |
Разрешает программам на JavaScript читать и записывать в буфер обмена. Запись в буфер обмена всегда разрешена, если она явно запрошена пользователем. См. JavascriptCanPaste, чтобы также разрешить вставку содержимого буфера обмена из JavaScript. Отключено по умолчанию. |
QWebEngineSettings::LinksIncludedInFocusChain |
4 |
Включает гиперссылки в цепочке фокуса клавиатуры. Включено по умолчанию. |
QWebEngineSettings::LocalStorageEnabled |
5 |
Включает поддержку функции локального хранилища HTML 5. Включено по умолчанию. |
QWebEngineSettings::LocalContentCanAccessRemoteUrls |
6 |
Разрешает локально загруженным документам игнорировать правила разных источников, чтобы они могли получать доступ к удаленным ресурсам, которые обычно заблокированы, потому что все удалённые ресурсы считаются разных источников для локального файла. Удаленный доступ, который не был бы заблокирован правилами разных источников, всё ещё возможен, когда этот параметр отключён (по умолчанию). Обратите внимание, что отключение этого параметра не останавливает XMLHttpRequests или элементы медиа в локальных файлах от доступа к удалённому контенту. По сути, он останавливает только некоторые подресурсы HTML, такие как скрипты, и поэтому отключение этого параметра не является механизмом безопасности. |
QWebEngineSettings::XSSAuditingEnabled |
7 |
Отслеживает запросы загрузки на предмет попыток межсайтовой подмены кода. Подозрительные скрипты блокируются и сообщаются в консоли JavaScript инспектора. Отключено по умолчанию, так как это может негативно повлиять на производительность. |
QWebEngineSettings::SpatialNavigationEnabled |
8 |
Включает функцию пространственной навигации, что означает возможность перемещаться между элементами, которые можно сделать фокусированными, например, гиперссылками и элементами управления формами на веб-странице, используя клавиши со стрелками влево, вправо, вверх и вниз. Например, если пользователь нажмёт клавишу вправо, эвристика определит, есть ли элемент, к которому он, возможно, пытается перейти вправо, и какой элемент, вероятно, нужен. Отключено по умолчанию. |
QWebEngineSettings::LocalContentCanAccessFileUrls |
9 |
Разрешает локально загруженным документам получать доступ к другим локальным URL-адресам. Включено по умолчанию. |
QWebEngineSettings::HyperlinkAuditingEnabled |
10 |
Включает поддержку атрибута ping для гиперссылок. Отключено по умолчанию. |
QWebEngineSettings::ScrollAnimatorEnabled |
11 |
Включает анимированную прокрутку. Отключено по умолчанию. |
QWebEngineSettings::ErrorPageEnabled |
12 |
Включает отображение встроенных страниц ошибок Chromium. Включено по умолчанию. |
QWebEngineSettings::PluginsEnabled |
13 |
Включает поддержку плагинов Pepper, таких как Flash Player. Отключено по умолчанию. См. также API плагинов Pepper. (Добавлен в Qt 5.6) |
QWebEngineSettings::FullScreenSupportEnabled |
14 |
Включает поддержку полноэкранного режима в приложении. Отключено по умолчанию. (Добавлен в Qt 5.6) |
QWebEngineSettings::ScreenCaptureEnabled |
15 |
Включает захват экрана в приложении. Отключено по умолчанию. (Добавлен в Qt 5.7) |
QWebEngineSettings::WebGLEnabled |
16 |
Включает поддержку HTML 5 WebGL. Включено по умолчанию, если доступно. (Добавлен в Qt 5.7) |
QWebEngineSettings::Accelerated2dCanvasEnabled |
17 |
Указывает, должен ли HTML5 2D-холст быть буфером OpenGL. Это ускоряет многие операции рисования, но замедляет доступ к пикселям. Включено по умолчанию, если доступно. (Добавлен в Qt 5.7) |
QWebEngineSettings::AutoLoadIconsForPage |
18 |
Автоматически загружает значки для веб-страниц. Включено по умолчанию. (Добавлен в Qt 5.7) |
QWebEngineSettings::TouchIconsEnabled |
19 |
Включает поддержку значков для сенсорных устройств и предварительно составленных значков для сенсорных устройств. Отключено по умолчанию. (Добавлен в Qt 5.7) |
QWebEngineSettings::FocusOnNavigationEnabled |
20 |
Устанавливает фокус на представление, связанное со страницей, всякий раз, когда происходит операция навигации (загрузка, остановка, перезагрузка, перезагрузка и обход кэша, вперёд, назад, установка содержимого и т. д.). Отключено по умолчанию. (Добавлен в Qt 5.8) |
QWebEngineSettings::PrintElementBackgrounds |
21 |
Включает печать фонов CSS при печати веб-страницы. Включено по умолчанию. (Добавлен в Qt 5.8) |
QWebEngineSettings::AllowRunningInsecureContent |
22 |
По умолчанию, HTTPS-страницы не могут запускать JavaScript, CSS, плагины или веб-сокеты из HTTP-URL-адресов. Это переопределение, чтобы получить старое небезопасное поведение. Отключено по умолчанию. (Добавлен в Qt 5.8) |
QWebEngineSettings::AllowGeolocationOnInsecureOrigins |
23 |
Начиная с Qt 5.7, только безопасные источники, такие как HTTPS, могли запрашивать функции геолокации. Это переопределение, чтобы снова разрешить небезопасным источникам доступ к геолокации. Отключено по умолчанию. (Добавлен в Qt 5.9) |
QWebEngineSettings::AllowWindowActivationFromJavaScript |
24 |
Разрешает активировать окна с помощью метода JavaScript window.focus(). Отключено по умолчанию. (Добавлен в Qt 5.10) |
QWebEngineSettings::ShowScrollBars |
25 |
Отображает полосы прокрутки. Включено по умолчанию. (Добавлен в Qt 5.10) |
QWebEngineSettings::PlaybackRequiresUserGesture |
26 |
Запрещает воспроизведение медиа-контента до тех пор, пока пользователь не взаимодействует со страницей. Это аналогично поведению Chrome на Android, тогда как поведение по умолчанию при отключении аналогично поведению Chrome на настольных компьютерах. (Добавлен в Qt 5.11) |
QWebEngineSettings::JavascriptCanPaste |
28 |
Включает JavaScript execCommand("paste"). Для этого также необходимо включить JavascriptCanAccessClipboard. Отключено по умолчанию. (Добавлен в Qt 5.11) |
QWebEngineSettings::WebRTCPublicInterfacesOnly |
27 |
Ограничивает WebRTC только публичными IP-адресами. При отключении WebRTC может использовать также IP-адреса локальной сети, но удалённые хосты также могут видеть ваш локальный IP-адрес локальной сети. Отключено по умолчанию. (Добавлен в Qt 5.11) |
Документация по функциям-членам
[static] QWebEngineSettings *QWebEngineSettings::defaultSettings()
Возвращает настройки страницы веб-движка, принадлежащей профилю по умолчанию. Все веб-страницы, не созданные специально с другим профилем, принадлежат профилю по умолчанию.
QString QWebEngineSettings::defaultTextEncoding() const
Возвращает кодировку текста по умолчанию.
См. также setDefaultTextEncoding().
QString QWebEngineSettings::fontFamily(QWebEngineSettings::FontFamily which) const
Возвращает фактический шрифт для указанного набора шрифтов по умолчанию, which.
См. также setFontFamily().
int QWebEngineSettings::fontSize(QWebEngineSettings::FontSize type) const
Возвращает размер шрифта по умолчанию для type в пикселях.
См. такжеsetFontSize().
void QWebEngineSettings::resetAttribute(QWebEngineSettings::WebAttribute attribute)
Сбрасывает значение параметра attribute до значения, указанного в профиле, к которому принадлежит страница.
void QWebEngineSettings::resetFontFamily(QWebEngineSettings::FontFamily which)
Сбрасывает фактический шрифт, указанный параметром which, до значения, указанного в профиле, к которому принадлежит страница.
void QWebEngineSettings::resetFontSize(QWebEngineSettings::FontSize type)
Сбрасывает размер шрифта для type до размера, указанного в профиле, к которому принадлежит страница.
void QWebEngineSettings::resetUnknownUrlSchemePolicy()
Удаляет политику обработки запросов навигации к URL-адресам с неизвестными схемами.
Эта функция была добавлена в Qt 5.11.
См. также unknownUrlSchemePolicy и setUnknownUrlSchemePolicy.
void QWebEngineSettings::setAttribute(QWebEngineSettings::WebAttribute attribute, bool on)
Включает или отключает указанное свойство attribute в зависимости от значения on.
void QWebEngineSettings::setDefaultTextEncoding(const QString &encoding)
Устанавливает кодировку по умолчанию для текста.
Значение encoding должно быть строкой, описывающей кодировку, например, "utf-8" или "iso-8859-1". Если строка пуста, будет использовано значение по умолчанию. Более подробный список кодировок см. в QTextCodec.
См. также defaultTextEncoding().
void QWebEngineSettings::setFontFamily(QWebEngineSettings::FontFamily which, const QString &family)
Устанавливает фактический шрифт family для указанного набора шрифтов which.
См. также fontFamily().
void QWebEngineSettings::setFontSize(QWebEngineSettings::FontSize type, int size)
Устанавливает размер шрифта type в size пикселей.
См. также fontSize().
void QWebEngineSettings::setUnknownUrlSchemePolicy(QWebEngineSettings::UnknownUrlSchemePolicy policy)
Устанавливает политику обработки запросов навигации к URL-адресам с неизвестными схемами в policy. По умолчанию используется QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction.
Эта функция была добавлена в Qt 5.11.
См. также unknownUrlSchemePolicy и resetUnknownUrlSchemePolicy.
bool QWebEngineSettings::testAttribute(QWebEngineSettings::WebAttribute attribute) const
Возвращает true если attribute включено; в противном случае возвращает false.
QWebEngineSettings::UnknownUrlSchemePolicy QWebEngineSettings::unknownUrlSchemePolicy() const
Возвращает текущую политику обработки запросов навигации к URL-адресам с неизвестными схемами. По умолчанию используется QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction.
Эта функция была добавлена в Qt 5.11.
См. также setUnknownUrlSchemePolicy и resetUnknownUrlSchemePolicy.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.11/qwebenginesettings.html
