Класс QWebEngineSettings
Класс QWebEngineSettings предоставляет объект для хранения настроек, используемых классом QWebEnginePage. Подробнее...
| Заголовок: | #include <QWebEngineSettings> |
| qmake: | QT += webenginewidgets |
| С тех пор: | Qt 5.4 |
Типы
| Перечисление | FontFamily { StandardFont, FixedFont, SerifFont, SansSerifFont, ..., PictographFont } |
| Перечисление | FontSize { MinimumFontSize, MinimumLogicalFontSize, DefaultFontSize, DefaultFixedFontSize } |
| Перечисление | WebAttribute { AutoLoadImages, JavascriptEnabled, JavascriptCanOpenWindows, JavascriptCanAccessClipboard, ..., AllowGeolocationOnInsecureOrigins } |
Открытые функции
| QString | defaultTextEncoding() const |
| QString | fontFamily(FontFamily which) const |
| int | fontSize(FontSize type) const |
| void | resetAttribute(WebAttribute attribute) |
| void | resetFontFamily(FontFamily which) |
| void | resetFontSize(FontSize type) |
| void | setAttribute(WebAttribute attribute, bool on) |
| void | setDefaultTextEncoding(const QString &encoding) |
| void | setFontFamily(FontFamily which, const QString &family) |
| void | setFontSize(FontSize type, int size) |
| bool | testAttribute(WebAttribute attribute) const |
Статические открытые члены
| 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::WebAttribute
Это перечисление определяет настройки для веб-страниц:
| Константа | Значение | Описание |
|---|---|---|
QWebEngineSettings::AutoLoadImages |
0 |
Автоматически загружает изображения для веб-страниц. При отключении этого параметра изображения загружаются из кэша. Включено по умолчанию. |
QWebEngineSettings::JavascriptEnabled |
1 |
Включает выполнение программ JavaScript. Включено по умолчанию. |
QWebEngineSettings::JavascriptCanOpenWindows |
2 |
Разрешает программам JavaScript открывать всплывающие окна без взаимодействия пользователя. Включено по умолчанию. |
QWebEngineSettings::JavascriptCanAccessClipboard |
3 |
Разрешает программам JavaScript читать и записывать в буфер обмена. Запись в буфер обмена всегда разрешена, если она запрошена пользователем. Отключено по умолчанию. |
QWebEngineSettings::LinksIncludedInFocusChain |
4 |
Включает гиперссылки в цепочку фокуса клавиатуры. Включено по умолчанию. |
QWebEngineSettings::LocalStorageEnabled |
5 |
Включает поддержку функции локального хранилища HTML 5. Включено по умолчанию. |
QWebEngineSettings::LocalContentCanAccessRemoteUrls |
6 |
Разрешает локально загруженным документам игнорировать правила кросс-происхождения, чтобы они могли получить доступ к удалённым ресурсам, которые обычно заблокированы, поскольку все удалённые ресурсы считаются из другого происхождения для локального файла. Удалённый доступ, который не был бы заблокирован правилами кросс-происхождения, всё ещё возможен, когда этот параметр отключён (по умолчанию). Обратите внимание, что отключение этого параметра не останавливает XMLHttpRequests или элементы мультимедиа в локальных файлах от доступа к удалённому контенту. В основном, это останавливает только некоторые подресурсы HTML, такие как скрипты, и поэтому отключение этого параметра не является механизмом безопасности. |
QWebEngineSettings::XSSAuditingEnabled |
7 |
Отслеживает запросы загрузки на предмет попыток межсайтовой подмены кода (XSS). Подозрительные скрипты блокируются и сообщаются в консоли 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) |
Документация по функциям-членам
[static] QWebEngineSettings *QWebEngineSettings::defaultSettings()
Возвращает параметры для страницы веб-движка, принадлежащей профилю по умолчанию. Все веб-страницы, не созданные явно с другим профилем, принадлежат профилю по умолчанию.
QString QWebEngineSettings::defaultTextEncoding() const
Возвращает кодировку текста по умолчанию.
См. также setDefaultTextEncoding().
QString QWebEngineSettings::fontFamily(FontFamily which) const
Возвращает фактический шрифт для указанного универсального шрифта which.
См. также setFontFamily().
int QWebEngineSettings::fontSize(FontSize type) const
Возвращает размер шрифта по умолчанию для type в пикселях.
См. также setFontSize().
void QWebEngineSettings::resetAttribute(WebAttribute attribute)
Сбрасывает параметр attribute до значения, указанного в профиле, к которому принадлежит страница.
void QWebEngineSettings::resetFontFamily(FontFamily which)
Сбрасывает фактический шрифт, заданный which, до указанного в профиле, к которому принадлежит страница.
void QWebEngineSettings::resetFontSize(FontSize type)
Сбрасывает размер шрифта для type до размера, указанного в профиле, к которому принадлежит страница.
void QWebEngineSettings::setAttribute(WebAttribute attribute, bool on)
Включает или отключает указанную функцию attribute в зависимости от значения on.
void QWebEngineSettings::setDefaultTextEncoding(const QString &encoding)
Устанавливает систему кодировки текста по умолчанию.
Значение encoding должно быть строкой, описывающей кодировку, например, "utf-8" или "iso-8859-1". Если оставить пустым, будет использоваться значение по умолчанию. Более подробный список имён кодировок см. в QTextCodec.
См. также defaultTextEncoding().
void QWebEngineSettings::setFontFamily(FontFamily which, const QString &family)
Устанавливает фактический шрифт в family для указанной универсальной семьи which.
См. также fontFamily().
void QWebEngineSettings::setFontSize(FontSize type, int size)
Устанавливает размер шрифта для type в size пикселей.
См. также fontSize().
bool QWebEngineSettings::testAttribute(WebAttribute attribute) const
Возвращает true если attribute включен; в противном случае возвращает false.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qwebenginesettings.html
