getStockObject 函数 (wingdi.h)

  • 项目

GetStockObject 函数检索其中一支股票笔、画笔、字体或调色板的句柄。

语法

HGDIOBJ GetStockObject(
  [in] int i
);

参数

[in] i

常用对象的类型。 此参数的取值可为下列值之一：

值 含义
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）互换使用。 有关检索当前笔或画笔颜色的信息，请参阅 GetDCBrushColor 和 GetDCPenColor。 有关设置颜色的示例，请参阅 设置笔或画笔 颜色。 参数为 DC_BRUSH 或 DC_PEN 的 GetStockObject 函数可与 SetDCPenColor 和 SetDCBrushColor 函数互换使用。

示例

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

要求

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

另请参阅

DeleteObject

设备上下文函数

设备上下文概述

SelectObject