内容

• 类型
• 函数
• 详细描述

QtWin 名称空间

The QtWin namespace contains miscellaneous Windows-specific functions. 更多...

头：	#include <QtWin>
qmake:	QT += winextras

类型

enum	HBitmapFormat { HBitmapNoAlpha, HBitmapPremultipliedAlpha, HBitmapAlpha }
enum	WindowFlip3DPolicy { FlipDefault, FlipExcludeAbove, FlipExcludeBelow }

函数

QColor	colorizationColor (bool * opaqueBlend = nullptr)
HBITMAP	createMask (const QBitmap & bitmap )
void	disableBlurBehindWindow (QWindow * window )
void	disableBlurBehindWindow (QWidget * window )
void	enableBlurBehindWindow (QWindow * window , const QRegion & region )
void	enableBlurBehindWindow (QWindow * window )
void	enableBlurBehindWindow (QWidget * window , const QRegion & region )
void	enableBlurBehindWindow (QWidget * window )
QString	errorStringFromHresult (int 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 , QtWin::HBitmapFormat format = HBitmapNoAlpha)
QPixmap	fromHICON (HICON icon )
QRegion	fromHRGN (HRGN hrgn )
QImage	imageFromHBITMAP (int hdc , HBITMAP bitmap , int width , int height )
QImage	imageFromHBITMAP (HBITMAP bitmap , QtWin::HBitmapFormat format = HBitmapNoAlpha)
HBITMAP	imageToHBITMAP (const QImage & image , QtWin::HBitmapFormat format = HBitmapNoAlpha)
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 , QtWin::WindowFlip3DPolicy policy )
void	setWindowFlip3DPolicy (QWidget * window , QtWin::WindowFlip3DPolicy policy )
QString	stringFromHresult (int 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 , QtWin::HBitmapFormat format = HBitmapNoAlpha)
HICON	toHICON (const QPixmap & p )
HRGN	toHRGN (const QRegion & region )
QtWin::WindowFlip3DPolicy	windowFlip3DPolicy (QWindow * window )
QtWin::WindowFlip3DPolicy	windowFlip3DPolicy (QWidget * window )

详细描述

The QtWin namespace contains miscellaneous Windows-specific functions.

类型文档编制

enum QtWin:: HBitmapFormat

此枚举定义如何转换介于 HBITMAP and QPixmap 的履行。

常量	值	描述
QtWin::HBitmapNoAlpha	0	The alpha channel is ignored and always treated as being set to fully opaque. This is preferred if the HBITMAP is used with standard GDI calls, such as BitBlt() .
QtWin::HBitmapPremultipliedAlpha	1	The HBITMAP is treated as having an alpha channel and premultiplied colors. This is preferred if the HBITMAP is accessed through the AlphaBlend() GDI function.
QtWin::HBitmapAlpha	2	The HBITMAP is treated as having a plain alpha channel. This is the preferred format if the HBITMAP is going to be used as an application icon or a systray icon.

该枚举在 Qt 5.2 引入或被修改。

另请参阅 fromHBITMAP () 和 toHBITMAP ().

enum QtWin:: WindowFlip3DPolicy

此枚举类型指定 Flip3D 窗口策略。

常量	值	描述
QtWin::FlipDefault	0	Let the OS decide whether to include the window in the Flip3D rendering.
QtWin::FlipExcludeAbove	2	Exclude the window from Flip3D and display it above the Flip3D rendering.
QtWin::FlipExcludeBelow	1	Exclude the window from Flip3D and display it below the Flip3D rendering.

该枚举在 Qt 5.2 引入或被修改。

另请参阅 setWindowFlip3DPolicy ().

函数文档编制

QColor QtWin:: colorizationColor ( bool * opaqueBlend = 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 & region )

启用模糊效果为指定 region 的指定 window .

该函数在 Qt 5.2 引入。

另请参阅 disableBlurBehindWindow ().

void QtWin:: enableBlurBehindWindow ( QWindow * window )

启用模糊效果为指定 window .

该函数在 Qt 5.2 引入。

另请参阅 disableBlurBehindWindow ().

void QtWin:: enableBlurBehindWindow ( QWidget * window , const QRegion & region )

此函数重载 QtWin::enableBlurBehindWindow ().

