Класс QWebEngineSettings
Класс QWebEngineSettings предоставляет объект для хранения настроек, используемых классом QWebEnginePage. Подробнее...
| Заголовок: | #include <QWebEngineSettings> |
| qmake: | QT += webenginewidgets |
| С момента: | Qt 5.4 |
Типы публичного доступа
| перечисление | FontFamily { StandardFont, FixedFont, SerifFont, SansSerifFont, CursiveFont, FantasyFont } |
| перечисление | FontSize { MinimumFontSize, MinimumLogicalFontSize, DefaultFontSize, DefaultFixedFontSize } |
| перечисление | WebAttribute { AutoLoadImages, JavascriptEnabled, JavascriptCanOpenWindows, JavascriptCanAccessClipboard, ..., FullScreenSupportEnabled } |
Функции публичного доступа
| 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 * | globalSettings() |
Подробное описание
Класс QWebEngineSettings предоставляет объект для хранения настроек, используемых классом QWebEnginePage.
Каждый объект QWebEnginePage имеет собственный объект QWebEngineSettings, который настраивает параметры для этой страницы. Если параметр не настроен, он ищется в глобальном объекте настроек, к которому можно получить доступ с помощью globalSettings().
QWebEngineSettings позволяет настроить свойства браузера, такие как размеры и семейства шрифтов, расположение пользовательской таблицы стилей и общие атрибуты, такие как поддержка JavaScript. Отдельные атрибуты устанавливаются с помощью функции setAttribute(). Перечисление WebAttribute далее описывает каждый атрибут.
См. также 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::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 |
Отслеживает запросы загрузки на предмет попыток межсайтового скриптинга. Подозрительные скрипты блокируются и сообщаются в консоли 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. Отключено по умолчанию. См. также API плагинов Pepper. (Добавлена в Qt 5.6) |
QWebEngineSettings::FullScreenSupportEnabled |
14 |
Включает поддержку полноэкранного режима в приложении. Отключено по умолчанию. (Добавлена в Qt 5.6) |
Документация по членам-функциям
[static] QWebEngineSettings *QWebEngineSettings::defaultSettings()
Возвращает настройки по умолчанию для страницы веб-движка.
См. также globalSettings().
QString QWebEngineSettings::defaultTextEncoding() const
Возвращает кодировку текста по умолчанию.
См. также setDefaultTextEncoding().
QString QWebEngineSettings::fontFamily(FontFamily which) const
Возвращает фактический шрифт для указанного универсального шрифта, which.
См. также setFontFamily().
int QWebEngineSettings::fontSize(FontSize type) const
Возвращает размер шрифта по умолчанию для type в пикселях.
См. также setFontSize().
[static] QWebEngineSettings *QWebEngineSettings::globalSettings()
Возвращает глобальный объект настроек.
Любое изменение настройки в объекте по умолчанию автоматически применяется ко всем экземплярам QWebEnginePage, где конкретная настройка ещё не переопределена.
См. также defaultSettings().
void QWebEngineSettings::resetAttribute(WebAttribute attribute)
Сбрасывает настройку attribute до значения, указанного в глобальном экземпляре QWebEngineSettings.
Эта функция не влияет на глобальный экземпляр QWebEngineSettings.
См. также globalSettings().
void QWebEngineSettings::resetFontFamily(FontFamily which)
Сбрасывает фактический шрифт, заданный which, до шрифта, заданного в глобальном экземпляре QWebEngineSettings.
Эта функция не влияет на глобальный экземпляр QWebEngineSettings.
void QWebEngineSettings::resetFontSize(FontSize type)
Сбрасывает размер шрифта для type до размера, указанного в глобальном объекте настроек.
Эта функция не влияет на глобальный экземпляр QWebEngineSettings.
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/archives/qt-5.6/qwebenginesettings.html
