Класс QWebEngineSettings
Класс QWebEngineSettings предоставляет объект для хранения настроек, используемых QWebEnginePage. Подробнее...
| Заголовок: | #include <QWebEngineSettings> |
| qmake: | QT += webenginewidgets |
| С момента: | Qt 5.4 |
Этот класс был представлен в Qt 5.4.
Типы публичного доступа
| перечисление | FontFamily { StandardFont, FixedFont, SerifFont, SansSerifFont, CursiveFont, …, PictographFont } |
| перечисление | FontSize { MinimumFontSize, MinimumLogicalFontSize, DefaultFontSize, DefaultFixedFontSize } |
| перечисление | UnknownUrlSchemePolicy { DisallowUnknownUrlSchemes, AllowUnknownUrlSchemesFromUserInteraction, AllowAllUnknownUrlSchemes } |
| перечисление | WebAttribute { AutoLoadImages, JavascriptEnabled, JavascriptCanOpenWindows, JavascriptCanAccessClipboard, LinksIncludedInFocusChain, …, PdfViewerEnabled } |
Публичные функции
| 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 |
Статические публичные члены
| QWebEngineSettings * | defaultSettings() |
Подробное описание
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 local storage. По умолчанию включено. |
QWebEngineSettings::LocalContentCanAccessRemoteUrls |
6 |
Разрешает локально загруженным документам игнорировать правила междоменной политики, чтобы они могли получить доступ к удалённым ресурсам, которые обычно были бы заблокированы, поскольку все удалённые ресурсы считаются междоменными для локального файла. Удалённый доступ, который не был бы заблокирован правилами междоменной политики, всё ещё возможен, когда это настройка отключена (по умолчанию). Обратите внимание, что отключение этой настройки не останавливает XMLHttpRequests или элементы медиа в локальных файлах от доступа к удалённому содержимому. В основном, это останавливает некоторые подресурсы HTML, такие как скрипты, и поэтому отключение этой настройки не является механизмом безопасности. |
QWebEngineSettings::XSSAuditingEnabled |
7 |
Устарело и не оказывает никакого эффекта. |
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 |
Задерживает воспроизведение медиа-содержимого до тех пор, пока пользователь не взаимодействует со страницей. По умолчанию WebEngine использует настройки Chromium, как описано в Autoplay Policy Changes. Это похоже на то, как работает 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) |
QWebEngineSettings::PdfViewerEnabled |
30 |
Указывает, что документы PDF будут открываться во внутреннем просмотрщике PDF, а не загружаться. Включено по умолчанию. (Добавлено в Qt 5.13) |
Документация по членам-функциям
[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.15/qwebenginesettings.html
