Класс QWebEngineSettings
Класс QWebEngineSettings предоставляет объект для хранения настроек, используемых классом QWebEnginePage. Подробнее...
| Заголовок: | #include <QWebEngineSettings> |
| qmake: | QT += webenginewidgets |
| С момента: | Qt 5.4 |
Этот класс был представлен в Qt 5.4.
Типы публичного интерфейса
| перечисление | FontFamily { StandardFont, FixedFont, SerifFont, SansSerifFont, ..., PictographFont } |
| перечисление | FontSize { MinimumFontSize, MinimumLogicalFontSize, DefaultFontSize, DefaultFixedFontSize } |
| перечисление | UnknownUrlSchemePolicy { DisallowUnknownUrlSchemes, AllowUnknownUrlSchemesFromUserInteraction, AllowAllUnknownUrlSchemes } |
| перечисление | WebAttribute { AutoLoadImages, JavascriptEnabled, JavascriptCanOpenWindows, JavascriptCanAccessClipboard, ..., 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 в основном мире. Включено по умолчанию. |
QWebEngineSettings::JavascriptCanOpenWindows |
2 |
Разрешает программам JavaScript открывать всплывающие окна без взаимодействия с пользователем. Включено по умолчанию. |
QWebEngineSettings::JavascriptCanAccessClipboard |
3 |
Разрешает программам JavaScript читать и записывать в буфер обмена. Запись в буфер обмена всегда разрешена, если она специально запрошена пользователем. См. JavascriptCanPaste, чтобы также разрешить вставку содержимого буфера обмена из 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. Отключено по умолчанию. См. также API плагинов Pepper. (Добавлена в 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 |
Запрещает воспроизведение медиа-содержимого до тех пор, пока пользователь не взаимодействует со страницей. Это похоже на то, как работает 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.13/qwebenginesettings.html