该函数在 Qt 5.2 引入。

void QtWin:: enableBlurBehindWindow ( QWidget * window )

此函数重载 QtWin::enableBlurBehindWindow ().

该函数在 Qt 5.2 引入。

QString QtWin:: errorStringFromHresult ( int hresult )

Returns the code name of the hresult error id specified (usually the name of the WinAPI macro) or an empty string if the message is unknown.

该函数在 Qt 5.2 引入。

void QtWin:: extendFrameIntoClientArea ( QWindow * window , int left , int top , int right , int bottom )

将玻璃框扩展到客户端区域的指定 window 使用 left , top , right ，和 bottom 边距值。

传递 -1 作为任一 4 边距值将完全扩展框架，创建 sheet of glass 效果。

若想要扩展框架扮演像标准窗口边框，应自己处理。

注意： 若 window 是 QWidget handle, set the Qt::WA_NoSystemBackground attribute for your widget.

该函数在 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 , QtWin::HBitmapFormat format = HBitmapNoAlpha)

返回 QPixmap 相当于给定 bitmap . The conversion is based on the specified 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 ( int hdc , HBITMAP bitmap , int width , int height )

返回 QImage 相当于给定 bitmap . The conversion is based on the specified HDC context hdc 使用指定 width and height .

该函数在 Qt 5.2 引入。

另请参阅 toHBITMAP ().

QImage QtWin:: imageFromHBITMAP ( HBITMAP bitmap , QtWin::HBitmapFormat format = HBitmapNoAlpha)

返回 QImage 相当于给定 bitmap . The conversion is based on the specified format .

该函数在 Qt 5.12 引入。

另请参阅 imageToHBITMAP ().

HBITMAP QtWin:: imageToHBITMAP (const QImage & image , QtWin::HBitmapFormat format = HBitmapNoAlpha)

创建 HBITMAP 相当于 QImage image , based on the given format 。返回 HBITMAP 句柄。

调用者负责释放 HBITMAP 数据在使用后。

该函数在 Qt 5.12 引入。

另请参阅 imageFromHBITMAP ().

bool QtWin:: isCompositionEnabled ()

返回 DWM (桌面窗口管理器) 合成状态。

该函数在 Qt 5.2 引入。

bool QtWin:: isCompositionOpaque ()

返回着色颜色是否为不透明融合。

该函数在 Qt 5.2 引入。

bool 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 )

Returns true if Aero Peek is disallowed on the thumbnail of the specified window .

该函数在 Qt 5.2 引入。

bool QtWin:: isWindowPeekDisallowed ( QWidget * window )

此函数重载 QtWin::isWindowPeekDisallowed ().

该函数在 Qt 5.2 引入。

void QtWin:: markFullscreenWindow ( QWindow * window , bool fullscreen = true)

标记指定 window as running in the full-screen mode if fullscreen is true, so that the shell handles it correctly. Otherwise, removes the mark.

注意： You do not usually need to call this function, because the Windows taskbar always tries to determine whether a window is running in the full-screen mode.

该函数在 Qt 5.2 引入。

void QtWin:: markFullscreenWindow ( QWidget * window , bool fullscreen = true)

此函数重载 QtWin::markFullscreenWindow ().

该函数在 Qt 5.2 引入。

QColor QtWin:: realColorizationColor ()

返回由用户设置的真实着色颜色，使用未文档化注册键。基于 API 的函数 getColorizationColor() 返回融合 Alpha 的颜色 (通常变成半透明灰色，而不是类似由用户选取的颜色)。

该函数在 Qt 5.2 引入。

另请参阅 colorizationColor ().

void QtWin:: resetExtendedFrame ( QWindow * window )

重置玻璃框并还原 window 属性。

此方便函数调用 extendFrameIntoClientArea () 采用 0 边距设置。

注意： You must unset the Qt::WA_NoSystemBackground attribute for extendFrameIntoClientArea () 要工作。

该函数在 Qt 5.2 引入。

另请参阅 extendFrameIntoClientArea ().

void QtWin:: resetExtendedFrame ( QWidget * window )

此函数重载 QtWin::resetExtendedFrame ().

该函数在 Qt 5.2 引入。

void QtWin:: setCompositionEnabled ( bool enabled )

设置 Windows 桌面合成是否为 enabled .

注意： 底层函数在 Windows 8 声明弃用，且无效。

该函数在 Qt 5.2 引入。

另请参阅 isCompositionEnabled ().

void QtWin:: setCurrentProcessExplicitAppUserModelID (const QString & id )

设置应用程序用户模型 ID id .

更多信息，见 应用程序用户模型 ID .

该函数在 Qt 5.2 引入。

void QtWin:: setWindowDisallowPeek ( QWindow * window , bool disallow )

Disables Aero Peek for the specified window when hovering over the taskbar thumbnail of the window with the mouse pointer if disallow is true; otherwise allows it.

默认为 false。

该函数在 Qt 5.2 引入。

void QtWin:: setWindowDisallowPeek ( QWidget * window , bool disallow )

此函数重载 QtWin::setWindowDisallowPeek ().

该函数在 Qt 5.2 引入。

void QtWin:: setWindowExcludedFromPeek ( QWindow * window , bool exclude )

排除指定 window from Aero Peek if exclude 为 true。

该函数在 Qt 5.2 引入。

另请参阅 isWindowExcludedFromPeek ().

void QtWin:: setWindowExcludedFromPeek ( QWidget * window , bool exclude )

此函数重载 QtWin::setWindowExcludedFromPeek ().

该函数在 Qt 5.2 引入。

void QtWin:: setWindowFlip3DPolicy ( QWindow * window , QtWin::WindowFlip3DPolicy policy )

Sets the Flip3D policy policy 为指定 window .

该函数在 Qt 5.2 引入。

另请参阅 windowFlip3DPolicy ().

void QtWin:: setWindowFlip3DPolicy ( QWidget * window , QtWin::WindowFlip3DPolicy policy )

此函数重载 QtWin::setWindowFlip3DPolicy ().

该函数在 Qt 5.2 引入。

QString QtWin:: stringFromHresult ( int hresult )

Returns a message string that explains the hresult error id specified or an empty string if the explanation cannot be found.

该函数在 Qt 5.2 引入。

void QtWin:: taskbarActivateTab ( QWindow * window )

Activates an item on the taskbar without activating the window 本身。

该函数在 Qt 5.2 引入。

void QtWin:: taskbarActivateTab ( QWidget * window )

此函数重载 QtWin::taskbarActivateTab ().

该函数在 Qt 5.2 引入。

void QtWin:: taskbarActivateTabAlt ( QWindow * window )

Marks the item that represents the specified window on the taskbar as active, but does not activate it visually.

该函数在 Qt 5.2 引入。

void QtWin:: taskbarActivateTabAlt ( QWidget * window )

此函数重载 QtWin::taskbarActivateTabAlt ().

该函数在 Qt 5.2 引入。

void QtWin:: taskbarAddTab ( QWindow * window )

Adds an item for the specified window to the taskbar.

该函数在 Qt 5.2 引入。

void QtWin:: taskbarAddTab ( QWidget * window )

此函数重载 QtWin::taskbarAddTab ().

该函数在 Qt 5.2 引入。

void QtWin:: taskbarDeleteTab ( QWindow * window )

移除指定 window from the taskbar.

该函数在 Qt 5.2 引入。

void QtWin:: taskbarDeleteTab ( QWidget * window )

此函数重载 QtWin::taskbarDeleteTab ().

该函数在 Qt 5.2 引入。

HBITMAP QtWin:: toHBITMAP (const QPixmap & p , QtWin::HBitmapFormat format = HBitmapNoAlpha)

创建 HBITMAP 相当于 QPixmap p , based on the given format 。返回 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 & region )

Returns a HRGN that is equivalent to the given region .

该函数在 Qt 5.2 引入。

QtWin::WindowFlip3DPolicy QtWin:: windowFlip3DPolicy ( QWindow * window )

Returns the current Flip3D policy for the specified window .

该函数在 Qt 5.2 引入。

另请参阅 setWindowFlip3DPolicy ().

QtWin::WindowFlip3DPolicy QtWin:: windowFlip3DPolicy ( QWidget * window )

此函数重载 QtWin::windowFlip3DPolicy ().

该函数在 Qt 5.2 引入。