Пространство имен QtWin
Пространство имен QtWin содержит различные функции, специфичные для Windows. Подробнее...
| Заголовок: | #include <QtWin> |
| qmake: | QT += winextras |
Типы
| перечисление | HBitmapFormat { HBitmapNoAlpha, HBitmapPremultipliedAlpha, HBitmapAlpha } |
| перечисление | WindowFlip3DPolicy { FlipDefault, FlipExcludeAbove, FlipExcludeBelow } |
Функции
| QColor | colorizationColor(bool *opaqueBlend = Q_NULLPTR) |
| HBITMAP | createMask(const QBitmap &bitmap) |
| void | disableBlurBehindWindow(QWindow *window) |
| void | disableBlurBehindWindow(QWidget *window) |
| void | enableBlurBehindWindow(QWindow *window, const QRegion ®ion) |
| void | enableBlurBehindWindow(QWindow *window) |
| void | enableBlurBehindWindow(QWidget *window, const QRegion ®ion) |
| void | enableBlurBehindWindow(QWidget *window) |
| QString | errorStringFromHresult(HRESULT hresult) |
| void | extendFrameIntoClientArea(QWindow *window, int left, int top, int right, int bottom) |
| void | extendFrameIntoClientArea(QWindow *window, const QMargins &margins) |
| void | extendFrameIntoClientArea(QWidget *window, const QMargins &margins) |
| void | extendFrameIntoClientArea(QWidget *window, int left, int top, int right, int bottom) |
| QPixmap | fromHBITMAP(HBITMAP bitmap, HBitmapFormat format = HBitmapNoAlpha) |
| QPixmap | fromHICON(HICON icon) |
| QRegion | fromHRGN(HRGN hrgn) |
| QImage | imageFromHBITMAP(HDC hdc, HBITMAP bitmap, int width, int height) |
| bool | isCompositionEnabled() |
| bool | isCompositionOpaque() |
| bool | isWindowExcludedFromPeek(QWindow *window) |
| bool | isWindowExcludedFromPeek(QWidget *window) |
| bool | isWindowPeekDisallowed(QWindow *window) |
| bool | isWindowPeekDisallowed(QWidget *window) |
| void | markFullscreenWindow(QWindow *window, bool fullscreen = true) |
| void | markFullscreenWindow(QWidget *window, bool fullscreen = true) |
| QColor | realColorizationColor() |
| void | resetExtendedFrame(QWindow *window) |
| void | resetExtendedFrame(QWidget *window) |
| void | setCompositionEnabled(bool enabled) |
| void | setCurrentProcessExplicitAppUserModelID(const QString &id) |
| void | setWindowDisallowPeek(QWindow *window, bool disallow) |
| void | setWindowDisallowPeek(QWidget *window, bool disallow) |
| void | setWindowExcludedFromPeek(QWindow *window, bool exclude) |
| void | setWindowExcludedFromPeek(QWidget *window, bool exclude) |
| void | setWindowFlip3DPolicy(QWindow *window, WindowFlip3DPolicy policy) |
| void | setWindowFlip3DPolicy(QWidget *window, WindowFlip3DPolicy policy) |
| QString | stringFromHresult(HRESULT hresult) |
| void | taskbarActivateTab(QWindow *window) |
| void | taskbarActivateTab(QWidget *window) |
| void | taskbarActivateTabAlt(QWindow *window) |
| void | taskbarActivateTabAlt(QWidget *window) |
| void | taskbarAddTab(QWindow *window) |
| void | taskbarAddTab(QWidget *window) |
| void | taskbarDeleteTab(QWindow *window) |
| void | taskbarDeleteTab(QWidget *window) |
| HBITMAP | toHBITMAP(const QPixmap &p, HBitmapFormat format = HBitmapNoAlpha) |
| HICON | toHICON(const QPixmap &p) |
| HRGN | toHRGN(const QRegion ®ion) |
| WindowFlip3DPolicy | windowFlip3DPolicy(QWindow *window) |
| WindowFlip3DPolicy | windowFlip3DPolicy(QWidget *window) |
Подробное описание
Пространство имен QtWin содержит различные функции, специфичные для Windows.
Документация типов
enum QtWin::HBitmapFormat
Этот перечисление определяет, как выполняется преобразование между HBITMAP и QPixmap.
| Постоянная | Значение | Описание |
|---|---|---|
QtWin::HBitmapNoAlpha |
0 |
Альфа-канал игнорируется и всегда рассматривается как полностью непрозрачный. Это предпочтительно, если HBITMAP используется со стандартными вызовами GDI, такими как BitBlt(). |
QtWin::HBitmapPremultipliedAlpha |
1 |
HBITMAP рассматривается как имеющий альфа-канал и предварительно умноженные цвета. Это предпочтительно, если к HBITMAP обращаются через функцию GDI AlphaBlend(). |
QtWin::HBitmapAlpha |
2 |
HBITMAP рассматривается как имеющий обычный альфа-канал. Этот формат предпочтительнее, если HBITMAP будет использоваться как значок приложения или значок системного трея. |
Это перечисление было введено или изменено в Qt 5.2.
См. также fromHBITMAP() и toHBITMAP().
enum QtWin::WindowFlip3DPolicy
Этот тип перечисления задает политику окна Flip3D.
| Постоянная | Значение | Описание |
|---|---|---|
QtWin::FlipDefault |
0 |
Пусть ОС решит, следует ли включать окно в отображение Flip3D. |
QtWin::FlipExcludeAbove |
2 |
Исключить окно из Flip3D и отобразить его поверх отображения Flip3D. |
QtWin::FlipExcludeBelow |
1 |
Исключить окно из Flip3D и отобразить его под отображением Flip3D. |
Это перечисление было введено или изменено в Qt 5.2.
См. также setWindowFlip3DPolicy().
Документация функций
QColor QtWin::colorizationColor(bool *opaqueBlend = Q_NULLPTR)
Возвращает цвет заливки DWM. После возвращения функции, необязательный параметр opaqueBlend будет содержать true, если цвет является непрозрачной смесью, и false в противном случае.
Эта функция была введена в Qt 5.2.
HBITMAP QtWin::createMask(const QBitmap &bitmap)
Создает эквивалент HBITMAP QBitmap bitmap.
Ответственность за освобождение данных HBITMAP после использования лежит на вызывающей стороне.
Эта функция была введена в Qt 5.2.
См. также toHBITMAP().
void QtWin::disableBlurBehindWindow(QWindow *window)
Отключает ранее включенный эффект размытия для указанного окна window.
Эта функция была введена в Qt 5.2.
См. также enableBlurBehindWindow().
void QtWin::disableBlurBehindWindow(QWidget *window)
Эта функция перегружает QtWin::disableBlurBehindWindow().
Эта функция была введена в Qt 5.2.
void QtWin::enableBlurBehindWindow(QWindow *window, const QRegion ®ion)
Включает эффект размытия для указанной области region указанного окна window.
Эта функция была введена в Qt 5.2.
См. также disableBlurBehindWindow().
void QtWin::enableBlurBehindWindow(QWindow *window)
Включает эффект размытия для указанного окна window.
Эта функция была введена в Qt 5.2.
См. также disableBlurBehindWindow().
void QtWin::enableBlurBehindWindow(QWidget *window, const QRegion ®ion)
Эта функция перегружает QtWin::enableBlurBehindWindow().
Эта функция была введена в Qt 5.2.
void QtWin::enableBlurBehindWindow(QWidget *window)
Эта функция перегружает QtWin::enableBlurBehindWindow().
Эта функция была введена в Qt 5.2.
QString QtWin::errorStringFromHresult(HRESULT hresult)
Возвращает имя кода hresult указанного идентификатора ошибки (обычно имя макроса WinAPI) или пустую строку, если сообщение неизвестно.
Эта функция была введена в Qt 5.2.
void QtWin::extendFrameIntoClientArea(QWindow *window, int left, int top, int right, int bottom)
Расширяет рамку стекла в клиентскую область указанного окна window с использованием значений отступов left, top, right и bottom.
Передайте -1 в качестве значений для любого из четырех отступов, чтобы полностью расширить рамку, создавая эффект «стеклянного листа».
Если вы хотите, чтобы расширенная рамка действовала как стандартная граница окна, вы должны обработать это самостоятельно.
Примечание: Если window — это дескриптор QWidget, установите атрибут Qt::WA_NoSystemBackground для вашего виджета.
Эта функция была введена в Qt 5.2.
См. также resetExtendedFrame().
void QtWin::extendFrameIntoClientArea(QWindow *window, const QMargins &margins)
Эта функция перегружает QtWin::extendFrameIntoClientArea().
Расширяет рамку стекла в клиентскую область указанного окна window с использованием указанных отступов margins.
Эта функция была введена в Qt 5.2.
void QtWin::extendFrameIntoClientArea(QWidget *window, const QMargins &margins)
Эта функция перегружает QtWin::extendFrameIntoClientArea().
Удобная перегрузка, позволяющая передавать размеры рамки в структуре margins.
Эта функция была введена в Qt 5.2.
void QtWin::extendFrameIntoClientArea(QWidget *window, int left, int top, int right, int bottom)
Эта функция перегружает QtWin::extendFrameIntoClientArea().
Эта функция была введена в Qt 5.2.
QPixmap QtWin::fromHBITMAP(HBITMAP bitmap, HBitmapFormat format = HBitmapNoAlpha)
Возвращает QPixmap, эквивалентную данному bitmap. Преобразование основано на указанном формате format.
Эта функция была введена в Qt 5.2.
См. также toHBITMAP().
QPixmap QtWin::fromHICON(HICON icon)
Возвращает QPixmap, эквивалентную данному icon.
Эта функция была введена в Qt 5.2.
См. также toHICON().
QRegion QtWin::fromHRGN(HRGN hrgn)
Возвращает QRegion, эквивалентную данному hrgn.
Эта функция была введена в Qt 5.2.
QImage QtWin::imageFromHBITMAP(HDC hdc, HBITMAP bitmap, int width, int height)
Возвращает QImage, эквивалентную данному bitmap. Преобразование основано на указанном контексте устройства hdc с использованием указанных width и height.
Эта функция была введена в Qt 5.2.
См. также toHBITMAP().
bool QtWin::isCompositionEnabled()
Возвращает состояние композиции DWM.
Эта функция была введена в Qt 5.2.
bool QtWin::isCompositionOpaque()
Возвращает, является ли цвет заливки непрозрачной смесью.
Эта функция была введена в Qt 5.2.
END_OF_DOCUMENT_MARKERbool QtWin::isWindowExcludedFromPeek(QWindow *window)
Возвращает true, если указанное окно window исключено из Aero Peek.
Эта функция была добавлена в Qt 5.2.
bool QtWin::isWindowExcludedFromPeek(QWidget *window)
Эта функция перегружает QtWin::isWindowExcludedFromPeek().
Эта функция была добавлена в Qt 5.2.
bool QtWin::isWindowPeekDisallowed(QWindow *window)
Возвращает true, если Aero Peek запрещён для миниатюры указанного окна window.
Эта функция была добавлена в Qt 5.2.
bool QtWin::isWindowPeekDisallowed(QWidget *window)
Эта функция перегружает QtWin::isWindowPeekDisallowed().
Эта функция была добавлена в Qt 5.2.
void QtWin::markFullscreenWindow(QWindow *window, bool fullscreen = true)
Помечает указанное окно window как работающее в полноэкранном режиме, если fullscreen равно true, для корректной обработки оболочкой. В противном случае, снимает пометку.
Примечание: Обычно вызывать эту функцию не нужно, так как системный трей Windows всегда пытается определить, работает ли окно в полноэкранном режиме.
Эта функция была добавлена в Qt 5.2.
void QtWin::markFullscreenWindow(QWidget *window, bool fullscreen = true)
Эта функция перегружает QtWin::markFullscreenWindow().
Эта функция была добавлена в Qt 5.2.
QColor QtWin::realColorizationColor()
Возвращает фактический цвет цветового оформления, установленный пользователем, используя недокументированный ключ реестра. Функция getColorizationColor() на основе API возвращает цвет с альфа-смешиванием, который часто оказывается полупрозравым серым, а не чем-то похожим на выбранное пользователем значение.
Эта функция была добавлена в Qt 5.2.
См. также colorizationColor().
void QtWin::resetExtendedFrame(QWindow *window)
Сбрасывает рамку и восстанавливает атрибуты окна window.
Эта вспомогательная функция вызывает extendFrameIntoClientArea() с отступами, установленными в 0.
Примечание: Необходимо сбросить атрибут Qt::WA_NoSystemBackground для extendFrameIntoClientArea().
Эта функция была добавлена в Qt 5.2.
См. также extendFrameIntoClientArea().
void QtWin::resetExtendedFrame(QWidget *window)
Эта функция перегружает QtWin::resetExtendedFrame().
Эта функция была добавлена в Qt 5.2.
void QtWin::setCompositionEnabled(bool enabled)
Устанавливает, включена ли композиция рабочего стола Windows.
Примечание: Подлежащая функция устарела с Windows 8 и не оказывает никакого влияния.
Эта функция была добавлена в Qt 5.2.
См. также isCompositionEnabled().
void QtWin::setCurrentProcessExplicitAppUserModelID(const QString &id)
Устанавливает идентификатор модели пользователя приложения id.
Для получения дополнительной информации см. Идентификаторы моделей пользователей приложений.
Эта функция была добавлена в Qt 5.2.
void QtWin::setWindowDisallowPeek(QWindow *window, bool disallow)
Отключает Aero Peek для указанного окна window при наведении курсора мыши на миниатюру окна в системном трее, если disallow равно true; в противном случае, разрешает его.
По умолчанию значение равно false.
Эта функция была добавлена в Qt 5.2.
void QtWin::setWindowDisallowPeek(QWidget *window, bool disallow)
Эта функция перегружает QtWin::setWindowDisallowPeek().
Эта функция была добавлена в Qt 5.2.
void QtWin::setWindowExcludedFromPeek(QWindow *window, bool exclude)
Исключает указанное окно window из Aero Peek, если exclude равно true.
Эта функция была добавлена в Qt 5.2.
См. также isWindowExcludedFromPeek().
void QtWin::setWindowExcludedFromPeek(QWidget *window, bool exclude)
Эта функция перегружает QtWin::setWindowExcludedFromPeek().
Эта функция была добавлена в Qt 5.2.
void QtWin::setWindowFlip3DPolicy(QWindow *window, WindowFlip3DPolicy policy)
Устанавливает политику Flip3D policy для указанного окна window.
Эта функция была добавлена в Qt 5.2.
См. также windowFlip3DPolicy().
void QtWin::setWindowFlip3DPolicy(QWidget *window, WindowFlip3DPolicy policy)
Эта функция перегружает QtWin::setWindowFlip3DPolicy().
Эта функция была добавлена в Qt 5.2.
QString QtWin::stringFromHresult(HRESULT hresult)
Возвращает строку сообщения, объясняющую ошибку hresult, или пустую строку, если объяснение не найдено.
Эта функция была добавлена в Qt 5.2.
void QtWin::taskbarActivateTab(QWindow *window)
Активирует элемент на панели задач, не активируя само окно window.
Эта функция была добавлена в Qt 5.2.
void QtWin::taskbarActivateTab(QWidget *window)
Эта функция перегружает QtWin::taskbarActivateTab().
Эта функция была добавлена в Qt 5.2.
void QtWin::taskbarActivateTabAlt(QWindow *window)
Помечает элемент, представляющий указанное окно window на панели задач, как активный, но не активирует его визуально.
Эта функция была добавлена в Qt 5.2.
void QtWin::taskbarActivateTabAlt(QWidget *window)
Эта функция перегружает QtWin::taskbarActivateTabAlt().
Эта функция была добавлена в Qt 5.2.
void QtWin::taskbarAddTab(QWindow *window)
Добавляет элемент для указанного окна window на панель задач.
Эта функция была добавлена в Qt 5.2.
void QtWin::taskbarAddTab(QWidget *window)
Эта функция перегружает QtWin::taskbarAddTab().
Эта функция была добавлена в Qt 5.2.
void QtWin::taskbarDeleteTab(QWindow *window)
Удаляет указанное окно window из панели задач.
Эта функция была добавлена в Qt 5.2.
void QtWin::taskbarDeleteTab(QWidget *window)
Эта функция перегружает QtWin::taskbarDeleteTab().
Эта функция была добавлена в Qt 5.2.
HBITMAP QtWin::toHBITMAP(const QPixmap &p, HBitmapFormat format = HBitmapNoAlpha)
Создаёт эквивалент HBITMAP QPixmap p, на основе заданного формата. Возвращает дескриптор HBITMAP.
Вызывающая сторона отвечает за освобождение HBITMAP данных после использования.
Эта функция была добавлена в Qt 5.2.
См. также fromHBITMAP().
HICON QtWin::toHICON(const QPixmap &p)
Создаёт эквивалент HICON QPixmap p. Возвращает дескриптор HICON.
Ответственность за освобождение данных HICON после использования лежит на вызывающей стороне.
Эта функция была добавлена в Qt 5.2.
См. также fromHICON().
HRGN QtWin::toHRGN(const QRegion ®ion)
Возвращает HRGN, эквивалентный заданной region.
Эта функция была добавлена в Qt 5.2.
WindowFlip3DPolicy QtWin::windowFlip3DPolicy(QWindow *window)
Возвращает текущую политику Flip3D для указанного window.
Эта функция была добавлена в Qt 5.2.
См. также setWindowFlip3DPolicy().
WindowFlip3DPolicy QtWin::windowFlip3DPolicy(QWidget *window)
Данная функция перегружает QtWin::windowFlip3DPolicy().
Эта функция была добавлена в Qt 5.2.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.6/qtwin.html