Класс 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 |
Отслеживает запросы загрузки на предмет попыток межсайтовой подмены кода. Подозрительные скрипты блокируются и сообщаются в консоли 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, плагины или web-сокеты из 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) |
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)
Устанавливает фактическое семейство шрифтов для указанного семейства шрифтов which на family.
См. также 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.14/qwebenginesettings.html
