GetStockObject 函数 (wingdi.h)

GetStockObject 函数检索某个股票笔、画笔、字体或调色板的句柄。

语法

HGDIOBJ GetStockObject(
  [in] int i
);

参数

[in] i

stock 对象的类型。 此参数的取值可为下列值之一:

含义
BLACK_BRUSH
黑色画笔。
DKGRAY_BRUSH
深灰色画笔。
DC_BRUSH
纯色画笔。 默认颜色为白色。 可以使用 SetDCBrushColor 函数更改颜色。 有关详细信息,请参见“备注”部分。
GRAY_BRUSH
灰色画笔。
HOLLOW_BRUSH
空心画笔 (等效于NULL_BRUSH) 。
LTGRAY_BRUSH
浅灰色画笔。
NULL_BRUSH
null 画笔 (等效于HOLLOW_BRUSH) 。
WHITE_BRUSH
白色画笔。
BLACK_PEN
黑色触笔。
DC_PEN
纯色笔颜色。 默认颜色为黑色。 可以使用 SetDCPenColor 函数更改颜色。 有关详细信息,请参见“备注”部分。
NULL_PEN
null 触笔。 null 笔不绘制任何内容。
WHITE_PEN
白色触笔。
ANSI_FIXED_FONT
Windows 固定间距 (单空间) 系统字体。
ANSI_VAR_FONT
Windows 可变间距 (比例空间) 系统字体。
DEVICE_DEFAULT_FONT
设备依赖字体。
DEFAULT_GUI_FONT
用户界面对象(如菜单和对话框)的默认字体。 不建议使用DEFAULT_GUI_FONT或SYSTEM_FONT来获取对话框和窗口使用的字体;有关详细信息,请参阅备注部分。

默认字体为 Tahoma。

OEM_FIXED_FONT
原始设备制造商 (OEM) 依赖固定间距 (单空间) 字体。
SYSTEM_FONT
系统字体。 默认情况下,系统使用系统字体绘制菜单、对话框控件和文本。 不建议使用DEFAULT_GUI_FONT或SYSTEM_FONT来获取对话框和窗口使用的字体;有关详细信息,请参阅备注部分。

默认系统字体为 Tahoma。

SYSTEM_FIXED_FONT
固定间距 (单空间) 系统字体。 此库存对象仅用于与低于 3.0 的 16 位 Windows 版本兼容。
DEFAULT_PALETTE
默认调色板。 此调色板由系统调色板中的静态颜色组成。

返回值

如果函数成功,则返回值是请求的逻辑对象的句柄。

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

备注

不建议使用此方法获取对话框和窗口使用的当前字体。 请改用带 SPI_GETNONCLIENTMETRICS 参数的 SystemParametersInfo 函数来检索当前字体。 SystemParametersInfo 将考虑当前主题,并为标题、菜单和消息对话框提供字体信息。

仅在具有CS_HREDRAW和CS_VREDRAW样式的窗口中使用DKGRAY_BRUSH、GRAY_BRUSH和LTGRAY_BRUSH库存对象。 在移动或调整窗口大小后,使用任何其他样式的灰色股票画笔可能会导致画笔图案不对齐。 无法调整库存画笔的来源。

HOLLOW_BRUSH和NULL_BRUSH股票对象等效。

不需要 (,但调用 DeleteObject 删除库存对象并不有害) 。

DC_BRUSH和DC_PEN都可以与其他库存对象(如BLACK_BRUSH和BLACK_PEN)互换使用。 有关检索当前笔或画笔颜色的信息,请参阅 GetDCBrushColorGetDCPenColor。 有关设置颜色的示例,请参阅 设置笔或画笔颜色 。 具有DC_BRUSH或DC_PEN参数的 GetStockObject 函数可与 SetDCPenColorSetDCBrushColor 函数互换使用。

示例

有关示例,请参阅 设置笔或画笔颜色

要求

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

另请参阅

DeleteObject

设备上下文函数

设备上下文概述

SelectObject