loadBitmapA 函数 (winuser.h)

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

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

语法

HBITMAP LoadBitmapA(
  [in] HINSTANCE hInstance,
  [in] LPCSTR    lpBitmapName
);

[in] hInstance

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

[in] lpBitmapName

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

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

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

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

LoadBitmap 创建显示器的兼容位图，该位图不能在打印机上选择。若要将可以选择的位图加载到打印机，请调用 LoadImage 并指定LR_CREATEDIBSECTION以创建 DIB 节。可以为任何设备选择 DIB 部分。

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

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

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

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

有关示例，请参阅 Using Menus 中的 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 (