LoadBitmapW 函数 (winuser.h)

[LoadBitmap 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 LoadImageDrawFrameControl。]

LoadBitmap 函数从模块的可执行文件加载指定的位图资源。

语法

HBITMAP LoadBitmapW(
  [in] HINSTANCE hInstance,
  [in] LPCWSTR   lpBitmapName
);

参数

[in] hInstance

其可执行文件包含要加载的位图的模块实例的句柄。

[in] lpBitmapName

指向以 null 结尾的字符串的指针,该字符串包含要加载的位图资源的名称。 或者,此参数可以包含低序字中的资源标识符和高序字中的零。 MAKEINTRESOURCE 宏可用于创建此值。

返回值

如果函数成功,则返回值是指定位图的句柄。

如果函数失败,则返回值为 NULL。

注解

如果 lpBitmapName 参数指向的位图不存在或内存不足,无法加载位图,则函数将失败。

LoadBitmap 创建显示器的兼容位图,无法将其选择给打印机。 若要加载可以选择到打印机的位图,请调用 LoadImage 并指定LR_CREATEDIBSECTION以创建 DIB 节。 可以为任何设备选择 DIB 部分。

应用程序可以使用 LoadBitmap 函数访问预定义的位图。 为此,应用程序必须将 hInstance 参数设置为 NULL ,并将 lpBitmapName 参数设置为以下值之一。

位图名称 位图名称
OBM_BTNCORNERS OBM_OLD_RESTORE
OBM_BTSIZE OBM_OLD_RGARROW
OBM_CHECK OBM_OLD_UPARROW
OBM_CHECKBOXES OBM_OLD_ZOOM
OBM_CLOSE OBM_REDUCE
OBM_COMBO OBM_REDUCED
OBM_DNARROW OBM_RESTORE
OBM_DNARROWD OBM_RESTORED
OBM_DNARROWI OBM_RGARROW
OBM_LFARROW OBM_RGARROWD
OBM_LFARROWD OBM_RGARROWI
OBM_LFARROWI OBM_SIZE
OBM_MNARROW OBM_UPARROW
OBM_OLD_CLOSE OBM_UPARROWD
OBM_OLD_DNARROW OBM_UPARROWI
OBM_OLD_LFARROW OBM_ZOOM
OBM_OLD_REDUCE OBM_ZOOMD
 

以 OBM_OLD 开头的位图名称表示 3.0 之前的 16 位版本的 Windows 使用的位图。

若要使应用程序使用任何OBM_常量,必须在包含 Windows.h 头文件之前定义常量 OEMRESOURCE。

应用程序必须调用 DeleteObject 函数来删除 LoadBitmap 函数返回的每个位图句柄。

示例

有关示例,请参阅 使用菜单中的 Menu-Item 位图示例。

注意

winuser.h 标头将 LoadBitmap 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 在 Windows 8.1) 中引入的 ext-ms-win-ntuser-draw-l1-1-1 (

另请参阅

位图函数

位图概述

CreateBitmap

DeleteObject

DrawFrameControl

LoadCursor

LoadIcon

LoadImage

MAKEINTRESOURCE