getObjectW 函数 (wingdi.h)

项目
08/27/2023

GetObject 函数检索指定图形对象的信息。

语法

int GetObjectW(
        HANDLE h,
        int    c,
        LPVOID pv
);

参数

h

c

pv

返回值

如果函数成功，并且 lpvObject 是有效的指针，则返回值是存储在缓冲区中的字节数。

如果函数成功，并且 lpvObject 为 NULL，则返回值是保存函数将存储到缓冲区中的信息所需的字节数。

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

注解

lpvObject 参数指向的缓冲区必须足够大，才能接收有关图形对象的信息。根据图形对象，该函数使用 BITMAP、 DIBSECTION、 EXTLOGPEN、 LOGBRUSH、 LOGFONT 或 LOGPEN 结构，或者逻辑调色板) (表条目计数。

如果 hgdiobj 是通过调用 CreateDIBSection 创建的位图的句柄，并且指定的缓冲区足够大， 则 GetObject 函数将返回 DIBSECTION 结构。此外，DIBSECTION 中包含的 BITMAP 结构的 bmBits 成员将包含指向位图位值的指针。

如果 hgdiobj 是通过任何其他方式创建的位图的句柄， 则 GetObject 仅返回位图的宽度、高度和颜色格式信息。可以通过调用 GetDIBits 或 GetBitmapBits 函数来获取位图的位值。

如果 hgdiobj 是逻辑调色板的句柄， 则 GetObject 将检索一个 2 字节整数，该整数指定调色板中的条目数。函数不会检索定义调色板的 LOGPALETTE 结构。若要检索有关调色板条目的信息，应用程序可以调用 GetPaletteEntries 函数。

如果 hgdiobj 是字体的句柄，则返回的 LOGFONT 是用于创建字体的 LOGFONT 。如果 Windows 由于无法表示精确的 LOGFONT 而不得不对字体进行一些内插，则内插不会反映在 LOGFONT 中。例如，如果你要求提供不支持垂直绘制的字体的垂直版本， 则 LOGFONT 指示该字体是垂直的，但 Windows 将水平绘制该字体。

示例

有关示例，请参阅存储映像。

注意

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

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll