Класс QWebEngineSettings
Класс QWebEngineSettings предоставляет объект для хранения настроек, используемых классом QWebEnginePage. Подробнее...
| Заголовок: | #include <QWebEngineSettings> |
| qmake: | QT += webenginewidgets |
| С момента: | Qt 5.4 |
Типы public
| перечисление | FontFamily { StandardFont, FixedFont, SerifFont, SansSerifFont, ..., PictographFont } |
| перечисление | FontSize { MinimumFontSize, MinimumLogicalFontSize, DefaultFontSize, DefaultFixedFontSize } |
| перечисление | UnknownUrlSchemePolicy { DisallowUnknownUrlSchemes, AllowUnknownUrlSchemesFromUserInteraction, AllowAllUnknownUrlSchemes } |
| перечисление | WebAttribute { AutoLoadImages, JavascriptEnabled, JavascriptCanOpenWindows, JavascriptCanAccessClipboard, ..., DnsPrefetchEnabled } |
Функции 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 в MainWorld. Включено по умолчанию. |
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. Отключено по умолчанию. См. также Pepper Plugin API. (Добавлено в 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, плагины или веб-сокеты из URL-адресов HTTP. Это предоставляет возможность переопределения для получения старого небезопасного поведения. Отключено по умолчанию. (Добавлено в 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) |
QWebEngineSettings::DnsPrefetchEnabled |
29 |
Указывает, будет ли WebEngine пытаться предварительно получить записи DNS для ускорения навигации. Отключено по умолчанию. (Добавлено в Qt 5.12) |
Документация по функциям-членам
[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/qt-5.12/qwebenginesettings.html
