Класс QWebEngineSettings
Класс QWebEngineSettings предоставляет объект для хранения настроек, используемых QWebEnginePage. Подробнее...
| Заголовок: | #include <QWebEngineSettings> |
| CMake: | find_package(Qt6 COMPONENTS WebEngineCore REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| С момента: | 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 | setFontSize(QWebEngineSettings::FontSize type, int size) |
| void | setUnknownUrlSchemePolicy(QWebEngineSettings::UnknownUrlSchemePolicy policy) |
| bool | testAttribute(QWebEngineSettings::WebAttribute attribute) const |
| QWebEngineSettings::UnknownUrlSchemePolicy | unknownUrlSchemePolicy() const |
Подробное описание
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 |
Размер шрифта по умолчанию для текста с фиксированной шириной. |
[since Qt 5.11] Перечисление 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 |
Разрешает локально загруженным документам игнорировать правила межсайтовой защиты, чтобы они могли получать доступ к удалённым ресурсам, которые обычно заблокированы, так как удалённые ресурсы считаются межсайтовыми для локального документа. Удалённый доступ, который не был бы заблокирован правилами межсайтовой защиты, всё ещё возможен, когда этот параметр отключён (по умолчанию). Обратите внимание, что отключение этого параметра не препятствует элементам медиа в локальных файлах от доступа к удалённому контенту. Отключено по умолчанию. |
QWebEngineSettings::XSSAuditingEnabled |
7 |
Устарело и не оказывает никакого эффекта. |
QWebEngineSettings::SpatialNavigationEnabled |
8 |
Включает функцию пространственной навигации, которая означает возможность перемещения между элементами, на которые можно навести фокус, такими как гиперссылки и элементы управления формами на веб-странице, с помощью клавиш со стрелками влево, вправо, вверх и вниз. Например, если пользователь нажмёт клавишу вправо, эвристика определит, есть ли элемент, к которому он, возможно, пытается добраться вправо, и какой элемент он, вероятно, хочет. Отключено по умолчанию. |
QWebEngineSettings::LocalContentCanAccessFileUrls |
9 |
Разрешает локально загруженным документам доступ к другим локальным URL-адресам. Отключение этого параметра заставляет QtWebEngine вести себя более похожим на Chrome и Firefox по умолчанию. Включено по умолчанию. |
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, плагины или веб-сокеты из 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 |
Задерживает воспроизведение медиа-контента до тех пор, пока пользователь не взаимодействует со страницей. По умолчанию, 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) |
Документация по функциям-членам
QString QWebEngineSettings::defaultTextEncoding() const
Возвращает кодировку текста по умолчанию.
См. также setDefaultTextEncoding().
QString QWebEngineSettings::fontFamily(QWebEngineSettings::FontFamily which) const
Возвращает фактическую гарнитуру шрифта для заданной универсальной гарнитуры шрифта, which.
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 до размера, указанного в профиле, к которому принадлежит страница.
[since Qt 5.11] 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::setFontSize(QWebEngineSettings::FontSize type, int size)
Устанавливает размер шрифта для type в size пикселей.
См. также fontSize().
[since Qt 5.11] 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.
[since Qt 5.11] 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-6.2/qwebenginesettings.html
